Domaines
Communes
Quartiers de Brest
Espaces de noms

Variantes
Actions
De Wiki-Brest
Révision datée du 27 janvier 2011 à 16:44 par Fleon (discussion | contributions) (Mise en forme globale)

Modèle:Maps


Introduction

Ce modèle se base sur l'extension Maps qui permet d'afficher des cartes géographiques dynamiques dans vos articles en faisant appelle aux API tels que OpenLayers ou Google Maps. Avec ce modèle, il devient donc possible d'afficher des cartes OpenStreetMap (mais pas que...) dans vos articles.
Ce modèle offre également la possibilité de géolocaliser l'article dans lequel il est utilisé en renseignant les paramètres de latitudes et de longitudes.
Plusieurs exemples fonctionnels vous seront présentés dans cette page, vous pouvez copier/coller les wiki-code correspondant et les adapter à vos besoins.
En revanche il n'est pas possible d'utiliser ce modèle pour marquer un ou plusieurs points sur vos cartes, pour cela nous proposons le modèle Points dont le fonctionnement est très similaire à celui-ci et qui permet de positionner un ou plusieurs points sur la carte.

Usage

Brest, Bretagne - France
Chargement de la carte...


L'utilisation de ce modèle est donc préconisée dès que vous souhaitez afficher une simple carte dans l'un de vos articles. En revanche, si vous souhaitez marquer un ou plusieurs points sur votre carte, je vous encourage à utiliser le modèle Points. En résumé:

  • Maps permet d'afficher une simple carte
  • Points permet de marquer un ou plusieurs points sur une carte

La géolocalisation du centre de votre carte peut se faire soit en utilisant:

  • un des geoservice fournis par le modèle, dans ce cas le point sera identifié par une adresse et/ou un nom de ville associé à un pays.
    exemple: 2 rue Frézier Brest France
  • des coordonnées géographiques définissant la latitude et la longitude du point à marquer.
    exemple: 48.390078, -4.485603
Wiki code
{{Maps
 | title=Brest, Bretagne - France
 | width=520
 | height=400
 | float=right
 | geoservice=google
 | location=2 rue Frézier Brest
}}
Wiki code
{{Maps
 | title=Brest, Bretagne - France
 | width=520
 | height=400
 | float=right
 | geoservice=google
 | location=48.390078, -4.485603
}}
  • Si vous souhaitez simplement ajouter votre article à la liste des articles géolocalisés, utilisez d'un des 2 modèles suivants en fonction du format de vos coordonnées géographiques:
    GeoDMS coordonnées géographiques sont au format degré minutes secondes
    GeoDEG coordonnées géographiques sont au format degré décimaux

Paramètres

Le modèle permet d'enrichir les options de l'extension de base en autorisant par exemple le renseignement d'options d'affichage de la carte. Les 2 sections suivantes récapitulent respectivement les paramètres de mise en forme et ceux spécifiques à la carte qui peuvent être exploités par le modèle.

Mise en forme globale

Nom du paramètre Nécessaire Description
title Non Ajoute un titre à la carte
width Non Contrôle la largeur du bloc contenant la carte
Si ce paramètre n'est pas utilisé la largeur de la carte sera de 800 pixels
height Non Contrôle la hauteur du bloc contenant la carte
Si ce paramètre n'est pas utilisé la hauteur de la carte sera de 600 pixels
float Non Contrôle le placement de la carte dans l'article (défaut centré), pour un affichage à droite ou à gauche du texte, le paramètre peut prendre les valeurs:
  • right
  • left
location Oui Le lieu sur lequel est centré la carte, un service permet à partir d'un nom de lieu ou d'une adresse de récupérer les coordonnées géographiques de l'emplacement. Si ce service ne réussi pas à traduire le nom en coordonnées, il est alors possible d'utiliser les paramètres latitude et longitude. De plus si vous souhaitez ajouter l'article aux articles du wiki géolocalisés, vous devez utiliser le format latitude, longitude.
desc Non Permet d'afficher un texte descriptif sous la carte

Services et calques

Nom du paramètre Nécessaire Description
geoservice Non C'est le service qui est responsable de transformer un nom de ville, une adresse en coordonnées géographiques. Voici les différents valeur possibles:
  • geonames (défaut sous licence Creative Commons).
  • yahoo
  • google
service Non Nous proposons 2 services différents pour afficher les cartes dans vos articles:
  • openlayers qui permet d'afficher de nombreux calques différents (utilisé par défaut).
  • osm qui n'affiche que les calques openstreetmap mais permet d'ajouter des entrées vers wikipédia
layer Non Le type de calque utilisé pour l'affichage du fond de carte, il n'est utilisable qu'avec le service openlayers actif.
Voici les différents types de calques utilisables: osm, bing, yahoo, google.
Pour chacun de ces types plusieurs calques sont disponibles, il est possible de les appeler par leur nom, les exemples ci-dessous donnent les noms utilisables pour chaque type de calque.

Voici quelques exemples d'utilisation avec les codes correspondants:

