Modèle <marker>

Rôle

Ce modèle est l'équivalent de la balise #GEOMARKER : il permet d'ajouter des points sur une carte créée par le modèle <map> ou la balise #GEOMAP.

Paramètres

Le modèle accepte les mêmes paramètres que la balise :

NomDescriptionValeurDéfaut
carte Identifiant unique de la carte. Identifiant numérique correspondant au paramètre map d'une balise GEOMAP, ou au paramètre carte d'un modèle <map>, insérée dans le même document. absent, donc la dernière carte ajoutée est utilisée
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 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, 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
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
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
type Type du marqueur recherché sur un élément. Parmi les types définis dans le paramétrage du plugin. defaut
latitude Latitude du point -38.5911137761474 absent
longitude Longitude du point 143.036499023438 absent
adresse Adresse du point, au format connu par le geocoder. Montréal, Québec absent
titre Titre du point, affiché sur le survol du marqueur. texte absent
texte Texte du point, affiché dans l'info-bulle. texte / html absent
icon Nom de l'icone utilisée pour le marqueur. Nom d'un fichier XML du type gmd. Le plugin défini par exemple un fichier gmap-marker-default.gmd, pour le désigner, le paramètre icon doit contenir gmap-marker-default. Ces fichiers sont recherchés dans le path de SPIP, ils peuvent donc être positionnés dans le dossier squelettes. absent

 

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 ajoute une carte positionnée selon les paramètre et ajoute un point positionné par des paramètres et un point positionné selon la géolocalisation de la rubrique 1 :

<map|latitude=10|longitude=45|zoom=3>
<marker|latitude=10|longitude=45|titre=un marqueur|texte=turlututu chapeau pointu>
<marker|id_rubrique=1>

 

On peut donner un numéro à la carte par le paramètre carte, ceci permet de placer les marqueurs avant ou après la carte elle-même :

<marker|carte=10|id_article=1>
<map|carte=10>
<marker|carte=10|latitude=10|longitude=45|titre=un marqueur|texte=turlututu chapeau pointu>