Utilizzare i parametri delle URL per modificare le mappe

Una mappa creata con Map Viewer contiene una mappa di base, layer dati, un'estensione, una legenda e strumenti di navigazione quali zoom, pan, utilità di ricerca 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.

Oltre che con Map Viewer, è possibile creare o modificare mappe direttamente con parametri dell'URL.

Qui di seguito è riportato un esempio che illustra in che modo è possibile creare una mappa con parametri dell'URL che mostrano parchi eolici onshore nel Regno Unito.

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

Cosa includere nell'URL

L'URL inizia sempre con la home page del portale ArcGIS Enterprise, più /webmap/viewer.html? e uno o più parametri di interrogazione tra quelli elencati di seguito. Per includere più parametri, separarli con una e commerciale (&).

Ad esempio:

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

Nota:

Se alcune risorse del parametro dell'URL sono fornite come HTTP, l'URL della mappa dovrebbe ugualmente essere HTTP. Per maggiore sicurezza, si dovrebbe utilizzare 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 Web. 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_Basemap/MapServer

Lo stesso parametro codificato:

basemapUrl=http%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%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%2Chttp%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

Nel Web sono presenti diversi siti e strumenti gratuiti per la generazione di 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, utilizzare webmap= e l'ID univoco della mappa.

Ad esempio:

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

Definire la basemap

Per definire la mappa di base, impostare basemapUrl= sul layer. Se non è stata definita una mappa di base, quella predefinita sarà la mappa di base topografica mondiale.

Ad esempio:

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

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.

Ad esempio:

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

Definire i layer operativi

Per definire i layer operativi che vengono sovrapposti alla mappa di base, utilizzare webmap=, layers=, url= o urls=. Se il layer è un elemento del sito Web, utilizzare layers= per ottenere tutte le configurazioni dei layer. 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>).

Ad esempio:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

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

Ad esempio:

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

Ad esempio:

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

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

Ad esempio:

http://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 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. Utilizzare 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.

Esempio di coordinate geografiche:

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

Esempio di coordinate proiettate:

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

Definire l'estensione

Utilizzare extent per definire l'estensione della mappa. 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. Utilizzare il punto e virgola se i numeri utilizzano la virgola per i decimali.

Esempio di coordinate geografiche:

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

Esempio di coordinate proiettate:

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 layer nella mappa, utilizzare layers=show:.

Ad esempio:

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

Trovare una posizione o una feature con cui aprire la mappa

Per trovare una posizione o una feature utilizzata per aprire la mappa, utilizzare 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.

Il seguente esempio utilizza un indirizzo a riga singola.

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

Aggiungi un punto

Per aggiungere un punto alla mappa, utilizzare marker=<x>,<y>. Il punto viene aggiunto a un nuovo layer di note mappa nella posizione x,y specificata. È inoltre possibile includere le seguenti proprietà facoltative:

• <wkid>: riferimento spaziale delle coordinate x,y aggiunte 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.

Considerazioni

Durante l'aggiunta di un punto alla mappa, si tenga presente quanto segue:

• <x>,<y> sono obbligatori.
• Assicurarsi di codificare i parametri title, icon e label.
• È 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. Utilizzare il punto e virgola se i numeri utilizzano la virgola per i decimali.
• Utilizzare valori vuoti. Non utilizzare spazi. Ad esempio, se si desidera specificare solo l'etichetta ma nessuna delle altre proprietà facoltative, aggiungere l'etichetta come sesto parametro e valori vuoti per gli 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.

Questa funzione è stata aggiunta a partire da 10.1.

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

Nascondere il riquadro dei dettagli

Per nascondere il riquadro Dettagli di Map Viewer, utilizzare mapOnly=true.

Ad esempio:

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