Utiliser des paramètres URL pour modifier des cartes

Une carte créée avec Map Viewer contient un fond de carte, des couches de données, une étendue, une légende et des outils de navigation qui permettent notamment de zoomer, de déplacer la carte, de rechercher des localités et de créer des géosignets. Plusieurs cartes peuvent également contenir des éléments interactifs tels qu’une bibliothèque de fonds de carte, des outils de mesure, des fenêtres contextuelles et des boutons pour la lecture des données.

Pour ne pas créer de cartes avec Map Viewer, vous pouvez créer et modifier les cartes directement avec des paramètres URL.

Voici par exemple comment créer une carte avec les paramètres URL, qui présente des hauts-fonds au large de la côte du Maryland.

https://www.arcgis.com/home/webmap/viewer.html?basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=https%3A%2F%2Fservices5.arcgis.com%2F9cBkZtsx7PSOoaCF%2Farcgis%2Frest%2Fservices%2FMaryland_Shoals%2FFeatureServer%2F0

Afficher cet exemple dans Map Viewer

Composants à inclure dans l'URL

L’URL commence toujours par https://www.arcgis.com/home/webmap/viewer.html? et contient un ou plusieurs des paramètres de requête suivants. Si vous souhaitez inclure plusieurs paramètres, utilisez un caractère Et commercial (&) pour les séparer.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?center=20,45&level=4

Afficher cet exemple dans Map Viewer

Remarque :

Si certaines des ressources du paramètre d'URL sont fournies sous forme de chemin HTTP, l'URL de la carte doit également être au format HTTP. Pour une sécurité accrue, utilisez une URL HTTPS dans la mesure du possible.

Coder les paramètres de requête

Tous les paramètres de requête doivent être codés. Le codage des URL permet de s’assurer que des caractères valides sont envoyés à ArcGIS Online. Le codage remplace les caractères non valides par %, suivis de leur équivalent hexadécimal.

Voici un exemple de paramètre URL non codé :

basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer

Voici le même paramètre codé :

basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

Les paramètres qui se trouvent au sein de paramètres doivent également être codés, par exemple :

urls=https%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttps%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

Internet propose de nombreux sites et outils gratuits pour générer des URL codées. Par exemple, Albion Research Ltd. offre une page URLEncode et URLDecode. Pour des raisons de lisibilité, le reste des exemples dans cette rubrique ne sont pas codés. Cliquez sur le lien View this example in Map Viewer (Affichez cet exemple dans Map Viewer) après l’exemple pour voir l’URL codée dans un navigateur web.

Ouvrir une carte enregistrée

Pour ouvrir une carte enregistrée créée avec Map Viewer, utilisez webmap= et l'ID unique de la carte.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

Afficher cet exemple dans Map Viewer

Définir le fond de carte

Pour définir le fond de carte, définissez basemapUrl= sur la couche. Si le fond de carte n’est pas défini, le fond de carte par défaut sera le fond de carte topographique mondial.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

Afficher cet exemple dans Map Viewer

Inclure une couche de référence

Pour inclure une couche de référence avec le fond de carte, définissez basemapReferenceUrl= sur la couche. Le paramètre basemapReferenceUrl= doit être utilisé en plus du paramètre basemapUrl.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?
basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer

Afficher cet exemple dans Map Viewer

Définir les couches opérationnelles

Pour définir les couches opérationnelles qui se superposent au fond de carte, utilisez webmap=, layers=, url= ou urls=. Si la couche est un élément du site Web, utilisez layers= afin d'obtenir toutes les configurations des couches. Si la couche ne se trouve pas sur le site Web, utilisez url= ou urls=.

Le paramètre layers= accepte un seul identifiant d'élément ou plusieurs identifiants d'éléments. Si plusieurs couches sont présentes, utilisez une liste d'identifiants séparés par une virgule (&layers=<itemID>,<itemID>,<itemID>).

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,9e2f2b544c954fda9cd13b7f3e6eebce

Afficher cet exemple dans Map Viewer

Le paramètre url= accepte une URL de couche unique.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?
     url=https://services.arcgisonline.com/ArcGIS/rest/services/Demographics/USA_Population_Density/MapServer

Afficher cet exemple dans Map Viewer

Utilisez le paramètre urls= pour inclure plusieurs couches. Séparez les couches par une virgule. L'étendue de la carte est basée sur la dernière couche dans la liste ou sur la plus lente à se charger. Pour zoomer sur une étendue spécifique, incluez le paramètre extent=.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?urls=https://gis.ngdc.noaa.gov/arcgis/rest/services/web_mercator/trackline_combined_dynamic/MapServer,https://nowcoast.noaa.gov/arcgis/rest/services/nowcoast/wwa_meteoceanhydro_longduration_hazards_time/MapServer?layers=show:0,1,2,4,5&extent=-135-70,17,50

Afficher cet exemple dans Map Viewer

Définir le niveau d’échelle et centrer la carte

L’échelle est automatiquement définie pour une carte dans Map Viewer lorsque vous utilisez le paramètre webmap ou find. Si vous utilisez le paramètre webmap, la carte effectue un zoom automatique sur l’étendue globale de la carte, sauf si d’autres paramètres URL tels que level et center ou extent sont utilisés pour remplacer l’échelle de la carte. Si vous utilisez le paramètre find, la carte effectue un zoom automatique sur la meilleure étendue de l'emplacement trouvé.

