Widget Mapa

El widget Mapa permite mostrar información geográfica 2D y 3D. Puede habilitar herramientas en el mapa, como por ejemplo Acercar, Localizar, Buscar y Medir.

Ejemplos

Use este widget para apoyar los requisitos de diseño de la aplicación como por ejemplo los siguientes:

  • Necesita mostrar la comparación de un mapa en 2D y 3D. Puede agregar dos widgets Mapa y crear un desencadenador y acción para sincronizar vistas al interactuar con cualquier mapa.
  • Desea hacer clic en una entidad en el mapa y visualizar el registro en un widget Información de entidades.
  • Tiene el requisito de filtrar un widget Lista en función de un clic en una entidad del mapa.

Notas de uso

Puede mostrar un único mapa o incluir la opción para cambiar entre dos mapas. Puede incluir varios mapas en una aplicación agregando más widgets Mapa.

El widget Mapa requiere una fuente de datos, incluyendo mapas web y escenas web. Si incluye herramientas, estas se colocan automáticamente en el mapa en función del tamaño del widget tanto en el modo diseño como en la aplicación final.

Sugerencia:

Si tiene un mapa web o una escena web con varias capas y desea designar las capas que se muestran de forma predeterminada en distintos widgets Mapa, puede agregar el mismo mapa web o escena web varias veces en la pestaña Datos, optar por ocultar distintas subcapas en cada copia del mapa o de la escena, y conectar cada copia a un widget Mapa distinto.

Más información sobre cómo configurar la visibilidad de la capa desde un mapa y utilizarlo con distintos widgets de Mapa

Configuración

