Rôle

Cette balise permet d’ajouter manuellement des points sur la carte. Les coordonnées peuvent être fournies explicitement, elle peuvent provenir d’un élément géolocalisé dans SPIP, ou encore elle peuvent provenir d'une requête.

Par exemple :

#GEOMARKER{id_article}
#GEOMARKER{id_article=23}
#GEOMARKER{id_document=119, type=visee}
#GEOMARKER{latitude=38, longitude=-6, titre=un marqueur manuel, icon=gmap-marker-article, texte=toto}
#GEOMARKER{adresse='Montréal; Québec', titre=Montréal au Québec}
#GEOMARKER{id_article=23, markers=documents}

• La première forme ajoute un point correspondant à l’article qui se trouve dans le contexte.
• La deuxième ajoute le point correspondant à un article identifié.
• La troisième ajoute le point de types visee associée au document 119.
• La quatrième ajoute un point dont la position est définie manuellement.
• La cinquième ajoute un point dont la position est définie par une adresse.
• La sixième ajoute les points issus d'une requête sur les documents de l'article 23.

Si plusieurs balises GEOMAP sont présentes, on peut utiliser le paramètre map=X pour donner un numéro à la carte et lever les ambiguïtés. Sans ce paramètre, le marqueur sera ajouté sur la dernière carte créée au moment où la balise GEOMARKER est interprétée.

La balise GEOMARKER utilise les mêmes paramètres que la balise GEOMAP pour désigner les points à ajouter. Par contre les paramètres désignant un objet ou des coordonnées ne sont pas utilisés pour centrer la carte. L'identifiant d'un objet est utilisé comme point de départ de la recherche des points, alors que les coordonnées ne sont utilisées que pour ajouter un point manuellement.

Il n'est pas possible de combiner plusieurs types d'ajout. Par exemple, la syntaxe suivante n'est pas correcte :

#GEOMARKER{id_article=23, markers=documents, latitude=38, longitude=-6, titre=un marqueur manuel, icon=gmap-marker-article, texte=toto}

Dans ce cas, les paramètres de coordonnées seront simplement ignorés.

Comme pour la balise GEOMAP, tous les paramètres transmis à la balise #GEOMARKER sont renvoyés au squelette qui effectue la requête (quand markers=query).

Paramètres

Les paramètres sont en grande partie les mêmes que les paramètres communs à toutes les implémentations de la balise GEOMAP, veuillez vous référer à la documentation de cette dernière.

Les paramètres spécifiques à une implémentation, ainsi que le paramètre viewport n'ont aucun sens dans le cadre de l'ajout de points, il ne sont donc pas utilisés.

N'apparaissent ci-dessous que les paramètres spécifiques ou dont le sens est différent.

Note 1 : L'adresse est exprimée d'une façon compréhensible par le geocoder de l'implémentation utilisée, mais il ne peut comporter de virgules, car SPIP les interprète comme le passage au paramètre suivant. Pour séparer les différents champs, vous pouvez utiliser des points virgules.

Note 2 : 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.