Una mappa creata con Map Viewer o Map Viewer classico 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.
https://www.arcgis.com/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/FeatureServerVisualizzare questo esempio in Map Viewer
Per esempio, è possibile usare un URL Map Viewer nelle circostanze seguenti:s
- Se non è necessario includere un sacco di riferimenti o layer operazionali e non è necessario applicare stili specifici al contenuto della mappa, usare un URL per aprire Map Viewer. Ad esempio, se il sito web consente agli utenti di guardare a un indirizzo o visualizzare un singolo layer correlato al sito, è possibile includere un link nel sito Web che apra Map Viewer con la mappa di base 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
L'URL inizia sempre con https://www.arcgis.com/apps/mapviewer/index.html? in Map Viewer e https://www.arcgis.com/home/webmap/viewer.html? in Map Viewer classico e include 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.
Vedere l'esempio seguente:
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=8Visualizzare questo esempio in Map Viewer
Nota:
Se una qualsiasi delle risorse del parametro URL è fornita come HTTP, è necessario sostituire HTTP con HTTPS nell'URL e rendere tutte le risorse accessibili solo utilizzando HTTPS.
Codificare i parametri di interrogazione
È necessario che tutti i parametri di interrogazione siano codificati. La codifica URL garantisce che siano inviati caratteri validi ad ArcGIS Online. 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://services.arcgisonline.com/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%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 offre molti siti e strumenti gratuiti per generare URL codificati, ad esempio https://www.urlencoder.io/. Per migliorare la leggibilità, gli altri esempi presenti in questo argomento non sono codificati. Cliccare il link Visualizza questo esempio in Map Viewer dopo l'esempio per vedere l'URL decodificato in un browser web.
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.
In questo esempio, una mappa web con ID 75a3ce8990674a5ebd5b9ab66bdab893 si aprirà in Map Viewer:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893Visualizzare questo esempio in Map Viewer
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://www.arcgis.com/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375Definire la basemap
Per definire la mappa di base, impostare basemapUrl= sul layer. Se una basemap non è definita, la basemap predefinita, basemap World Topographic, è usato.
In questo esempio, Map Viewer si apre con OpenStreetMap utilizzato come mappa di base:
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebceVisualizzare questo esempio in Map Viewer
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://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebceIncludere 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 si apre con il layer immagine della mappa di base Immagini del mondo e il layer di riferimento impostato sui confini mondiali e il layer Luoghi.
https://www.arcgis.com/apps/mapviewer/index.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/MapServerIn questo esempio, Map Viewer si apre con il livello di immagine della mappa del mondo presente e la mappa di base impostata sul livello World boundary and places:
https://myportal.domain.com/apps/mapviewer/index.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/MapServerDefinire 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>).
Vedere l'esempio seguente:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3Visualizzare questo esempio in Map Viewer
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).
Vedere l'esempio seguente:
https://www.arcgis.com/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2Visualizzare questo esempio in Map Viewer
Per il parametro url= è possibile specificare l'URL di un singolo layer.
Vedere l'esempio seguente:
https://www.arcgis.com/apps/mapviewer/index.html?url=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/USGS_Seismic_Data_v1/FeatureServerVisualizzare questo esempio in Map Viewer
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=.
Vedere l'esempio seguente:
https://www.arcgis.com/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,31Definire 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.
Di seguito è riportato un esempio di coordinate geografiche:
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=4Visualizzare questo esempio in Map Viewer
Di seguito è riportato un esempio di coordinate proiettate:
https://www.arcgis.com/apps/mapviewer/index.html?center=500000,5500000,102100&level=4Definire 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.
Di seguito è riportato un esempio di coordinate geografiche:
https://www.arcgis.com/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06Visualizzare questo esempio in Map Viewer
Di seguito è riportato un esempio di coordinate proiettate:
https://www.arcgis.com/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113Impostare 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:
Nota:
La numerazione dei sublayer inizia con zero (0), come mostrato nell'endpoint REST.https://www.arcgis.com/apps/mapviewer/index.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=PennsylvaniaTrovare 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 e feature in layer per ricerche, ad esempio 1916352001 per un numero di identificazione lotto (PIN).
L'esempio seguenti utilizza un indirizzo a riga singola:
https://www.arcgis.com/apps/mapviewer/index.html?find=380 new york st,redlands,caVisualizzare questo esempio in Map Viewer
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://www.arcgis.com/apps/mapviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra MarathonConsiderazioni
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. Sarà disponibile in una futura versione di Map Viewer.
Per nascondere il pannello Dettagli in Map Viewer classico, usare mapOnly=true.
In questo esempio, una mappa web salvata con ID 8505192e747d440098523e9e64419710 viene aperta in Map Viewer classico, ma il pannello Dettagli è nascosto:
https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true