Usar parámetros de direcciones URL para modificar los mapas integrados

Nota:

Actualmente, esta funcionalidad solo se admite en Map Viewer Classic. Estará disponible en una versión futura de Visor de mapas.

Map Viewer Classic proporciona código HTML fácil de usar para integrar un mapa en un sitio web. Es posible elegir las opciones que desea incluir en el mapa, como un botón de inicio, un control de zoom y una leyenda, que se agregan al código que se copia y se pega en el sitio web. Otra forma de agregar estas opciones es usar parámetros de dirección URL.

La dirección URL del mapa integrado siempre empieza con la dirección URL de su organización o del sitio público (https://www.arcgis.com) y /apps/Embed/index.html?webmap=<your web map ID>. A continuación, encontrará un ejemplo:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

La dirección URL también puede incluir uno o varios de los parámetros que se enumeran a continuación. Algunos parámetros de dirección URL modifican el comportamiento del mapa integrado, mientras que otros modifican las funciones que están disponibles en él. Para incluir más de un parámetro, use el símbolo “&” para separar los parámetros. A continuación, encontrará un ejemplo:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

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.

Diseño

Los siguientes parámetros permiten controlar el aspecto y el funcionamiento del mapa.

  • theme: determina el tema de color aplicado al panel lateral y a los botones. Las opciones válidas son light o dark.
  • legend: cuando se define como true. aparece una leyenda en el panel lateral que muestra las capas del mapa.
  • details: cuando se define como true, aparece un texto de descripción del mapa en el panel lateral.
  • active_panel: define la pestaña que está activa en el panel lateral cuando se carga el mapa. Las opciones válidas son legend o details. El parámetro legend o details se debe definir como true si se usa como valor para el parámetro active_panel.
  • show_panel: cuando se define como true, se muestra el panel lateral al cargar el mapa. El valor predeterminado es false.
  • popup_sidepanel: cuando se define como true, la información emergente se presenta en la pestaña de información del panel lateral en lugar de hacerlo en el mapa.
  • zoom_position: determina la ubicación de los botones de control del zoom. Las opciones válidas son top-left (predeterminada), bottom-left, top-right o bottom-right. Si el parámetro home se ha definido como true, el botón de inicio también se mueve en función del valor del parámetro zoom_position.
  • logoimage: dirección URL de una imagen que se usa como vista en miniatura en la que se puede hacer clic en el diseño de mapa. Al hacer clic en la vista en miniatura, la aplicación redirige a la dirección URL definida con el parámetro logolink.
  • logolink: dirección URL de un sitio web externo o un recurso web. Al hacer clic en la imagen en miniatura definida con el parámetro logoimage, la aplicación redirige a la dirección URL definida en logolink.

Ejemplo de un mapa integrado con tema oscuro, leyenda, panel mostrado al cargar, botones de zoom en la esquina superior derecha e imagen de logotipo vinculada a una página web.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

Ejemplo de un mapa integrado con leyenda, detalles como la pestaña activa del panel y ventanas emergentes que se muestran en el panel lateral de la pestaña de información.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

Representación cartográfica

Los parámetros siguientes controlan la navegación por el mapa y la visibilidad de los elementos de representación cartográfica:

  • webmap: Id. del mapa web que se debe mostrar dentro del visor de mapas integrado, por ejemplo, webmap=432a8d7ca22d4b5b859e0bdaa30ae118. El parámetro webmap es obligatorio.
  • extent: especifica la extensión que se debe usar cuando se carga el mapa. Esto anula la extensión predeterminada del mapa. Solo son válidos los valores del sistema de coordenadas geográficas.
  • center: centra el mapa usando coordenadas geográficas (x,y).
  • level: el Id. de nivel de la escala incluida en la caché tal y como aparece en el extremo REST del mapa base. Esto determina el nivel de zoom predeterminado cuando se carga el mapa, por ejemplo, level=9.
  • zoom: cuando se define como true, se muestran los botones para acercar y alejar. Su ubicación en el mapa se puede controlar con el parámetro zoom_position.
  • home: cuando se define como true, se muestra el botón de inicio. El botón de inicio se usa para volver a la extensión predeterminada del mapa. Si se ha definido extent, el botón de inicio usa esa extensión en lugar de la extensión predeterminada del mapa. El parámetro home solo es válido si zoom se ha definido también como true.
  • scale: cuando se define como true, se muestra la barra de escala. La barra de escala aparece en la esquina inferior izquierda del mapa.
  • disable_scroll: cuando se define como true, se deshabilita el desplazamiento del ratón para usar el zoom. El valor predeterminado es true.
  • marker: inserta la imagen deseada como símbolo de marcador con una ventana emergente en la ubicación deseada del mapa. La sintaxis es marker=longitude;latitude;wkid;description;URL;title. La longitud y la latitud son obligatorias; los otros valores son opcionales. Los valores de descripción y título se deben codificar en la dirección URL. Deje un valor en blanco si no desea incluirlos. A continuación, encontrará un ejemplo:
    marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
  • basemap_toggle: se muestra el botón para alternar el mapa base. Se debe definir como true para usar alt_basemap.
  • alt_basemap: controla el mapa base que se usa como mapa base alternativo en el botón para alternar el mapa base. El parámetro basemap_toggle se debe definir como true con el fin de usar alt_basemap. Si no se especifica ningún mapa base alternativo, se usa el mapa base de satélite. Los valores válidos son streets, satellite, hybrid, topo, gray, oceans, national-geographic, osm, terrain y dark-gray.

Ejemplo de un mapa integrado con extensión personalizada, botones de zoom deshabilitados, barra de escala, desplazamiento de ratón para el zoom habilitado y galería de mapas base.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

Ejemplo de un mapa integrado con centro, nivel de escala de zoom, botón de inicio y botón para alternar el mapa base con un mapa base alternativo.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

Búsqueda de entidades y ubicaciones (geobúsqueda)

Los parámetros siguientes buscan y encuentran datos en el mapa:

  • search: cuando se define como true, se muestra el widget de búsqueda. Este widget permite buscar en capas de búsqueda y de geocodificación. El parámetro search se debe definir como true con el fin de usar find para las capas del mapa que admiten búsquedas.
  • searchextent: cuando se define como true, una geobúsqueda mediante el widget de búsqueda devuelve resultados que están contenidos en la extensión predeterminada del mapa.
  • find: abre el mapa en una ubicación predeterminada. El parámetro find se puede usar para buscar por direcciones o lugares (geocodificación) o para buscar valores de campos de atributos en una capa que admita búsquedas. Este parámetro devuelve resultados de todos los recursos de búsqueda a los que el mapa tiene acceso. Si los valores de su capa de búsqueda son similares a los valores de geocodificación, los resultados podrían ser engañosos. Por ejemplo, buscar códigos FIPS de cinco dígitos en un campo de una capa que admite búsquedas se podría confundir con la búsqueda de códigos postales de EE. UU. y se devolverían varios resultados no deseados. Considere la posibilidad de usar feature para la búsqueda de entidades en lugar de find en situaciones como la anterior o cuando se necesita un control más detallado sobre los resultados.
  • feature: permite buscar una entidad concreta dentro de una capa de entidades que admita búsquedas. Buscar ubicaciones por capa se debe configurar en el mapa para un campo que admita búsquedas. La sintaxis es feature=layerID;searchfield;searchvalue, por ejemplo, feature=CentralIndianaCities_634;PLACEFIPS;05860.

    Las siguientes direcciones URL hacen referencia al ejemplo de ciudades del centro de Indiana ya citado y se pueden usar para determinar el Id. de la capa deseada del mapa. Puede ver id:CentralIndianaCities_634 en operationalLayers. Reemplaza el Id. de webmap con el de su mapa web para buscar el Id. de su capa.

    https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

Ejemplo de un mapa incrustado que incluye una búsqueda y una extensión de búsqueda y se abre en una ubicación concreta.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

Ejemplo de un mapa integrado que se abre en una entidad concreta.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860