Modèle <map>

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 :

NomDescriptionValeurDé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
  • local : seul(s) le(s) marqueur(s) de l'objet sont affichés
  • childs : les marqueurs de l'objet et de ses descendants de niveau 1 sont affichés
  • recursive : les marqueurs de l'objet et de tous ses descendants sont affichés
  • query : la liste des marqueurs provient d'une requête ajax
  • Autre valeur : nom d'une requête spéciale, équivalent à markers=query, query=xxx
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 (par défaut) : fichiers kml (OGC). Ces fichiers sont explicites et très standardisés. Ils peuvent être téléchargés et ouverts dans la plupart des outils de cartographie.
  • json : fichiers légèrement plus légers et plus rapide à décoder, mais moins standards.
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>