El widget Mapa incluye estos ajustes:

  • Seleccionar mapa: agregue una fuente de datos para mapas web y escenas web.
  • Vista inicial: establezca la posición inicial del mapa cuando se carga en el widget.
    • Predeterminada: utilice la posición del mapa heredada del mapa web o de la escena web.
    • Personalizado: modifique la vista inicial creando una posición personalizada para el mapa.
  • Herramientas: incluya herramientas para que los usuarios interactúen con el mapa.
    • Zoom: acerque o aleje el mapa.
    • Inicio: acerque el mapa a la posición inicial del mapa (extensión).
    • Navegación: incluya herramientas de desplazamiento y rotación de mapas. Estas herramientas aparecen cuando el widget Mapa muestra una escena web en 3D.
    • Localizar: muestre la ubicación actual del usuario.
    • Brújula: indique dónde se encuentra el norte en relación con la vista actual de un mapa 2D o 3D.
    • Buscar: busque ubicaciones basadas en un servicio de geocodificación desde su organización o portal. Si activa los elementos emergentes, aparecen elementos emergentes para los resultados de la búsqueda.
    • Capas: muestre una lista de capas y símbolos en el mapa y permita que los usuarios las activen o desactiven.
    • Mapa base: muestre una galería de mapas base.
    • Medir: incluya herramientas de medición para medir área y distancia. La herramienta Medir utiliza alineación: el puntero se alinea a las entidades del mapa. Durante la medición, los usuarios pueden mantener pulsada la tecla Ctrl para desactivar temporalmente la función de alineación.
    • Pantalla completa: muestre el mapa usando toda la pantalla.
    • Barra de escala: incluya una barra de escala en el mapa que muestre unidades en valores métricos o no métricos y responda dinámicamente a varios sistemas de coordenadas.
    • Seleccionar: seleccione entidades en el mapa utilizando diferentes herramientas y modos de selección. Los usuarios tienen acceso a las siguientes herramientas de selección y pueden seleccionar entidades que están completamente contenidas parcial o completamente por los polígonos o existentes dentro de polígonos dibujados.
      • Rectángulo: haga clic y arrastre para dibujar un rectángulo a través de entidades.
      • Lazo: haga clic en el mapa para crear los vértices de un polígono, o dibuje con el puntero para crear una forma a mano alzada. Haga doble clic para cerrar el polígono y seleccionar entidades contenidas.
      • Círculo: haga clic y arrastre para dibujar un círculo a través de entidades.
      • Línea: haga clic en el mapa para crear los vértices de una línea. Haga doble clic para finalizar la línea y seleccionar entidades intersecantes.
      • Punto: haga clic en el mapa para colocar un punto y seleccionar entidades intersecantes.

      Los usuarios pueden seleccionar varias entidades de las cuatro formas siguientes:

      • Cree una selección de entidades con cada nuevo dibujo de la herramienta de selección. Esta es la opción predeterminada.
      • Agregar a la selección actual definida (pulse la tecla Mayús mientras dibuja).
      • Retirar entidades de la selección actual definida (pulse la tecla Ctrl mientras dibuja en Windows; pulse la tecla Cmd mientras dibuja en Mac).
      • Seleccionar entidades de la selección actual definida (pulse Ctrl+Mayús mientras dibuja en Windows; Cmd+Mayús mientras dibuja en Mac).

      Cuando el usuario realiza una selección, el icono de herramienta de selección se convierte en un icono de progreso. Si el usuario selecciona un gran número de entidades, el proceso de selección puede tardar mucho tiempo. Los usuarios pueden hacer clic en el botón de progreso para detener el proceso de selección.

    • Extensión navegar: vuelva hacia atrás y adelante a través de las extensiones que el usuario ha visitado en tiempo de ejecución.
    • Mapa de vista general: agregue un mapa inserto expandible. El mapa de vista general es una versión más pequeña del mapa principal con un rectángulo localizador que representa la extensión del mapa principal. Si hace clic y arrastra el rectángulo localizador, el mapa principal se amplía hasta esa nueva ubicación. Esta herramienta no aparece en las pantallas pequeñas.
  • Diseño de herramientas: seleccione un diseño para las herramientas de mapa en dispositivos de pantalla grande y mediana.
    Nota:

    El widget Mapa oculta automáticamente las herramientas según la altura del widget para que responda mejor a los dispositivos de pantalla mediana y pequeña. Por ejemplo, si la altura de un widget Mapa es inferior a 465 píxeles, las herramientas Medir y Localizar se ocultan en las pantallas pequeñas y medianas, incluso si están activadas en la configuración del widget. A medida que disminuye la altura del widget, se ocultan más herramientas. Las herramientas Pantalla completa, Buscar, Zoom, Barra de escala y Brújula son las últimas en desaparecer.

  • Opciones
    • Colores de selección de entidades: cambie el color de resaltado y la transparencia de las entidades seleccionadas en el mapa. Puede personalizar el relleno y el contorno de resalte.
    • Habilitar zoom con desplazamiento: habilite el zoom con la rueda del ratón y, en las pantallas táctiles, el desplazamiento del mapa con un solo dedo.
    • Habilitar elemento emergente: habilite elementos emergentes en el mapa. Si su aplicación también incluye un widget Información de entidades, es recomendable desactivar esta opción. Si una fuente de datos tiene datos relacionados y configura registros relacionados en elementos emergentes en Visor de mapas, puede visualizar los registros relacionados en elementos emergentes en Experience Builder.
      • Mostrar elemento emergente al seleccionar la entidad: muestra elementos emergentes en el mapa cuando el usuario selecciona entidades de mapa en otro widget, como por ejemplo un widget Tabla o Lista.
      • Acoplar ventana emergente: acople los elementos emergentes de forma predeterminada. Es posible configurar los elementos emergentes para que aparezcan en uno de los seis puntos de anclaje dentro del marco del widget Mapa. En tiempo de ejecución, el usuario puede seguir haciendo clic en Acoplar y Desacoplar en el elemento emergente para cambiar el lugar donde aparecen los elementos emergentes.
    • Modo de calidad de la escena (para escenas web): controle la calidad de la escena web equilibrando el efecto visual y la eficacia de carga.
      • Baja: aumente el rendimiento, la estabilidad y la velocidad reduciendo la carga de datos.
      • Media: optimice a partes iguales el rendimiento y la calidad.
      • Alta: mejore la calidad de las opciones de visualización (como el reflejo del agua).
  • Activar la consulta del lado del cliente: active estos botones de alternancia para que los widgets de la aplicación utilicen consultas del lado del cliente para trabajar con los datos de sus mapas web. Si conecta el mismo mapa web a varios widgets Mapa, solo tiene que activar una vez las consultas del lado del cliente para un mapa web.
    Nota:

    Las escenas web no admiten consultas del lado del cliente.

    Las ventajas de las consultas del lado del cliente son una menor demanda al servidor y un mejor rendimiento de la aplicación. Las consultas del lado del cliente reducen considerablemente el número de peticiones de red realizadas a un servidor. Además, las consultas del lado del cliente son más rápidas que las del lado del servidor. Las tareas relacionadas con los datos, como la selección de una entidad para actualizar un gráfico, se realizan con más rapidez.

    La desventaja de las consultas del lado del cliente es que las entidades de mapa tardan más en cargarse cuando se modifica la extensión del mapa.

    Nota:

    Una configuración de aplicación Experience Builder común que puede exigirse en los servidores es un widget Lista que se actualiza en función de la extensión actual del mapa.

    Para evitar la sobrecarga de los servidores, se recomienda que active las consultas del lado del cliente si configura un widget Mapa con el desencadenador Cambios en la extensión y la acción de mensaje Filtrar registros de datos. Esto es especialmente importante si espera que muchos usuarios accedan a una aplicación al mismo tiempo.

    Nota:

    Para ver las limitaciones conocidas de las consultas del lado del cliente, consulte la documentación de ArcGIS Maps SDK for JavaScript.

