Usar parámetros de direcciones URL para modificar los mapas

Un mapa creado con el Map Viewer contiene un mapa base, capas de datos, una extensión, una leyenda y herramientas de navegación, como desplazamiento panorámico, zoom, buscadores de lugares y marcadores. Muchos mapas contienen también elementos interactivos como una galería de mapas base, herramientas de medición, elementos emergentes y botones para reproducir los datos a lo largo del tiempo.

Como alternativa a la creación de mapas con el Map Viewer, puede crear y modificar mapas directamente con parámetros de dirección URL.

Por ejemplo, así es como se crearía un mapa con parámetros de dirección URL que muestra los parques eólicos terrestres del Reino Unido.

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

Qué incluir en la URL

La dirección URL siempre empieza por la página de inicio del portal de ArcGIS Enterprise, más /webmap/viewer.html? y uno o más de los parámetros de consulta que se enumeran a continuación. Para incluir más de un parámetro, utilice una Y comercial (&) para separar los parámetros.

Por ejemplo:

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

Si alguno de los recursos del parámetro de la dirección URL se proporciona como HTTP, la dirección URL del mapa debe ser también HTTP. Para mayor seguridad, debe usar una dirección URL HTTPS, si es posible.

Codificar los parámetros de la consulta

Todos los parámetros de la consulta deben estar codificados. La codificación de la URL garantiza que se envíen caracteres válidos al sitio web del portal. La codificación reemplaza los caracteres no válidos por % seguido por su equivalente hexadecimal.

Por ejemplo, aquí puede verse un parámetro de URL no codificado:

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

He aquí el mismo parámetro codificado:

basemapUrl=http%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

Los parámetros dentro de parámetros también deben estar codificados, por ejemplo:

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

La web tiene muchos sitios y herramientas gratuitos para generar direcciones URL codificadas. Para facilitar la lectura, el resto de los ejemplos de este tema no están codificados.

Abrir un mapa guardado

Para abrir un mapa guardado que se haya creado con el Map Viewer, use webmap= y el Id. exclusivo del mapa.

Por ejemplo:

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

Definir el mapa base

Para definir el mapa base, establezca basemapUrl= en la capa. Si un mapa base no está definido, el mapa base predeterminado será el mapa base topográfico mundial.

Por ejemplo:

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

Incluir una capa de referencia

Para incluir una capa de referencia en el mapa base, establezca basemapReferenceUrl= en la capa. Se debe utilizar el parámetro basemapReferenceUrl= además del parámetro basemapUrl.

Por ejemplo:

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

Definir las capas operativas

Para definir las capas operacionales superpuestas sobre el mapa base, utilice webmap=, layers=, url= o urls=. Si la capa es un elemento del sitio web, utilice layers= para obtener todas las configuraciones de capa. Si la capa no está en el sitio web, utilice url= o urls=.

El parámetro layers= acepta un único Id. de elemento o varios Id. de elemento. Para varias capas, utilice una lista de Id. separados por comas (&layers=<itemID>,<itemID>,<itemID>).

Por ejemplo:

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

El parámetro url= acepta una sola dirección URL de capa.

Por ejemplo:

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

Utilice urls= para incluir más de una capa. Separe las capas con una coma. La extensión del mapa se basa en la última capa de la lista o en la más lenta en cargarse. Para aplicar el zoom a una extensión específica, incluya el parámetro extent=.

Por ejemplo:

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 partir de la versión ArcGIS 10.5, puede utilizar la operación de ?layers en un servicio de entidades.

Por ejemplo:

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

Definir el nivel de escala y centrar el mapa

La escala se establece automáticamente para un mapa en Map Viewer al utilizar los parámetros webmap o find. Si utiliza el parámetro webmap, el mapa se acerca automáticamente hasta la extensión completa del mapa, a menos que se utilicen otros parámetros de la URL, por ejemplo, level y center o extent para invalidar la escala del mapa web. Si utiliza el parámetro find, el mapa se acerca automáticamente hasta la mejor extensión de la ubicación encontrada.

