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, 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.
myportal.domain.com/arcgis/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
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
La URL siempre comienza por el nombre completo de ArcGIS Enterprise y el contexto del adaptador web o del equilibrador de carga, más apps/mapviewer/index.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, 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://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=8
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/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%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 Visor de mapas, use webmap= y el Id. exclusivo del mapa.
En este ejemplo, se abrirá un mapa web con un Id. 75a3ce8990674a5ebd5b9ab66bdab893 en Visor de mapas:
https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893
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 este ejemplo, Visor de mapas se abre con OpenStreetMap utilizado como mapa base:
https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce
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://myportal.domain.com/arcgis/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://myportal.domain.com/arcgis/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
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://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3
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://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2
El parámetro url= acepta una sola dirección URL de capa.
Vea el siguiente 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=.
Vea el siguiente ejemplo:
https://myportal.domain.com/arcgis/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,31,-85,40
A partir de la versión ArcGIS 10.5, puede utilizar la operación de ?layers en un servicio de entidades. Vea el siguiente 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 Visor de mapas cuando se utiliza el parámetro 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://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4
Consulte el ejemplo de coordenadas proyectadas siguiente:
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 sus números usan comas como decimales.
Consulte el ejemplo de coordenadas geográficas siguiente:
https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06
Consulte el ejemplo de coordenadas proyectadas siguiente:
https://myportal.domain.com/arcgis/apps/mapviewer/index.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, la subcapa 3 está visible, pero otras subcapas no lo están:
https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania
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:
- 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.