Opciones de interacción

El widget Mapa admite la definición de desencadenadores en la pestaña Acción de la configuración del widget. Puede sincronizar dos widgets de Mapa agregando un desencadenador de Cambios de extensión a ambos mapas, seleccionando el otro mapa como destino para ambos y eligiendo las acciones Desplazar panorámicamente a o Acercar a. Para los mapas web, la sincronización de Acercar a incluye el comportamiento de rotación del mapa. Para las escenas web, incluye los comportamientos de rotación e inclinación.

Nota:

Si un widget de Mapa está configurado con las acciones Acercar a y Desplazar panorámicamente a, la acción Acercar a tiene prioridad sobre Desplazar panorámicamente a. Esto significa que si el usuario desplaza y amplía el mapa al mismo tiempo, se ignora la acción Desplazar panorámicamente a.

Puede definir desencadenadores y acciones de mensajes para que un mapa interactúe con otros widgets. Por ejemplo, puede agregar un desencadenador de acción para hacer que un widget Lista muestre solo las entidades visibles en el mapa. El widget Mapa también admite acciones de datos, que aparecen en elementos emergentes y permiten a los usuarios exportar datos, ver registros en una tabla y mucho más. Los desencadenadores, acciones de mensajes y acciones de datos se definen y administran en la pestaña Acción de la configuración del widget. Para obtener más información sobre las acciones admitidas del widget Mapa, consulte Agregar acciones a widgets.

Parámetros de la URL

