Navigation
Domaines
Communes
Quartiers de Brest
Ressources
Communauté
Vie du projet
Autour de Wiki-Brest
Boîte à outils
Espaces de noms

Variantes
Actions
De Wiki-Brest

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 permet:

  • d'afficher une carte simple
  • d'afficher un ou plusieurs points sur une carte
  • de créer des info bulles lorsque des points sont marqués sur la 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.

Il est également possible de construire sa carte interactive, à partir du service Umap. 
Un simple copier-coller du code exportable suffit ensuite pour faire apparaître la carte dans l'article wiki.

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.
Le positionnement du centre de votre carte peut se faire soit en utilisant:

  • un des geoservices 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 centre de la carte.
    exemple: 48.390078, -4.485603
Wiki code 
{{Maps
 | title=Brest, Bretagne - France
 | width=520
 | height=300
 | float=right
 | location=48.390078, -4.485603
}}
Wiki code 
{{Maps
 | title=Brest, Bretagne - France
 | width=520
 | height=300
 | float=right
 | geoservice=google
 | location=2 rue Frézier Brest
}}

Affichage d'une carte avec plusieurs points

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


Wiki code 
{{Maps
 | title=Brest, Bretagne - France
 | width=520
 | height=400
 | float=right
 | marker=true
 | 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
 | marker=true
 | geoservice=google
 | location=
 26 rue Choquet de Lindu Brest;
 44, rue Bugeaud Brest;
 20 rue Gaston Ramon Brest
}}

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
desc Non Permet d'afficher un texte descriptif sous la carte

L'affichage 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. De plus si vous souhaitez ajouter l'article aux articles du wiki géolocalisés, vous devez utiliser le format latitude, longitude.

Si le mode marqueur est activé il devient possible de créer des info bulles pour chacun des points marqués sur la carte, la syntaxe permettant de créer ces info bulles est traitée dans les exemples qui suivent.
A noter que si les info bulles sont utilisées, l'ajout de l'article à la liste des articles géolocalisés du site n'est plus utilisable et ce même si le format utilisé pour placer le points est de la forme latitude, longitude

zoom Non Définit le niveau de profondeur du zoom, la valeur peut être comprise entre 1 et 18, la valeur par défaut étant placée à 10

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 et quelle ne contienne qu'un seul et unique point.
marker Non Ce paramètre indique au modèle qu'il doit également afficher un marqueur pour chacun des points renseignés dans le paramètre location. Avec ce mode d'utilisation, l'ajout de l'article à la liste des articles géolocalisés du wiki n'est disponible que lorsque le paramètre location ne contient qu'un seul et unique point et que le format de ce point est 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:
  • geonames (sous licence Creative Commons).
  • yahoo
  • google (défaut parait plus efficace que geonames?)
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.

Carte avec plusieurs point et infos bulles

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


Wiki code: Syntax spécifique aux infos bulles
Voici le détail de la syntaxe pour l'affichage des info bulles
Pour chaque point renseigné dans le paramètre location, la syntaxe est la suivante: 
coordonnées ~ Titre ~ Texte descriptif ~ Icône du point;
  • coordonnées: le format est au choix l'un des 2 habituels
  • Icône: l'icône qui sera affichée sur la carte

Ce qui donne par exemple: 

48.734897, 2.418277~Accueil~Contenu de la bulle~File:Red pin.png;

A noter:

  • les icônes doivent au préalable avoir été importées sur le serveur
  • les textes et descriptions acceptent la syntaxe wiki habituelle à l'exception des titres (==)
Outils personnels