Parámetros de direcciones URL para modificar mapas

Un mapa creado con el visor de mapas de 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 además elementos interactivos, como una galería de mapas base que te permite alternar entre mapas como imágenes y calles, además de herramientas de medición, ventanas emergentes que muestran los atributos de una entidad específica y botones para reproducir los datos en el tiempo.

Como alternativa a la creación de mapas con el visor de mapas, puedes 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 Portal for ArcGIS página inicial, 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 mapa guardado

Para abrir un mapa guardado que se haya creado con el visor de mapas, usa 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, establece 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 la capa de referencia

Para incluir una capa de referencia en el mapa base, establece 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 capas operacionales

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

El parámetro layers= acepta un único Id. de elemento o varios Id. de elemento. Para varias capas, utiliza 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

Utiliza urls= para incluir más de una capa. Separa 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, incluye 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

Centrar el mapa

Para centrar el mapa en una ubicación particular, establece 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.

Ejemplo de coordenadas geográficas:

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

Ejemplo de coordenadas proyectadas:

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

Definir el nivel de escala

Para definir el nivel de escala del visor de mapas, utiliza los parámetros center y level=. El parámetro level acepta el Id. del nivel de la escala de caché que se incluye en el extremo del servicio REST. El nivel de escala de caché se puede determinar utilizando la información en el extremo REST del servicio de mapas. La resolución está relacionada de manera inversa con la escala.

La escala se establece automáticamente al utilizar los parámetros webmap o find; level se pasa por alto. Si utilizas el parámetro webmap, el mapa se acerca automáticamente hasta la extensión completa del mapa. Si utilizas el parámetro find, el mapa se acerca automáticamente hasta la mejor extensión de la ubicación encontrada.

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 extensión

Para definir la extensión del mapa, utiliza 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

Definir la visibilidad de capa

Para establecer la visibilidad de las capas en el mapa, utiliza 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 ubicación o entidad para abrir el mapa

Para buscar una ubicación o entidad utilizada para abrir el mapa, usa 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

Añadir 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

• <x>,<y> son obligatorios.
• Asegúrate de codificar los parámetros title, icon y label.
• Debes 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 deseas que el mapa se acerque (además de centrarse en el punto), incluye el parámetro level=.
• Puedes 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 visor de mapas, utiliza mapOnly=true.

Por ejemplo:

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