Las subsecciones siguientes describen los parámetros URL relacionados con los mapas. Puede utilizar la configuración de Gestionar estado URL para que estos parámetros aparezcan en la URL cuando el usuario interactúe con el widget Mapa. Todos los parámetros del widget Mapa siguen las marcas de almohadilla (#). Para incluir varios parámetros, debe separarlos con símbolos et (&).

Nota:

Los parámetros center, scale y rotation del widget Mapa solo funcionan con mapas web, no con escenas web.

Definir el mapa web o la escena web para cuando se cargue por primera vez un widget de Mapa

Si su widget Mapa contiene varios mapas web o escenas web, puede definir cuál está activo cuando se carga la aplicación mediante active_datasource_id seguido del Id. de la fuente de datos del elemento deseado. A continuación, se muestran algunos ejemplos:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=active_datasource_id:<dataSourceId>
https://experience.arcgis.com/experience/<AppId>#map_1=active_datasource_id:dataSource_4

Centrar un mapa

Para centrar un mapa en una ubicación concreta, utilice center seguido de las coordenadas deseadas y el Id. conocido del sistema de coordenadas deseado (WKID). A continuación, se muestran algunos ejemplos:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=center:<x,y,wkid>
https://experience.arcgis.com/experience/<AppId>#map_1=center:-10373125.398783844%2C4598516.55871741%2C102100

Definir la escala del mapa

Para definir la escala del mapa, utilice scale seguido de un valor de escala. A continuación, se muestran algunos ejemplos:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=scale:<scaleValue>
https://experience.arcgis.com/experience/<AppId>#map_1=scale:19257701.0800833

Definir la rotación del mapa

Para definir la rotación del mapa, utilice rotation seguido de un número de grados. A continuación, se muestran algunos ejemplos:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=rotation:<rotationValue>
https://experience.arcgis.com/experience/<AppId>#map_1=rotation:45

Definir el punto de visualización del mapa

Para definir el punto de visualización, que es la ubicación o posición de la cámara desde la que ver el mapa o la escena, utilice viewpoint. Si su widget de mapa contiene varios mapas o escenas, el parámetro de punto de visualización afecta a todos ellos.

Los puntos de visualización y sus propiedades suelen escribirse en formato JSON, como en el siguiente ejemplo:

 {
  "rotation": 0,
  "scale": 19966005.903731048,
  "targetGeometry": {
    "spatialReference": {
      "latestWkid": 3857,
      "wkid": 102100
    },
    "x": -9870655.016044471,
    "y": 4724533.527708739
  }
}

Para definir un punto de visualización específico mediante la URL, debe codificar en dicha URL todas esas propiedades escritas normalmente en formato JSON. A continuación, encontrará un ejemplo:

https://experience.arcgis.com/experience/<AppId>#map_1=viewpoint:%7B"rotation"%3A0%2C"scale"%3A24387741.012671936%2C"targetGeometry"%3A%7B"spatialReference"%3A%7B"latestWkid"%3A3857%2C"wkid"%3A102100%7D%2C"x"%3A-10078461.002935613%2C"y"%3A4523117.553838721%7D%7D

Nota:
Los parámetros center, scale y rotation tienen mayor prioridad que el parámetro viewpoint y lo invalidarán si utiliza varios parámetros relacionados con un mapa web.
Nota:

Los cambios de extensión de mapa causados por acciones de mensaje tienen mayor prioridad que los cambios de extensión provocados por parámetros de la URL. Por ejemplo, si intenta abrir un widget Mapa para extensiones predefinidas utilizando los parámetros de URL anteriores, pero el widget Mapa también está configurado como destino del desencadenador Registrar cambios de selección y de las acciones de mensaje Desplazar a o Acercar a, las extensiones asociadas a las acciones de mensaje sustituyen a las extensiones que usted estableció con los parámetros de URL.

Definir la visibilidad de las capas del mapa

Para definir la visibilidad de las capas de un mapa, utilice layer_visibility.

La visibilidad de las capas suele escribirse en formato JSON, como en el siguiente ejemplo:

 {
  "widget_1-dataSource_1": {
    "widget_1-dataSource_1-187938b7328-layer-2": false
  },
  "widget_1-dataSource_4": {
    "widget_1-dataSource_4-18a690b433a-layer-4": false
  }
}

Para que las capas de su mapa estén visibles u ocultas mediante la URL, debe codificar toda la información en la URL después del parámetro layer_visibility. A continuación, encontrará un ejemplo:

https://experience.arcgis.com/experience/<AppId>#map_1=layer_visibility:%7B%22widget_1-dataSource_1%22%3A%7B%22widget_1-dataSource_1-187938b7328-layer-2%22%3Afalse%7D%2C%22widget_1-dataSource_4%22%3A%7B%22widget_1-dataSource_4-18a690b433a-layer-4%22%3Afalse%7D%7D

Acercarse a la entidad seleccionada

Al seleccionar una entidad, aparece el parámetro data_s en la URL de la aplicación. Ahora, puede utilizar el parametro zoom_to_selection=true para acercarse a una única entidad seleccionada en el mapa mediante un ObjectID. A continuación, se muestran algunos ejemplos:

https://experience.arcgis.com/experience/<AppId>/#data_s=id:<data source ID>:<OBJECTID>&zoom_to_selection=true
https://experience.arcgis.com/experience/<AppId>/#data_s=id%3AdataSource_1-csv_905%3A77&zoom_to_selection=true