Pour définir un niveau d’échelle spécifique, utilisez les paramètres center et level. Le paramètre level accepte l’ID de niveau de l’échelle du cache tel qu’il figure dans l’extrémité du service REST du fond de carte tuilé. La résolution est inversement associée à l’échelle. Le paramètre level est uniquement pris en charge pour les fonds de carte tuilés et non pour les fonds de carte créés à partir de services de carte dynamiques et d’autres données non tuilées.

Pour centrer la carte à un emplacement en particulier, définissez center à l'aide des coordonnées géographiques (x,y) ou des coordonnées projetées (x, y, WKID). Vous pouvez utiliser des virgules ou des points-virgules comme séparateurs. Utilisez des points-virgules si vos nombres ont deux points comme symbole de décimales.

Remarque :

Les paramètres level et center doivent être utilisés ensemble. Le paramètre level est ignoré s’il est utilisé tout seul.

Exemple de coordonnées géographiques :

https://www.arcgis.com/home/webmap/viewer.html?center=20,45&level=4

Afficher cet exemple dans Map Viewer

Exemple de coordonnées projetées :

https://www.arcgis.com/home/webmap/viewer.html?center=500000,5500000,102100&level=4

Afficher cet exemple dans Map Viewer

Définir l'étendue

Pour définir l'étendue de la carte, utilisez extent. Le paramètre extent accepte des coordonnées géographiques (GCS) MinX,MinY,MaxX,MaxY ou des coordonnées projetées (PCS) MinX,MinY,MaxX,MaxY,WKID. Vous pouvez utiliser des virgules ou des points-virgules comme séparateurs. Utilisez des points-virgules si vos nombres ont deux points comme symbole de décimales.

Exemple de coordonnées géographiques :

https://www.arcgis.com/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

Afficher cet exemple dans Map Viewer

Exemple de coordonnées projetées :

https://www.arcgis.com/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Afficher cet exemple dans Map Viewer

Définir la visibilité des couches

Pour définir la visibilité des couches de la carte, utilisez layers=show:.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?url=https://sampleserver3.arcgisonline.com/ArcGIS/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

Afficher cet exemple dans Map Viewer

Rechercher un emplacement ou une entité pour ouvrir la carte

Pour rechercher l'emplacement ou l'entité sur lequel ouvrir la carte, utilisez find. La carte effectue automatiquement un zoom sur le résultat le plus proche et un symbole ponctuel de rappel est ajouté à la carte. Le paramètre find accepte les adresses sur une seule ligne, les adresses partielles (comme une ville ou un pays uniquement), les noms de lieux, les coordonnées de longitude/latitude et les entités contenues dans des couches dans lesquelles il est possible d’effectuer des recherches (par exemple, 1916352001 comme numéro d’identification de parcelle (PIN)).

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?find=380 new york st,redlands,ca

Afficher cet exemple dans Map Viewer

Astuce :

Pour trouver un emplacement ou une entité dans une couche autorisant les recherches, vous pouvez inclure le paramètre webmap= avec ID unique de la carte.

Ajouter un point

Pour ajouter un point sur la carte, utilisez marker=<x>,<y>. Le point est ajouté à une nouvelle couche de notes de carte à l'emplacement x,y spécifié. Vous pouvez également inclure les propriétés facultatives suivantes :

  • <wkid> : référence spatiale des coordonnées x,y ajoutées à la carte. Si vous n'incluez pas de WKID, les coordonnées GCS sont utilisées.
  • <encoded title> : titre de la fenêtre contextuelle de point. Si vous n'incluez pas de titre, la fenêtre contextuelle sera vide.
  • <encoded icon URL> : symbole du point. Si vous n'incluez pas de symbole, un symbole ponctuel bleu est utilisé.
  • <encoded label> : étiquette en regard du symbole de point.

Éléments à prendre en compte

Gardez les points suivants à l’esprit lorsque vous ajoutez un point sur la carte :

  • <x>,<y> sont obligatoires.
  • Veillez à coder les paramètres titleicon et label.
  • Vous devez ajouter les propriétés dans l'ordre suivant : marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
  • Vous pouvez utiliser des virgules ou des points-virgules comme séparateurs. Utilisez des points-virgules si vos nombres ont deux points comme symbole de décimales.
  • Utilisez des valeurs vides. N'utilisez pas d'espaces. Par exemple, si vous voulez préciser une étiquette et aucune autre propriété facultative, ajoutez l'étiquette en tant que sixième paramètre avec des valeurs vides pour les autres (x;y;;;;label).
  • Si vous voulez faire un zoom avant sur la carte (en plus de centrer sur le point), incluez le paramètre level.
  • Vous pouvez modifier et enregistrer la couche de notes de la carte en tant que carte ou qu'élément.
  • Les comptes d'organisation peuvent utiliser le point pour obtenir des directions et effectuer une analyse.

Exemple

L'exemple suivant utilise des points-virgules comme séparateurs :

https://www.arcgis.com/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Afficher cet exemple dans Map Viewer

Masquer la fenêtre des détails

Pour masquer le volet Détails de Map Viewer, utilisez mapOnly=true.

Par exemple :

https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true

Afficher cet exemple dans Map Viewer