Usar parámetros de URL para crear y modificar mapas

Un mapa creado en un portal de ArcGIS Enterprise 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.

Además, para crear mapas con Visor de mapas o Map Viewer Classic, puede crear y modificar mapas directamente con parámetros de URL.

Por ejemplo, puede crear un mapa con parámetros de URL que muestren bancos de la costa de Maryland.

myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer&url=https://services5.arcgis.com/9cBkZtsx7PSOoaCF/arcgis/rest/services/Maryland_Shoals/FeatureServer/0

Puede crear un mapa con parámetros de URL que muestren parques eólicos terrestres del Reino Unido en Map Viewer Classic.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=https%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

Por ejemplo, puede utilizar una URL de Map Viewer en las siguientes circunstancias:

  • Si no necesita incluir muchas capas operativas o de referencia y no necesita aplicar estilos específicos al contenido del mapa, utilice una URL para abrir uno de los Map Viewer. Por ejemplo, si su sitio web permite a los usuarios buscar una dirección o ver una sola capa relacionada con su sitio, puede incluir un vínculo en el sitio web que abra Visor de mapas con el mapa base especificado y la capa individual necesaria.
  • Debe vincular a un mapa web guardado desde un sitio web o correo electrónico. Puede usar una dirección URL que abra el mapa web concreto.

Qué incluir en la URL

En Map Viewer Classic, la URL siempre comienza por la URL de la página de inicio del portal de ArcGIS Enterprise, además de /webmap/viewer.html? y uno o varios de los parámetros de consulta de la siguiente lista. En Visor de mapas, la URL siempre empieza por el contexto de Web Adaptor o equilibrador de carga y el nombre totalmente calificado de ArcGIS Enterprise, más apps/mapviewer/index.html? y uno o varios de los parámetros de consulta que se indican a continuación. Para incluir más de un parámetro, use el símbolo “&” para separar los parámetros. En esta página, encontrará ejemplos del uso de varios parámetros.

El primer ejemplo a continuación abre Visor de mapas; el segundo abre Map Viewer Classic:

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

https://myportal.domain.com/arcgis/apps/mapviewer/index.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, use 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 una URL garantiza que se envíen caracteres válidos al 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=https%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%2Chttps%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

Internet tiene muchos sitios y herramientas gratuitos para generar 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 Visor de mapas o Map Viewer Classic, use webmap= y el Id. único del mapa.

En el primer ejemplo, se abrirá un mapa web con un Id. 8505192e747d440098523e9e64419710 en Map Viewer Classic. La segunda URL abre el mismo mapa en Visor de mapas.

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

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8505192e747d440098523e9e64419710

En este ejemplo, se abrirá un mapa web con un Id. 29990ur6423j1180p53f9t30019491 en Visor de mapas con la extensión definida en -117.996342,33.841078,-117.993692,33.844375:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375

Definir el mapa base

Para definir el mapa base, establezca basemapUrl= en la capa. Si no se ha definido ningún mapa base, se utiliza el mapa base predeterminado, que es el Topográfico mundial.

En la primer URL de ejemplo, Visor de mapas se abre con el mapa físico mundial utilizado como mapa base. La segunda URL de ejemplo lo abre en Map Viewer Classic.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

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

En este ejemplo, Visor de mapas se abre con el mapa físico mundial utilizado como mapa base y una capa operativa con el Id. de elemento d35a5w4bo77593y0358s0x7312jpp04 presente en el mapa:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=d35a5w4bo77593y0358s0x7312jpp04

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.

En este ejemplo, Map Viewer Classic se abre con la capa de imágenes del mapa de imágenes del mundo presente y el mapa base establecido en la capa de límites y lugares del mundo:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

Definir las capas operativas

Para definir las capas operativas superpuestas sobre el mapa base, utilice webmap=, layers=, layerIds=, url= o urls=. Si la capa es un elemento del sitio web, utilice layers= para obtener todas las configuraciones de capa. Para agregar subcapas individuales de una capa de entidades que contiene varias subcapas, utilice layerIds=. 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>).

El primer ejemplo se abre en Visor de mapas. El segundo se abre en Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

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

El parámetro layerIds= admite un solo Id. de capa o varios Id. de capa. Si una capa de entidades contiene varias subcapas, utilice el parámetro layerIds= para agregar subcapas individuales. Para varias subcapas, utilice una lista de Id. separados por comas (&layerIds=0,1,2).

El primer ejemplo se abre en Visor de mapas. El segundo se abre en Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2
https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

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

La primera URL abre el mapa en Visor de mapas. La segunda URL se abre en Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.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

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:

https://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 Classic 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 en Visor de mapas:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4

Ejemplo de coordenadas geográficas en Map Viewer Classic:

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

Ejemplo de coordenadas proyectadas en Visor de mapas:

https://myportal.domain.com/arcgis/apps/mapviewer/index.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 en Visor de mapas:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Ejemplo de coordenadas proyectadas en Visor de mapas:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Ejemplo de coordenadas proyectadas en Map Viewer Classic:

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 subcapas de una capa que abra en el mapa, utilice layers=show:.

En este ejemplo, las subcapas 1 y 2 de la capa Parcels están visibles en Map Viewer Classic, pero otras subcapas no lo están:

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 inmediatamente tras 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 admite direcciones de una sola línea, direcciones parciales (por ejemplo, solo ciudad o solo país), nombres de lugar y coordinadas de latitud-longitud.

En el ejemplo siguiente se utiliza una dirección de una sola línea en Visor de mapas:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?find=380 new york st,redlands,ca
Sugerencia:

Para encontrar una ubicación o una entidad en una capa que admita búsquedas, puede incluir el parámetro webmap= con el Id. único del mapa.

Agregar un punto

Para agregar un punto al mapa, utilice marker=<x>,<y>. También puede incluir las siguientes propiedades opcionales:

  • <wkid>: referencia espacial de las coordenadas x,y que se van a agregar 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.

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

Consideraciones

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

  • En Map Viewer Classic, el punto se agrega a una capa de notas de mapa nueva en la ubicación de las coordenadas x,y especificada.
  • Las coordenadas de <x>,<y> deben agregar un punto.
  • 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 otra propiedad opcional, agregue la etiqueta como el sexto parámetro con valores vacíos para el resto (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.

Ocultar el panel Detalles

Nota:

Esta funcionalidad actualmente solo es compatible con Map Viewer Classic (anteriormente conocido como Map Viewer). Estará disponible en una versión futura del nuevo Visor de mapas.

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

En este ejemplo, se abre un mapa web guardado con el Id. b487d81007294fb5a0be9e10a411f2d0 en Map Viewer Classic, pero el panel Detalles está oculto:

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