'Les calques osm'
Chargement de la carte...
Calques: osmarender; osm-mapnik; osm-cyclemap



Le wiki code correspondant:
{{Maps | title='''PanZoomBar''' + '''OverviewMap''' + '''MousePosition'''
 | location = Brest France | width= 500 | height=300
 | service = openlayers | layer = osm
 | controls= LayerSwitcher, Navigation
}}
'Les calques bing'
Chargement de la carte...
Calques: bing-normal; bing-satellite; bing-hybrid



Le wiki code correspondant:
{{Maps | title= '''Les calques BING'''
 | location = Brest France| width= 500 | height=300
 | geoservice=yahoo | service=openlayers | layer = bing
 | controls= LayerSwitcher, Navigation
}}
'Les calques yahoo'
Chargement de la carte...
Calques: yahoo-normal; yahoo-satellite; yahoo-hybrid



Le wiki code correspondant:
{{Maps | title='''Les calques YAHOO'''
 | location = Brest France| width= 500 | height=300
 | geoservice=google | service=openlayers | layer = yahoo
 | controls= LayerSwitcher, Navigation
}}
'Les calques google'
Chargement de la carte...
Calques: google-normal; google-satellite; google-hybrid; google-physical



Le wiki code correspondant:
{{Maps | title='''Les calques GOOGLE'''
 | location = Brest France| width= 500 | height=300
 | geoservice=geonames | service=openlayers | layer = google
 | controls= LayerSwitcher, Navigation
}}

Le contrôle de l'interactivité avec la carte

Il s'agit également d'un paramètre personnalisable du modèle qui n'est accessible que lorsque le service openlayers est explicitement déclaré.

Nom du paramètre Nécessaire Description
controls Non ce paramètre permet d'ajuster les possibilités d'interaction avec la carte, il n'est utilisable qu'avec le service openlayers actif.
Les différents types de contrôle disponibles sont les suivants:
  • PanZoomBar, affiche la barre de zoom et le pad de déplacement
  • MouseToolbar, affiche les outils utilisables avec la souris
  • LayerSwitcher, permet d'accéder à la liste des calques
  • Permalink, ajoute un lien générant une url avec les coordonnées
  • MousePosition, permet de visualiser les coordonnées en déplaçant la souris sur la carte
  • OverviewMap, affiche un encart permettant de déplacer la zone d'activité de la carte
  • ScaleLine, affiche l'échelle sur la carte
  • Navigation, permet la navigation sur la carte avec la souris

Si ce paramètre n'est pas renseigné, les contrôles par défaut seront les suivants:

  • LayerSwitcher, MousePosition, PanZoomBar, ScaleLine, Navigation

Pour désactiver entièrement les contrôles, laissez le paramètre vide (controls = )
Voici quelques exemples d'utilisation avec les codes correspondants:

'PanZoomBar + OverviewMap + MousePosition'
Chargement de la carte...
Le contrôle de la carte par la souris est désactivé, zoom et déplacement se font avec la "PanZoomBar". Il est possible d'utiliser l'encart "OverviewMap" pour se déplacer sur la carte Les coordonnées géographiques de la position du pointeur sur la carte sont affichés. Un seul calque est accessible (osm-mapnik)



Le wiki code correspondant:
{{Maps | title='''PanZoomBar''' + '''OverviewMap''' + '''MousePosition'''
  | location = Brest Belarus | width= 500 | height=350
  | service = openlayers | layer = osm-mapnik
  | controls = PanZoomBar, OverviewMap, MousePosition
  | desc = Votre texte.
}}
'LayerSwitcher + Permalink + MouseToolbar'
Chargement de la carte...
Il est possible de sélectionner les différents calques "osm". Le contrôle de la carte par la souris est activé, la "MouseToolBar" permet de sélectionner des régions de la carte pour le zoom. Un lien permettant de générer un lien permanent est disponible.



Le wiki code correspondant:
{{Maps | title= '''LayerSwitcher''' + '''Permalink''' + '''MouseToolbar'''
 | location = Brest Belarus | width= 500 | height=350
 | service=openlayers | layer = osm
 | controls= LayerSwitcher, Permalink, MouseToolbar
 | desc = Votre texte.
}}
'ScaleLine + Navigation'
Chargement de la carte...
Un seul calque est disponible (osm-cyclemap). Le contrôle de la carte se fait exclusivement par la souris, l'échelle est affichée.



Le wiki code correspondant:
{{Maps | title='''ScaleLine''' + '''Navigation'''
 | location = Brest Belarus | width= 500 | height=350
 | service=openlayers | layer = osm-cyclemap
 | controls= ScaleLine, Navigation
 | desc = Votre texte.
}}
'Tous les contrôles désactivés'
Chargement de la carte...
Un seul calque est disponible (google-hybrid). Tous les contrôles sont désactivés, la carte est statique.



Le wiki code correspondant:
{{Maps | title='''Tous les contrôles désactivés'''
 | location = Brest Belarus | width= 500 | height=350
 | service=openlayers | layer = google-hybrid
 | controls= 
 | desc = Votre texte.
}}
Outils personnels