Modèle:Maps
Sommaire
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 permet soi:
- d'afficher une carte simple
- d'afficher un ou plusieurs points sur une carte
- sous certaines conditions, d'ajouter l'article à la liste des articles géolocalisés du wiki
Plusieurs exemples fonctionnels vous seront présentés dans cette page, vous pouvez copier/coller les wiki-code correspondant et les adapter à vos besoins.
Usage
Affichage d'une simple carte
Brest, Bretagne - France |
Chargement de la carte...
|
Cette utilisation est préconisée dès que vous souhaitez afficher une simple carte dans l'un de vos articles.
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=300 | float=right | location=2 rue Frézier Brest }} |
Wiki code
{{Maps | title=Brest, Bretagne - France | width=520 | height=300 | float=right | location=48.390078, -4.485603 }} |
Affichage d'une carte avec marqueur(s)
Finistère, Bretagne - France |
Chargement de la carte...
|
L'utilisation de ce modèle est préconisée dès que vous souhaitez placer sur une carte un ou plusieurs points d'intérêts. La géolocalisation des POI (points d'intérêts) 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 - 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= 48.390119, -4.474199; 48.39691, -4.48041; 48.381811, -4.487011 }} |
Wiki code
{{Maps | title=Brest, Bretagne - France | width=520 | height=400 | float=right | geoservice=google | location= 26 rue Choquet de Lindu Brest; 44, rue Bugeaud Brest; 20 rue Gaston Ramon Brest }} |
Géolocalisation de l'article
L'ajout de l'article à la liste des articles géolocalisés ne peux se faire que dans certaines conditions particulières:
- le modèle est utilisé pour afficher une simple carte et la valeur du paramètre location est indiquée au format latitude, longitude
- le modèle est utilisé pour marquer un seul et unique point sur la carte et la valeur du paramètre location est indiquée au format latitude, longitude
Dans l'un ou l'autre de ces cas, pour activer la géolocalisation de l'article il vous faudra activer le paramètre geoloc et mettre sa valeur à true.
Wiki code
{{Maps | title=Brest, Bretagne - France | width=520 | height=300 | float=right | marker=false | geoloc=true | location=48.381811, -4.487011 }} |
Wiki code
{{Maps | title=Brest, Bretagne - France | width=520 | height=300 | float=right | marker=true | geoloc=true | location=48.381811, -4.487011 }} | ||||||||
|
|
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:
|
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 |
geoloc | Non | Ce paramètre permet d'ajouter l'article à la liste des articles géolocalisés du wiki, sa valeur doit être positionnée à true, de plus il est indispensable que la valeur du paramètre location soi renseignée au format latitude, longitude. |
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:
|
service | Non | Nous proposons 2 services différents pour afficher les cartes dans vos articles:
|
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:
{{Maps | title='''Les calques OSM''' | location = Brest France | width=500 | height=300 | service = openlayers | layer = osm | controls= LayerSwitcher, Navigation }} |
{{Maps | title= '''Les calques BING''' | location = Brest France| width=500 | height=300 | geoservice=yahoo | service=openlayers | layer = bing | controls= LayerSwitcher, Navigation }} | ||||||||
{{Maps | title='''Les calques YAHOO''' | location = Brest France| width=500 | height=300 | geoservice=google | service=openlayers | layer = yahoo | controls= LayerSwitcher, Navigation }} |
{{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:
|
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:
{{Maps | title='''PanZoomBar''' + '''OverviewMap''' + '''MousePosition''' | location = Brest Belarus | width= 500 | height=350 | service = openlayers | layer = osm-mapnik | controls = PanZoomBar, OverviewMap, MousePosition | desc = Votre texte. }} |
{{Maps | title= '''LayerSwitcher''' + '''Permalink''' + '''MouseToolbar''' | location = Brest Belarus | width= 500 | height=350 | service=openlayers | layer = osm | controls= LayerSwitcher, Permalink, MouseToolbar | desc = Votre texte. }} | ||||||||
{{Maps | title='''ScaleLine''' + '''Navigation''' | location = Brest Belarus | width= 500 | height=350 | service=openlayers | layer = osm-cyclemap | controls= ScaleLine, Navigation | desc = Votre texte. }} |
{{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. }} |