Skip To Content

Usare i parametri URL per creare e modificare mappe

Una mappa creata in un portale ArcGIS Enterprise contiene una mappa di base; strati di dati; un'estensione; una legenda; e strumenti di navigazione come zoom, pan, cercatori di luoghi e segnalibri. Molte mappe contengono inoltre elementi interattivi come una galleria di mappe di base, strumenti di misura, popup e pulsanti per la riproduzione dei dati nel tempo.

In aggiunta alla creazione di mappe con Map Viewer o Map Viewer classico, è possibile creare e modificare mappe direttamente con parametri URL.

Ad esempio, è possibile costruire una mappa con parametri URL che mostra biomi ed ecoregioni.

myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer&url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/Resolve_Ecoregions/FeatureServer

Puoi costruire una mappa con parametri URL che mostra i parchi eolici onshore nel Regno Unito in Map Viewer classico.

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

Per esempio, si può usare un URL del visualizzatore di mappe nelle seguenti circostanze:

  • Se non hai bisogno di includere molti layer di riferimento o operativi e non hai bisogno di applicare stili specifici al contenuto della mappa, usa un URL per aprire uno dei visualizzatori di mappe. Per esempio, se il tuo sito web permette alle persone di cercare un indirizzo o di visualizzare un singolo layer relativo al tuo sito, puoi includere un link nel sito web che apre Map Viewer con la basemap specificata e il singolo layer richiesto.
  • È necessario collegarsi a una mappa web salvata da un sito web o e-mail. È possibile usare un URL che apra la mappa web specifica.

Cosa includere nell'URL

In Map Viewer classico, l'URL inizia sempre con l'URL della home page del portale ArcGIS Enterprise , più e uno o più /webmap/viewer.html? dei parametri di query elencati di seguito. In Map Viewer, l'URL inizia sempre con il nome ArcGIS Enterprise pienamente qualificato e il contesto dell'adattatore web o del bilanciatore di carico, più apps/mapviewer/index.html? e uno o più dei parametri di query elencati di seguito. Per includere più parametri, separarli con una e commerciale (&). Troverete esempi di utilizzo di parametri multipli in tutta questa pagina.

Il primo esempio qui sotto si apre Map Viewer; il secondo apre Map Viewer classico:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=8

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=8
Nota:

Se alcune risorse del parametro dell'URL sono fornite come HTTP, l'URL della mappa deve ugualmente essere HTTP. Per sicurezza aggiuntiva, usare un URL HTTPS se possibile.

Codificare i parametri di interrogazione

È necessario che tutti i parametri di interrogazione siano codificati. La codifica URL garantisce che siano inviati caratteri validi al portale. La codifica sostituisce i caratteri non validi con il simbolo % seguito dal relativo equivalente esadecimale.

Qui di seguito è riportato un esempio di parametro URL non codificato:

basemapUrl=https://myportal.domain.com:7443/arcgis/rest/services/Ocean/World_Ocean_Base/MapServer

Lo stesso parametro codificato:

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

È necessario che i parametri all'interno di altri parametri siano codificati, ad esempio:

urls=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%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 ha molti siti e strumenti iberi per generare URL codificati. Per migliorare la leggibilità, gli altri esempi presenti in questo argomento non sono codificati.

Aprire una mappa salvata

Per aprire una mappa salvata creata con Map Viewer o Map Viewer classico, usare webmap= e l'ID univoco della mappa.

Nel primo esempio, una mappa Web con ID 75a3ce8990674a5ebd5b9ab66bdab893 si aprirà in Map Viewer classico. Il secondo URL apre la stessa mappa in Map Viewer.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

In questo esempio, una mappa con un ID di 29990ur6423j1180p53f9t30019491 si aprirà in Map Viewer con l'estensione impostata su -117.996342,33.841078,-117.993692,33.844375:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375

Definire la basemap

Per definire la mappa di base, impostare basemapUrl= sul layer. Se una basemap non è definita, la basemap predefinita, basemap World Topographic, è usato.

