Utiliser des paramètres URL pour modifier des cartes incorporées

Remarque :

Cette fonction est actuellement prise en charge uniquement dans Map Viewer Classic. Elle sera disponible dans une prochaine version de Map Viewer.

Map Viewer Classic fournit du code HTML prêt à l'emploi pour incorporer une carte dans un site web. Vous pouvez choisir des options à inclure sur la carte, à savoir un bouton d'accueil, un contrôle de zoom et une légende. Elles sont ajoutées au code que vous copiez et collez dans votre site web. Vous pouvez également ajouter ces options en utilisant des paramètres URL.

L’URL de la carte incorporée commence toujours par l’URL de votre organisation ou du site public (https://www.arcgis.com) et /apps/Embed/index.html?webmap=<your web map ID>. En voici un exemple :

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

L'URL peut également contenir un ou plusieurs paramètres parmi les suivants. Certains paramètres URL modifient le comportement de la carte incorporée alors que d'autres modifient les fonctionnalités disponibles dans la carte incorporée. Si vous souhaitez inclure plusieurs paramètres, utilisez un caractère Et commercial (&) pour les séparer. En voici un exemple :

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

Remarque :

Si certaines des ressources du paramètre d’URL sont fournies sous forme de chemin HTTP, vous devez remplacer HTTP par HTTPS dans l’URL et rendre toutes les ressources accessibles uniquement via HTTPS.

Mise en page

Les paramètres suivants vous permettent de contrôler l'aspect de la carte :

  • theme : détermine la combinaison de couleurs appliquée au volet latéral et aux boutons. Les options valides sont light ou dark.
  • legend : lorsque ce paramètre a la valeur true, une légende s’affiche dans le volet latéral qui identifie les couches de la carte.
  • details : lorsque ce paramètre a la valeur true, une description de la carte apparaît dans le volet latéral.
  • active_panel : définit l’onglet actif dans le volet latéral lors du chargement de la carte. Les options valides sont legend ou details. Le paramètre legend ou details doit être défini sur true s’il sert de valeur au paramètre active_panel.
  • show_panel : lorsque ce paramètre a la valeur true, le volet latéral apparaît lors du chargement de la carte. La valeur par défaut est false.
  • popup_sidepanel : lorsque le paramètre a la valeur true, des informations contextuelles apparaissent dans l’onglet Infos du volet latéral plutôt que sur la carte.
  • zoom_position : détermine l’emplacement des boutons de contrôle de zoom. Les options valides sont top-left (par défaut), bottom-left, top-right ou bottom-right. Si le paramètre home est défini sur true, le bouton d’accueil se déplace selon la valeur du paramètre zoom_position.
  • logoimage : URL vers une image utilisée en tant que miniature activée par un clic dans la mise en page de la carte. En cliquant sur la miniature, vous êtes redirigé vers l’URL définie à l’aide du paramètre logolink.
  • logolink : URL vers un site Web ou une ressource Web externe. En cliquant sur l’image miniature définie à l’aide du paramètre logoimage, vous êtes redirigé vers l’URL définie dans logolink.

Exemple d'une carte incorporée avec un thème foncé, une légende, l'affichage d'un volet au chargement, des boutons de zoom en haut à droite et l'image du logo liée à une page Web.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

Exemple d'une carte incorporée avec une légende, des détails, l'onglet des détails activé dans le volet, et des fenêtres contextuelles affichées dans le volet latéral de l'onglet Infos.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

Cartographie

Les paramètres suivants contrôlent la navigation dans la carte et la visibilité des éléments cartographiques :

  • webmap : ID de la carte web à afficher dans la visionneuse de carte incorporée, par exemple, webmap=432a8d7ca22d4b5b859e0bdaa30ae118. Le paramètre webmap doit être spécifié.
  • extent : permet de spécifier l’étendue à utiliser pendant le chargement de la carte. Ce paramètre remplace l'étendue par défaut de la carte. Seules des valeurs d'un système de coordonnées géographiques sont valides.
  • center : centre la carte à l’aide de coordonnées géographiques (x,y).
  • level : ID de niveau de l’échelle en cache telle qu’elle est indiquée à l’extrémité REST du fond de carte. Cela détermine le niveau de zoom par défaut lors du chargement de la carte, par exemple, level=9.
  • zoom : lorsque ce paramètre a la valeur true, les boutons de zoom avant et arrière sont affichés. Le paramètre zoom_position permet de contrôleur leur emplacement sur la carte.
  • home : si cette option est définie sur true, le bouton d’accueil s’affiche. Le bouton d'accueil permet de retourner à l'étendue par défaut de la carte. Si le paramètre extent est défini, le bouton d’accueil utilise cette étendue plutôt que l’étendue par défaut de la carte. Le paramètre home est valide uniquement si zoom est également défini sur true.
  • scale : si cette option est définie sur true, la barre d’échelle s’affiche. La barre d'échelle apparaît dans l'angle inférieur gauche de la carte.
  • disable_scroll : si cette option est définie true, le zoom par défilement de la souris est désactivé. La valeur par défaut est true.
  • marker : place l’image souhaitée sous la forme d’un symbole ponctuel, avec une fenêtre contextuelle sur la carte à l’endroit choisi. La syntaxe est la suivante : marker=longitude;latitude;wkid;description;URL;title. La longitude et la latitude doivent être spécifiées, mais les autres valeurs sont facultatives. Les valeurs de description et de titre doivent être codées dans l'URL. Si vous ne souhaitez pas inclure de valeur facultative, ne la spécifiez pas. En voici un exemple :
    marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
  • basemap_toggle : le bouton de bascule du fond de carte s’affiche. Ce paramètre doit avoir la valeur true pour pouvoir utiliser alt_basemap.
  • alt_basemap : ce paramètre détermine quel autre fond de carte est utilisé avec l’option de bascule de fonds de carte. Le paramètre basemap_toggle doit être défini sur true afin d’utiliser alt_basemap. Si aucun autre fond de carte n'est spécifié, le fond de carte satellite est utilisé. Les valeurs valides sont streets, satellite, hybrid, topo, gray, oceans, national-geographic, osm, terrain et dark-gray.

Exemple d'une carte incorporée avec étendue personnalisée, boutons de zoom désactivés, barre d'échelle affichée, défilement de la souris pour le zoom activé et bibliothèque de fonds de carte.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

Exemple d'une carte incorporée avec centre, niveau d'échelle de zoom, bouton d'accueil et bascule de fond de carte avec un autre fond de carte.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

Recherche d’emplacements et d’entités (recherche géographique)

Les paramètres suivants sont utilisés pour la recherche de données dans la carte :

  • search : lorsque ce paramètre a la valeur true, le widget de recherche s’affiche. Ce widget prend en charge l'exploration de couches de géocodage et de recherche. Le paramètre search doit avoir la valeur true pour pouvoir utiliser find dans des couches de la carte pouvant faire l’objet d’une recherche.
  • searchextent : lorsque ce paramètre a la valeur true, une recherche géographique via le widget de recherche renvoie des résultats figurant dans l’étendue par défaut de la carte.
  • find : ouvre la carte à un emplacement spécifique. Le paramètre find peut être utilisé pour procéder à des recherches par adresses ou lieux (codage géographique) ou pour rechercher des valeurs de champ d’attribut dans une couche interrogeable. Ce paramètre renvoie des résultats provenant de toutes les ressources de recherche auxquelles la carte peut accéder. Si les valeurs de la couche dans laquelle vous pouvez effectuer des recherches sont semblables aux valeurs de géocodage, les résultats obtenus risquent d'être trompeurs. Par exemple, si vous recherchez des codes FIPS à cinq chiffres dans le champ d'une couche dans laquelle il est possible d'effectuer des recherches, ils risquent d'être confondus avec des codes ZIP des Etats-Unis, et les résultats renvoyés ne seront pas pertinents. Pour rechercher des entités, utilisez le paramètre feature au lieu de find dans des cas semblables à celui-ci ou si vous devez affiner les résultats.
  • feature : permet de rechercher une entité spécifique dans une couche d’entités permettant les opérations de recherche. Vous devez configurer l'option Recherche par couche sur la carte pour activer un champ de recherche. La syntaxe est feature=layerID;searchfield;searchvalue, par exemple, feature=CentralIndianaCities_634;PLACEFIPS;05860.

    L'URL suivante fait référence à l'exemple ci-dessus concernant les villes au centre de l'Etat d'Indiana et permet de découvrir l'ID de la couche qui vous intéresse dans votre carte. Vous remarquerez id:CentralIndianaCities_634 sous operationalLayers. Remplacez l’ID de webmap par l’ID de votre carte Web pour trouver votre ID de couche.

    https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

Exemple d'une carte incorporée qui inclut la recherche, une étendue de recherche, et qui s'ouvre à un emplacement spécifique.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

Exemple d'une carte incorporée qui s'ouvre sur une entité spécifique.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860