Utilizzare parametri degli URL per modificare mappe incorporate

Nota:

Questa funzionalità è attualmente supportata solo in Map Viewer classico. Sarà disponibile in una futura versione di Map Viewer.

Il Map Viewer classico fornisce codice HTML pronto all'uso per incorporare una mappa in un sito Web. È possibile scegliere opzioni da includere nella mappa, ad esempio pulsante Home, controllo zoom e una legenda, che vengono aggiunte al codice che viene copiato e incollato nel sito Web. Un altro modo per aggiungere queste opzioni è utilizzare parametri dell'URL.

L'URL per la mappa incorporata inizia sempre con l'URL dell'organizzazione o il sito pubblico (https://www.arcgis.com) e /apps/Embed/index.html?webmap=<your web map ID>. come nell'esempio seguente:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

L'URL può anche includere uno o più dei parametri elencati di seguito. Alcuni parametri dell'URL modificano il comportamento della mappa incorporata mentre altri modificano la funzionalità disponibile nella mappa incorporata. Per includere più parametri, separarli con una e commerciale (&). come nell'esempio seguente:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

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.

Layout

I seguenti parametri forniscono il controllo dell'aspetto della mappa:

  • theme: determina il tema colori applicato al riquadro laterale e ai pulsanti. Opzioni valide sono light o dark.
  • legend: quando l'opzione è impostata su true, nel riquadro laterale viene visualizzata una legenda che mostra i layer nella mappa.
  • details: quando l'opzione è impostata su true, il testo di descrizione della mappa viene visualizzato nel riquadro laterale.
  • active_panel: imposta la scheda attiva nel riquadro laterale quando la mappa viene caricata. Opzioni valide sono legend o details. Il parametro legend o details deve essere impostato su true se utilizzato come il valore per il parametro active_panel.
  • show_panel: quando l'opzione è impostata su true, il riquadro laterale viene visualizzato quando la mappa viene caricata. L'impostazione predefinita è false.
  • popup_sidepanel: quando l'opzione è impostata su true, informazioni popup vengono visualizzate nella scheda informazioni del riquadro laterale anziché nella mappa.
  • zoom_position: determina la posizione dei pulsanti di controllo dello zoom. Opzioni valide sonotop-left (impostazione predefinita), bottom-left,top-right obottom-right. Se il parametro home è impostato su true, anche il pulsante Home si sposta in base al valore del parametro zoom_position.
  • logoimage: URL di un'immagine utilizzata come anteprima selezionabile nel layout della mappa. Facendo clic sull'anteprima viene eseguito il reindirizzamento all'URL impostato con il parametro logolink.
  • logolink: URL del sito Web esterno o della risorsa Web. Facendo clic sull'immagine di anteprima impostata con il parametro logoimage viene eseguito il reindirizzamento all'URL impostato in logolink.

Esempio di una mappa incorporata con un tema scuro, legenda, visualizzazione riquadro al caricamento, pulsanti di zoom in alto a destra e immagine del logo collegato a una pagina Web.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

Esempio di una mappa incorporata con legenda, dettagli, dettagli come la scheda attiva nel riquadro e popup visualizzati nel riquadro laterale della scheda informazioni.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

Mappatura

