Surcharger l'URL de visualisation d'une carte

Surcharger l'URL de visualisation d'une carte

Les paramètres suivants, additionnés à l'URL de visualisation de la carte, permettent de modifier son contexte à l'ouverture dans le portail de consultation

Ci-dessous sont décrites les différentes syntaxes ainsi que les priorités en cas de conflit, tous les paramètres étant cumulables entre eux

Truc & astuce

Dans l'URL, les paramètres sont toujours précédés par une esperluette &

Paramètre extent

L'ajout du paramètre extent dans l'URL de la carte permet de définir son emprise d'ouverture

Les cordonnées de l'extent doivent être exprimées dans la projection de visualisation de la carte : EPSG :3857 - Pseudo-Mercator Sphérique (Monde)

NB : si un seuil de visibilité pour la carte a été défini par le producteur de carte et que le paramètre extent amène à définir une échelle en dehors de cette plage de visibilité, alors la carte s'initialisera sur la plus proche des 2 bornes de la plage de visibilité

ExempleSyntaxe

https://carto2.geo-ide.din.developpement-durable.gouv.fr/frontoffice/?map=b04fd19a-040f-42ad-a59d-62bc668d90c9&extent=[Minx],[Miny],[Maxx],[Maxy]

Paramètre layers

Le paramètre layers traite uniquement des couches hors groupes

En sa présence, les groupes et leur contenu s'afficheront tels que paramétrés par le producteur de la carte, en revanche seules les couches hors groupes spécifiées seront affichées (quel que soit leur paramétrage de visibilité défini dans le back-office)

Les couches doivent être désignées par leur titre (tel qu'il apparaît dans l'arbre des couches) et séparées par des ","

NB : désigner ici une couche appartenant à un groupe n'aura aucun effet sur sa visibilité

ExempleSyntaxe

https://carto2.geo-ide.din.developpement-durable.gouv.fr/frontoffice/?map=b04fd19a-040f-42ad-a59d-62bc668d90c9&layers=[layer_title1],[layer_title2],[...]

Paramètre groups

Le paramètre groups traite uniquement des groupes de premier niveau et s'applique sur l'intégralité de celui-ci (sous-groupes compris)

Dès lors qu'un groupe est spécifié, l'ensemble des sous-groupes et couches qu'il contient deviennent visibles. Tous les autres groupes ainsi que leur contenu sont alors désactivés. Il n'a en revanche pas d'incidence sur les couches hors groupes

NB : désigner ici un sous-groupe n'aura aucun effet sur sa visibilité

ExempleSyntaxe

https://carto2.geo-ide.din.developpement-durable.gouv.fr/frontoffice/?map=b04fd19a-040f-42ad-a59d-62bc668d90c9&groups=[group_title1],[group_title2],[...]

Le paramètre object

Le paramètre object permet de centrer la carte sur un objet en particulier

L'objet sera désigné selon les critères suivants séparés par des "," :

  • [layer_title] : titre de la couche (tel qu'il apparaît dans l'arbre des couches)
  • [att_name] : nom de l'attribut
  • [value] : valeur de l'attribut définissant l'objet à utiliser pour centrer la carte. S'il y a plusieurs objets de même valeur alors la carte est centrée sur le centre du rectangle englobant de la sélection d'objets.
  • [scale] : paramètre optionnel - échelle de visualisation de la carte centrée sur l'objet. Si ce paramètre est absent, l'emprise de visualisation est l'emprise la plus proche du rectangle englobant de l'objet

NB : Le paramètre object est prioritaire sur le paramètre extent

ExempleSyntaxe

https://carto2.geo-ide.din.developpement-durable.gouv.fr/frontoffice/?map=b04fd19a-040f-42ad-a59d-62bc668d90c9&object=[layer_title],[att_name],[value],[scale]

Exemple

L'URL finale pourra être du type

https://url_carto2/frontoffice/?map=e0288445-ec1d-48c5-8857-bf761a14a42b&extent=[Minx],[Miny],[Maxx],[Maxy]&layers=[layer_title1],[layer_title2],[...]&groups=[group_title1],[group_title2],[...]&object=[layer_title],[att_name],[value],[scale]

EXEMPLE sur une carte existante

ExempleL'exemple ci-dessous utilise une carte de démonstration afin de concrétiser la manière de formuler les différents paramètres précédemment documentés
Truc & astuceQuels usages de ces surcharges d'URL au quotidien ?

Cette fonctionnalité de surcharge d'URL peut paraître de prime abord un peu technique et difficilement exploitable

La carte prise pour exemple ci-dessus, référence dans le message de description (en bas à droite de la carte) des liens qui donnent de bons exemples concrets sur le sujet