Usar parámetros de URL para crear y modificar mapas

Un mapa creado con Visor de mapas o Map Viewer Classic 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 biomas y ecorregiones.

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer&url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/Resolve_Ecoregions/FeatureServer

Ver este ejemplo en Visor de mapas

Por ejemplo, puede utilizar una URL de Visor de mapas 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 Visor de mapas. 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

La URL siempre comienza por https://www.arcgis.com/apps/mapviewer/index.html? en Visor de mapas y https://www.arcgis.com/home/webmap/viewer.html? en Map Viewer Classic e incluye uno o más de los parámetros de consulta enumerados 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.

Vea el siguiente ejemplo:

https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=8

Ver este ejemplo en Visor de mapas

Nota:

Si alguno de los recursos del parámetro de la dirección URL se proporciona como HTTP, debe reemplazar HTTP por HTTPS en la URL y hacer que todos los recursos sean accesibles solo usando HTTPS.

Codificar los parámetros de la consulta

Todos los parámetros de la consulta deben estar codificados. La codificación de la dirección URL garantiza que los caracteres que se envían a ArcGIS Online son válidos. 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://services.arcgisonline.com/ArcGIS/rest/services/Ocean/World_Ocean_Base/MapServer

He aquí el mismo parámetro codificado:

basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean%2FWorld_Ocean_Base%2FMapServer

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

urls=https%3A%2F%2Fmaps.ngdc.noaa.gov%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; por ejemplo, https://www.urlencoder.io/. Para facilitar la lectura, el resto de los ejemplos de este tema no están codificados. Haga clic en el vínculo Ver este ejemplo en Map Viewer después del ejemplo para ver la URL codificada en un navegador web.

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 este ejemplo, se abrirá un mapa web con un Id. 75a3ce8990674a5ebd5b9ab66bdab893 en Visor de mapas:

https://www.arcgis.com/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

Ver este ejemplo en Visor de mapas

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://www.arcgis.com/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 este ejemplo, Visor de mapas se abre con OpenStreetMap utilizado como mapa base:

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

Ver este ejemplo en Visor de mapas

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 9e2f2b544c954fda9cd13b7f3e6eebce presente en el mapa:

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

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, Visor de mapas se abre con la capa de del mapa base de imágenes del mundo presente y la capa de referencia establecida en la capa de límites y lugares del mundo:

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer

En este ejemplo, Visor de mapas 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/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer

Ver este ejemplo en Visor de mapas

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

Vea el siguiente ejemplo:

https://www.arcgis.com/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

Ver este ejemplo en Visor de mapas

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

Vea el siguiente ejemplo:

https://www.arcgis.com/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

Ver este ejemplo en Visor de mapas

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

Vea el siguiente ejemplo:

https://www.arcgis.com/apps/mapviewer/index.html?url=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/USGS_Seismic_Data_v1/FeatureServer

Ver este ejemplo en Visor de mapas

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

Vea el siguiente ejemplo:

https://www.arcgis.com/apps/mapviewer/index.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4&extent=-108,40,-85,31

Ver este ejemplo en Visor de mapas

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 sus números usan comas como decimales.

Nota:

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

Consulte el ejemplo de coordenadas geográficas siguiente:

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

Ver este ejemplo en Visor de mapas

Consulte el ejemplo de coordenadas proyectadas siguiente:

https://www.arcgis.com/apps/mapviewer/index.html?center=500000,5500000,102100&level=4

Ver este ejemplo en Visor de mapas

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 sus números usan comas como decimales.

Consulte el ejemplo de coordenadas geográficas siguiente:

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

Ver este ejemplo en Visor de mapas

Consulte el ejemplo de coordenadas proyectadas siguiente:

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

Ver este ejemplo en Visor de mapas

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, la subcapa 3 está visible, pero otras subcapas no lo están:

Nota:
La numeración de la subcapa comienza con (0) como se muestra en el extremo REST.
https://www.arcgis.com/apps/mapviewer/index.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania

Ver este ejemplo en Visor de mapas

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 la ciudad o el país), nombres de lugares, coordenadas de latitud-longitud y entidades en capas que permiten búsquedas (por ejemplo. 1916352001 para un número de identificación (PIN) de parcela).

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

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

Ver este ejemplo en Visor de mapas

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://www.arcgis.com/apps/mapviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon

Ver este ejemplo en Visor de mapas

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.
  • Debe 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 sus números usan comas 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:

Actualmente, esta funcionalidad solo se admite en Map Viewer Classic. Estará disponible en una versión futura de 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. 8505192e747d440098523e9e64419710 en Map Viewer Classic, pero el panel Detalles está oculto:

https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true

Ver este ejemplo en Map Viewer Classic