Nel primo esempio di URL, si apre Map Viewer con la mappa fisica del mondo usata come mappa di base. Il secondo URL di esempio lo apre in Map Viewer classico.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

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

In questo esempio, Map Viewer si apre con la mappa fisica del mondo utilizzata come mappa di base e un layer operativo con ID elemento 9e2f2b544c954fda9cd13b7f3e6eebce presente nella mappa:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

Includere un layer di riferimento

Per includere un layer di riferimento con la mappa di base, impostare basemapReferenceUrl= sul layer. Oltre al parametro basemapReferenceUrl=, è necessario utilizzare il parametro basemapUrl.

In questo esempio, Map Viewer classicosi apre con il layer mappa di base Immagini del mondo e il layer di rifeirmento impostato su Confini mondiali e il layer Luoghi:

https://myportal.domain.com/arcgis/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

Definire i layer operativi

Per definire i layer operativi che vengono sovrapposti alla mappa di base, utilizzare webmap=, layers=, layerIds=, url=, oppure urls=. Se il layer è un elemento del sito Web, utilizzare layers= per ottenere tutte le configurazioni dei layer. Per aggiungere singoli sublayer da un feature layer che contiene più sublayer, usa layerIds=. Se il layer non è presente nel sito Web, utilizzare url= o urls=.

Per il parametro layers= è possibile specificare uno o più ID elemento. Nel caso di layer multipli, utilizzare un elenco di ID separati da virgole (&layers=<itemID>,<itemID>,<itemID>).

Il primo esempio si apre in Map Viewer. Il secondo si apre in Map Viewer classico:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

Per il parametro layerIds= è possibile specificare uno o più ID layer. Se un feature layer contiene più sublayer, usa il parametro layerIds= per aggiungere i singoli sublayer. Per più sublayers, usa una lista di ID separata da virgole (&layerIds=0,1,2).

Il primo esempio si apre in Map Viewer. Il secondo si apre in Map Viewer classico:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2
https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

Per il parametro url= è possibile specificare l'URL di un singolo layer.

Vedere l'esempio seguente:

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

Utilizzare il parametro urls= per includere più layer. Separare i layer con una virgola. L'estensione della mappa è basata sull'ultimo layer dell'elenco o sul più lento da caricare. Per eseguire lo zoom di un'estensione specifica, includere il parametro extent=.

Il primo URL apre la mappa in Map Viewer. Il secondo URL si apre in Map Viewer classico:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4&extent=-108,40,-85,31

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4

A partire da ArcGIS 10.5, è possibile utilizzare l'operazione ?layers su un Feature Service.

Vedere l'esempio seguente:

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

Definire il livello di scala e centrare la mappa

La scala viene impostata automaticamente per una mappa nel Map Viewer classico quando si utilizza il parametro webmap o find. Se si utilizza il parametro webmap, viene automaticamente applicato lo zoom all'estensione completa della mappa, a meno che non si usino altri parametri degli URL come level e center o extent per ignorare la scala della Web Map. Se si utilizza il parametro find, viene automaticamente applicato lo zoom all'estensione migliore della posizione trovata nella mappa.

Per definire un livello specifico della scala, utilizzare i parametri center e level. Per il parametro level è possibile specificare l'ID livello della scala cache elencato nell'endpoint del servizio REST della basemap "tiled". La risoluzione è inversamente correlata alla scala. Il parametro level è supportato solo per le basemap "tiled", non per le basemap create da map service dinamici e altri dati non "tiled".

Per centrare la mappa in base a una posizione specifica, impostare center utilizzando coordinate geografiche (x,y) o coordinate proiettate (x,y,WKID). Come separatori è possibile utilizzare le virgole o i punti e virgola. Utilizza il punto e virgola se i numeri utilizzano la virgola per i decimali.

Nota:

I parametri level e center devono essere usati insieme. Il parametro level viene ignorato se viene utilizzato da solo.

Un esempio di coordinate geografiche è riportato in Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4

Un esempio di coordinate geografiche è riportato in Map Viewer classico:

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

