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 parcs éoliens terrestres au Royaume-Uni.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=http%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=http%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

Composants à inclure dans l'URL

L'URL commence toujours par la page d’accueil de ArcGIS Enterprise, plus /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://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

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 au site Web du portail. 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://myportal.domain.com:7443/arcgis/rest/services/Ocean_Basemap/MapServer

Voici le même paramètre codé :

basemapUrl=http%3A%2F%2Fmyportal.domain.com:7443%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%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttp%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. Pour des raisons de lisibilité, le reste des exemples dans cette rubrique ne sont pas codés.

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://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

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 mondiale.

Par exemple :

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

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://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=http://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

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://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

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

Par exemple :

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

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://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

Depuis ArcGIS 10.5, vous pouvez utiliser l'opération ?layers sur un service d'entités.

Par exemple :

http://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

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://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

Exemple de coordonnées projetées :

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

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://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

Exemple de coordonnées projetées :

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

Définir la visibilité des couches

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

Par exemple :

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://otherportal.domain.com:7443/arcgis/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

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 à une seule ligne, les adresses partielles (comme une ville ou un pays uniquement), les noms de localité et les coordonnées de longitude-latitude.

Dans l'exemple suivant, une adresse à une seule ligne est utilisée.

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

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.

Eléments à prendre en compte

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

• <x>,<y> sont nécessaires.
• 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://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Masquer la fenêtre des détails

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

Par exemple :

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true