Para definir un nivel de escala específico, utilice los parámetros center y level. El parámetro level acepta el Id. del nivel de la escala de memoria caché que se incluye en el extremo del servicio REST del mapa base de teselas. La resolución está relacionada de manera inversa con la escala. El parámetro level solo es compatible con mapas base de teselas, no con mapas base creados a partir de servicios de mapas dinámicos ni con otros datos que no contienen teselas.

Para centrar el mapa en una ubicación particular, establezca center utilizando coordenadas geográficas (x,y) o coordenadas proyectadas (x,y,WKID). Puede utilizar la coma o el punto y coma como separadores. Use el punto y coma si los números usan los dos puntos como decimales.

Nota:

Los parámetros level y center se deben utilizar juntos. El parámetro level se ignora si se utiliza solo.

Ejemplo de coordenadas geográficas:

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

Ejemplo de coordenadas proyectadas:

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

Definir la extensión

Para definir la extensión del mapa, utilice extent. El parámetro extent acepta coordenadas geográficas (GCS) como MinX, MinY, MaxX, MaxY o coordenadas proyectadas (PCS) como valores MinX, MinY, MaxX, MaxY, WKID. Puede utilizar la coma o el punto y coma como separadores. Use el punto y coma si los números usan los dos puntos como decimales.

Ejemplo de coordenadas geográficas:

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

Ejemplo de coordenadas proyectadas:

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

Establecer la visibilidad de la capa

Para establecer la visibilidad de las capas en el mapa, utilice layers=show:.

Por ejemplo:

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

Buscar una ubicación o entidad para abrir el mapa

Para buscar una ubicación o entidad utilizada para abrir el mapa, use find. El mapa se amplía automáticamente hasta la coincidencia más próxima y se añade un marcador de llamada al mapa. El parámetro find acepta direcciones en una sola línea, direcciones parciales (como, por ejemplo, solo la ciudad o el país), nombres de lugares y coordenadas de latitud-longitud.

En el ejemplo siguiente se utiliza una dirección de una sola línea.

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

Agregar un punto

Para agregar un punto al mapa, utilice marker=<x>,<y>. El punto se agrega a una capa de notas de mapa nueva en la ubicación x,y especificada. También puede incluir las siguientes propiedades opcionales:

  • <wkid>– Referencia espacial de las coordenadas x,y agregadas al mapa. Si no incluye un WKID, se utilizarán las coordenadas GCS.
  • <encoded title>– Título de la ventana emergente del punto. Si no incluye un título, la ventana emergente estará vacía.
  • <encoded icon URL>– Símbolo del punto. Si no incluye un símbolo, se utilizará un símbolo de marcador azul.
  • <encoded label>– Etiqueta situada junto al símbolo de punto.

Consideraciones

Tenga en cuenta lo siguiente al agregar un punto al mapa:

  • <x>,<y> son obligatorios.
  • Asegúrese de codificar los parámetros title, icon y label.
  • Debe agregar las propiedades en este orden: marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
  • Puede utilizar la coma o el punto y coma como separadores. Use el punto y coma si los números usan los dos puntos como decimales.
  • Utilice valores vacíos. No utilice espacios. Por ejemplo, para especificar una etiqueta y ninguna de las demás propiedades opcionales, agrega la etiqueta como el sexto parámetro con valores vacíos para lo demás (x;y;;;;label).
  • Si desea que el mapa se acerque (además de centrarse en el punto), incluya el parámetro level.
  • Puede editar y guardar la capa de notas del mapa como un mapa o elemento.
  • Las cuentas de organización pueden utilizar el punto para obtener direcciones y realizar análisis.

Ejemplo

En el ejemplo siguiente se utilizan separadores de punto y coma:

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

Ocultar el panel Detalles

Para ocultar el panel Detalles del Map Viewer, utilice mapOnly=true.

Por ejemplo:

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