Rôle
Ce modèle est l'équivalent de la balise #GEOMAP : il permet d'insérer des cartes dans les textes de SPIP. Le modèle se contente d'ailleurs d'appeler la balise en lui repassant les paramètres qu'il reçoit.
Paramètres
Le modèle accepte les mêmes paramètres que la balise, à l'exclusion des paramètres spécifiques à l'implémentation. Pour l'apparence des cartes, il faut donc se reposer sur le paramétrage global du site.
Les paramètres sont :
Nom | Description | Valeur | Défaut |
---|---|---|---|
carte | Identifiant unique de la carte, si plusieurs cartes peuvent apparaître dans la même page finale. | Identifiant numérique. | absent, la carte est nommée automatiquement |
largeur | Largeur de la carte en pixels ou en pourcentage. | Largeur selon le format CSS : XXXpx ou XXX%. | 100% |
hauteur | Largeur de la carte en pixels. | Largeur selon le format CSS : XXXpx. | 400px |
id_secteur, id_rubrique, id_parent, id_article, id_document, id_breve, id_auteur, id_mot, id_groupe, id_forum, id_syndic | La première occurence d'un identifiant est utilisée comme objet de référence pour le centrage de la carte et la recherche des points. Les suivantes peuvent être transmises au fichier de requête. | |id_article ou |id_article=39 ou encore |objet=article|id_objet=39 | absent, la carte est centrée sur le paramétrage par défaut, aucun objet n'est fourni aux éventuelles requêtes |
markers | Définition des marqueurs |
|
absent, carte vide |
query | Nom du fichier de requête (si markers=query). GMap contient des requêtes prédéfinies pour les objets qu'il traite (rubrique, article, document, brève, auteur et mot-clef) et pour les formulaires de recherche. Quand ce paramètre est absent, GMap utilise une requête sur les enfants de l'objet de référence. | Chemin relatif du fichier par rapport au path de SPIP (par exemple dossier des squelettes, racine des plugins), sans l'extension .html. | absent |
format | Format du fichier de requête :
|
kml | json | kml |
viewport | Surcharge du positionnement de la carte par raport à un objet. Ce paramètre peut prendre la valeur site ou désigner un objet sous la forme <nom-de-l-objet><identifiant-de-l-objet>. | site | <objet><id_objet> | absent : la carte est positionnée selon l'objet de référence |
focus | Quand ce paramètre est présent (la valeur n'est pas utilisée), il indique que la carte doit s'autocentrer après avoir ajouter les points. | n.a. | non |
latitude | Latitude du centre de la carte | -38.5911137761474 | absent : position par défaut du site |
longitude | Longitude du centre de la carte | 143.036499023438 | absent : position par défaut du site |
zoom | Zoom initial de la carte | 0 à 19 | absent : zoom par défaut du site |
type | Fond de carte | Parmi plan, satellite, mixte, physic, earth | absent, donc le paramétrage par défaut est utilisé |
Tous les identifiants doivent être accompagnés d’une valeur numérique car le modèle n’accède pas au contexte.
Exemples
Le code suivant affiche une carte positionnée selon les paramètres de l’article 1 et ajoute le point correspondant :
<map|id_article=1|markers=local>
Le code suivant affiche une carte positionnée selon les paramètres de l’auteur 1 et ajoute le point correspondant :
<map|id_auteur=1|markers=local>
Le code suivant affiche une carte positionnée selon les paramètres de la rubrique 1 et ajoute les points correspondants à tous ses articles et documents géolocalisés :
<map|id_rubrique=1|markers=query>