Skip To Content

Parametri URL per modificare mappe

Una mappa creata con il 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 quali una galleria di mappe di base, che consente di alternare tra mappe a immagini e stradali, oltre a strumenti di misura, popup che visualizzano attributi di una feature specifica, e pulsanti per la riproduzione dei dati nel tempo.

Oltre che con il 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 Portal for ArcGIS , più /webmap/viewer.html? e uno o più dei parametri di interrogazione 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 il 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 mappa di base

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 il 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ù di un 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

Centrare la mappa

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.

Esempio di coordinate geografiche:

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

Esempio di coordinate proiettate:

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

Definire il livello di scala

Per definire il livello della scala del map viewer, utilizzare i parametri center e level=. Per il parametro level è possibile specificare l'ID livello della scala cache elencato nell'endpoint REST del servizio. Il livello della scala cache può essere determinato utilizzando le informazioni dell'endpoint REST del map service. La risoluzione è inversamente correlata alla scala.

La scala viene impostata automaticamente quando si utilizza il parametro webmap o find; il parametro level viene ignorato. Se si utilizza il parametro webmap, viene automaticamente applicato lo zoom all'estensione completa della mappa. Se si utilizza il parametro find, viene automaticamente applicato lo zoom all'estensione migliore della posizione trovata nella mappa.

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 la posizione o la 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

Aggiungere 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 del punto. Se non si include un simbolo, viene utilizzato il simbolo di un marcatore blu.
  • <encoded label>: etichetta accanto al simbolo del punto.

Considerazioni

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

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

Nascondere il riquadro dei dettagli

Per nascondere il riquadro Dettagli del map viewer, utilizzare mapOnly=true.

Ad esempio:

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