Di seguito è riportato un esempio di coordinate proiettate in Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=500000,5500000,102100&level=4

Definire l'estensione

Per definire l'estensione della mappa utilizzare extent. Per il parametro extent è possibile specificare le coordinate geografiche (GCS) sotto forma di MinX,MinY,MaxX,MaxY o coordinate proiettate (PCS) sotto forma di MinX,MinY,MaxX,MaxY,WKID. Come separatori è possibile utilizzare le virgole o i punti e virgola. Utilizza il punto e virgola se i numeri utilizzano la virgola per i decimali.

Un esempio di coordinate geografiche è riportato in Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Di seguito è riportato un esempio di coordinate proiettate in Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Di seguito è riportato un esempio di coordinate proiettate in Map Viewer classico:

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

Impostare la visibilità dei layer

Per impostare la visibilità dei sottolayer per un layer che si apre nella mappa, usare layers=show:.

In questo esempio, il sublayer 3 è visibile ma altri sublayer non sono visibili:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania

Trovare una posizione o una feature con cui aprire la mappa

Per trovare una posizione o feature immediatamente all'apertura della mappa, usare find La mappa viene automaticamente ingrandita sul risultato che si avvicina di più ai criteri e un marcatore callout viene aggiunto alla mappa. Per il parametro find è possibile specificare indirizzi su riga singola, indirizzi parziali, ad esempio solo città o solo paese, nomi di luoghi e coordinate latitudine-longitudine.

L'esempio seguente usa un indirizzo a linea singola in Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?find=380 new york st,redlands,ca
Suggerimento:

Per trovare una posizione o feature in un layer cercabile, includere il parametro webmap= con l'ID univoco della mappa.

Aggiungi un punto

Per aggiungere un punto alla mappa, utilizzare marker=<x>,<y>. È inoltre possibile includere le seguenti proprietà facoltative:

  • <wkid>: riferimento spaziale delle coordinate x,y da aggiungere alla mappa. Se non si include un valore WKID, vengono utilizzate le coordinate GCS.
  • <encoded title>: titolo del popup del punto. Se non si include un titolo, il popup sarà vuoto.
  • <encoded icon URL>: simbolo per il punto. Se non si include un simbolo, viene utilizzato il simbolo di un marcatore blu.
  • <encoded label>: etichetta accanto al simbolo del punto.

Esempio

Il seguente esempio utilizza separatori punto e virgola:

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

Considerazioni

Tenere in mente quanto segue quando si aggiunge un punto a una mappa:

  • In Map Viewer classico, il punto viene aggiunto a un nuovo layer di note di mappa nella posizione di coordinate x,y specificata.
  • Le coordinate <x>,<y> sono richieste per aggiungere un punto.
  • È necessario codificare i parametri title, icon elabel.
  • È necessario aggiungere le proprietà nel seguente ordine: marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
  • Come separatori è possibile utilizzare le virgole o i punti e virgola. Utilizza il punto e virgola se i numeri utilizzano la virgola per i decimali.
  • Utilizzare valori vuoti. Non utilizzare spazi. Per esempio, per specificare un'etichetta e nessuna proprietà facoltativa, aggiungere l'etichetta come sesto parametro con i valori vuoti per altri (x;y;;;;label).
  • Se si desidera che nella mappa venga applicato lo zoom avanti (oltre alla centratura sul punto), includere il parametro level.
  • È possibile modificare e salvare il layer delle note mappa come mappa o come elemento.
  • Gli account aziendali possono utilizzare il punto per ottenere indicazioni ed eseguire analisi.

Nascondere il riquadro dei dettagli

Nota:

Questa funzionalità è attualmente supportata solo in Map Viewer classico (precedentemente noto come Map Viewer). Sarà disponibile in una futura versione del nuovo Map Viewer.

Per nascondere il pannello Dettagli in Map Viewer classico, usare mapOnly=true.

In questo esempio, una mappa web salvata con ID b487d81007294fb5a0be9e10a411f2d0 viene aperto in Map Viewer classico, ma il pannello Dettagli è nascosto:

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