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 dans vos articles.
Ce modèle offre également la possibilité de géolocaliser l'article dans lequel il est affiché en renseignant les paramètres de latitudes et de longitudes.
Voyons comment tous cela fonctionne.
Usage
Les exemples suivants n'utilisent que les paramètres nécessaires au bon fonctionnement du modèle.
Le modèle peux s'appeler de 2 manières:
- Cette première forme d'utilisation fait appelle à un service qui offre la possibilité de transformer un nom de ville en coordonnées géographiques, il n'est donc pas nécessaires de renseigner les paramètres de géolocalisation habituel que sont la latitude et la longitude:
{{Maps | location = Brest }}
|
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"openlayers","width":"800px","height":"600px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":10,"controls":["layerswitcher","mouseposition","autopanzoom","scaleline","navigation"],"layers":["new OpenLayers.Layer.OSM.Mapnik(\"OSM Mapnik\")","new OpenLayers.Layer.OSM.CycleMap(\"OSM Cycle Map\")"],"resizable":false,"overlays":[],"searchmarkers":"","kml":[],"locations":[],"imageoverlays":null}
|
|
Cette première méthode ne permet pas d'ajouter l'article à la liste des articles géolocalisés du wiki, en effet pour cela, il sera nécessaire de renseigner les paramètres latitudes et longitudes.
- Cette seconde forme d'utilisation utilise directement les coordonnées de géolocalisation du lieu:
{{Maps | location = | lat = 48.39227 | long = -4.47784 | service = osm}}
|
Latitude : 48.39227, Longitude : -4.47784
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"leaflet","width":"800px","height":"600px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":10,"defzoom":14,"layers":["OpenStreetMap"],"overlaylayers":[],"resizable":false,"enablefullscreen":false,"scrollwheelzoom":true,"markercluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"locations":[],"imageoverlays":null}
|
|
Cette seconde méthode ajoute l'article à la liste des articles géolocalisés, les paramètres de latitude et de longitude ayant été renseignés.
- Voici un dernier exemple d'appel du modèle qui utilise un certain nombre de paramètres complémentaires:
{{Maps
| title = Carte de Brest
| width = 800
| height = 400
| location =
| lat = 48.39227
| long = -4.47784
| zoom = 12
| layer = osm-mapnik,osm,google,bing,yahoo
| desc = Une description du contenu de la carte.
}}
Carte de Brest
|
Latitude : 48.39227, Longitude : -4.47784
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"openlayers","width":"800px","height":"400px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":12,"controls":["layerswitcher","mouseposition","autopanzoom","scaleline","navigation"],"layers":["new OpenLayers.Layer.OSM.Mapnik(\"OSM Mapnik\")","new OpenLayers.Layer.OSM.CycleMap(\"OSM Cycle Map\")","new OpenLayers.Layer.Google( \"Google Streets\", {\"sphericalMercator\":true} )","new OpenLayers.Layer.Google( \"Google Satellite\", {type: G_SATELLITE_MAP , \"sphericalMercator\":true} )","new OpenLayers.Layer.Google( \"Google Hybrid\", {type: G_HYBRID_MAP , \"sphericalMercator\":true} )","new OpenLayers.Layer.Google( \"Google Physical\", {type: G_PHYSICAL_MAP , \"sphericalMercator\":true} )","new OpenLayers.Layer.VirtualEarth( \"Bing Streets\", {type: VEMapStyle.Shaded, \"sphericalMercator\":true} )","new OpenLayers.Layer.VirtualEarth( \"Bing Satellite\", {type: VEMapStyle.Aerial, \"sphericalMercator\":true} )","new OpenLayers.Layer.VirtualEarth( \"Bing Hybrid\", {type: VEMapStyle.Hybrid, \"sphericalMercator\":true} )","new OpenLayers.Layer.Yahoo( \"Yahoo! Streets\", {\"sphericalMercator\":true} )","new OpenLayers.Layer.Yahoo( \"Yahoo! Satellite\", {\"type\": YAHOO_MAP_SAT, \"sphericalMercator\":true} )","new OpenLayers.Layer.Yahoo( \"Yahoo! Hybrid\", {\"type\": YAHOO_MAP_HYB, \"sphericalMercator\":true} )"],"resizable":false,"overlays":[],"searchmarkers":"","kml":[],"locations":[],"imageoverlays":null}
|
Carte utilisant le service OpenLayers pour afficher un fond de carte Mapnik par défaut et permettre l'accès aux fonds de cartes Osm et Google.
|
- Si vous souhaitez simplement ajouter votre article à la liste des articles géolocalisés, utilisatez 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
|
float
|
Non
|
Controle 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:
|
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
|
desc
|
Non
|
Permet d'afficher un texte descriptif sous la carte
|
Positionnement de la carte
Nom du paramètre
|
Nécessaire
|
Description
|
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. Dans ce cas, le paramètre location doit malgré tout être présent mais on ne lui donne aucune valeur.
|
lat
|
Non
|
La latitude du lieu exprimé en degré décimal, ce paramètre associé à la longitude permet:
- de centrer la carte sur le point ainsi défini si la localisation par un nom de lieu ne fonctionne pas
- d'ajouter l'article à la liste des articles géolocalisés sur le wiki
|
long
|
Oui
|
La longitude du lieu exprimé en degré décimal, ce paramètre associé à la latitude permet:
- de centrer la carte sur le point ainsi défini si la localisation par un nom de lieu ne fonctionne pas
- d'ajouter l'article à la liste des articles géolocalisés sur le wiki
|
Services et calques
Nom du paramètre
|
Nécessaire
|
Description
|
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. Pour chaque type de calque (osm, bing, etc...) plusieurs calques sont disponibles, il est possible de les appeler par leur nom, voici les valeurs possibles:
- osm, calques disponibles: osmarender; osm-mapnik; osm-cyclemap
- bing, calques disponibles: bing-normal; bing-satellite; bing-hybrid
- yahoo, calques disponibles: yahoo-normal; yahoo-satellite; yahoo-hybrid
- google, calques disponibles: google-normal; google-satellite; google-hybrid; google-physical
|
Les 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 = )
'PanZoomBar + OverviewMap + MousePosition'
|
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"openlayers","width":"500px","height":"370px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":10,"controls":["panzoombar","overviewmap","mouseposition"],"layers":["new OpenLayers.Layer.OSM.Mapnik(\"OSM Mapnik\")","new OpenLayers.Layer.OSM.CycleMap(\"OSM Cycle Map\")"],"resizable":false,"overlays":[],"searchmarkers":"","kml":[],"locations":[],"imageoverlays":null}
|
|
|
'LayerSwitcher + Permalink + MouseToolbar'
|
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"openlayers","width":"500px","height":"370px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":10,"controls":["layerswitcher","permalink","mousetoolbar"],"layers":["new OpenLayers.Layer.OSM.Mapnik(\"OSM Mapnik\")","new OpenLayers.Layer.OSM.CycleMap(\"OSM Cycle Map\")"],"resizable":false,"overlays":[],"searchmarkers":"","kml":[],"locations":[],"imageoverlays":null}
|
|
|
'ScaleLine + Navigation'
|
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"openlayers","width":"500px","height":"370px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":10,"controls":["scaleline","navigation"],"layers":["new OpenLayers.Layer.OSM.Mapnik(\"OSM Mapnik\")","new OpenLayers.Layer.OSM.CycleMap(\"OSM Cycle Map\")"],"resizable":false,"overlays":[],"searchmarkers":"","kml":[],"locations":[],"imageoverlays":null}
|
|
|
'Tous les contrôles désactivés'
|
|
Chargement de la carte... {"minzoom":false,"maxzoom":false,"mappingservice":"openlayers","width":"500px","height":"370px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"wmsoverlay":false,"copycoords":false,"static":false,"zoom":10,"controls":["layerswitcher","mouseposition","autopanzoom","scaleline","navigation"],"layers":["new OpenLayers.Layer.OSM.Mapnik(\"OSM Mapnik\")","new OpenLayers.Layer.OSM.CycleMap(\"OSM Cycle Map\")"],"resizable":false,"overlays":[],"searchmarkers":"","kml":[],"locations":[],"imageoverlays":null}
|
|
|