I seguenti parametri controllano la navigazione della mappa e la visibilità degli elementi di mappatura:

  • webmap: ID della mappa Web da visualizzare all'interno del map viewer incorporato, ad esempio webmap=432a8d7ca22d4b5b859e0bdaa30ae118. Il parametro webmap è obbligatorio.
  • extent: specifica l'estensione da utilizzare quando la mappa viene caricata. Questo sostituisce l'estensione predefinita della mappa. Solo i valori del sistema di coordinate geografiche sono validi.
  • center: consente di centrare la mappa utilizzando coordinate geografiche (x,y).
  • level: l'ID livello della scala memorizzata nella cache come elencato nell'endpoint REST della mappa di base. Determina il livello di zoom predefinito quando la mappa viene caricata, ad esempio level=9.
  • zoom: quando l'opzione è impostata su true, vengono visualizzati i pulsanti zoom avanti e zoom indietro. La loro posizione nella mappa può essere controllata dal parametro zoom_position.
  • home: quando è impostata su true, viene visualizzato il pulsante Home. Il pulsante Home viene utilizzato per tornare all'estensione predefinita della mappa. Se extent è impostata, il pulsante Home utilizza questa estensione anziché l'estensione predefinita della mappa. Il parametro home è valido solo se anche zoom è impostato su true.
  • scale: quando l'opzione è impostata su true, viene visualizzata la barra di scala. La barra di scala viene visualizzata nell'angolo inferiore sinistro della mappa.
  • disable_scroll: quando l'opzione è impostata su true, l'operazione di scorrimento del mouse per lo zoom è disabilitata. L'impostazione predefinita è true.
  • marker: colloca un'immagine desiderata come un simbolo marcatore con un popup nella mappa in corrispondenza di una posizione scelta. La sintassi è marker=longitude;latitude;wkid;description;URL;title. Sono richiesti longitudine e latitudine; gli altri valori sono opzionali. I valori descrizione e titolo devono essere codificati nell'URL. Lasciare il valore opzionale vuoto se non si desidera includerlo. come nell'esempio seguente:
    marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
  • basemap_toggle: viene visualizzato il pulsante di attivazione/disattivazione della mappa di base. Deve essere impostata su true per utilizzare alt_basemap.
  • alt_basemap: controlla quale mappa di base viene utilizzata come mappa di base alternativa nell'attivazione/disattivazione mappa di base. Il parametro basemap_toggle deve essere impostato su true per utilizzare alt_basemap. Se non è specificata una mappa di base alternativa, viene utilizzata la mappa di base satellitare. Valori validi sono streets, satellite, hybrid, topo, gray, oceans, national-geographic, osm, terrain, e dark-gray.

Esempio di mappa incorporata con estensione personalizzata, pulsanti di zoom disabilitati, barra di scala presente, zoom tramite scorrimento del mouse e galleria di mappe di base.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

Esempio di mappa incorporata con centro, livello di scala zoom, pulsante Home e attivazione/disattivazione mappa di base con una mappa di base alternativa.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

Ricerca feature e posizione (ricerca geografica)

I seguenti parametri consentono di ricercare e individuare dati nella mappa:

  • search: quando l'opzione è impostata su true, viene visualizzato il widget di ricerca. Questo widget supporta la ricerca attraverso servizi di geocodifica e layer in cui effettuare ricerche. Il parametro search deve essere impostato come true per utilizzare find per i layer in cui effettuare ricerche nella mappa.
  • searchextent: quando l'opzione è impostata su true, una ricerca geografica tramite il widget di ricerca restituisce risultati che sono contenuti all'interno dell'estensione predefinita della mappa.
  • find: apre la mappa in corrispondenza di una posizione specifica. Il parametrofind può essere utilizzato per eseguire ricerche per indirizzi o luoghi (geocodifica) o per ricercare valori di campo degli attributi da un layer in cui effettuare ricerche. Questo parametro restituisce i risultati da tutte le risorse di ricerca cui la mappa può accedere. Se i valori del layer in cui effettuare ricerche sono simili ai valori di geocodifica, questo può generare risultati fuorvianti. Ad esempio, la ricerca di codici FIPS di cinque cifre dal campo di un layer in cui effettuare ricerche può essere confusa con la ricerca di codici postali degli Stati Uniti e restituire più risultati non desiderati. Valutare l'utilizzo di feature per la ricerca di feature anziché find in scenari come questo o quando è richiesto un controllo più preciso sui risultati.
  • feature: consente di ricercare una feature specifica in un feature layer ricercabile. Trova posizioni per layer deve essere impostato sulla mappa per un campo in cui effettuare ricerche. La sintassi è feature=layerID;searchfield;searchvalue, ad esempio feature=CentralIndianaCities_634;PLACEFIPS;05860.

    Il seguente URL fa riferimento all'esempio delle città dell'Indiana precedente e può essere utilizzato per rilevare l'ID layer del layer desiderato nella mappa. Avviso id:CentralIndianaCities_634 in operationalLayers. Sostituire l'ID webmap con l'ID della mappa Web per trovare l'ID layer.

    https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

Esempio di una mappa incorporata che include la ricerca, un'estensione ricerca e che si apre in una posizione specifica.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

Esempio di una mappa incorporata che si apre in una feature specifica.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860