Implementar el mapa

Cuando tenga el mapa listo para su uso en el campo, impleméntelo para sus trabajadores móviles. Compártalo con ellos para que puedan buscar el mapa en ArcGIS Field Maps o tocar un vínculo personalizado que les haya enviado. Cuando los trabajadores móviles necesitan trabajar sin conexión, pueden descargar los mapas que haya preparado o pueden copiar MMPK directamente en su dispositivo. Proporcione a sus trabajadores móviles ayuda sobre el uso de la aplicación personalizando una guía de campo para los proyectos de captura de datos de su organización o brindándoles instrucciones para rastrear su ubicación. También puede utilizar un software de administración de dispositivos móviles (MDM) para implementar y configurar la aplicación móvil.

Compartir su mapa para usarlo en Field Maps

Field Maps proporciona acceso a mapas que son propiedad de un trabajador móvil o compartidos con una organización de ArcGIS o un grupo del que forma parte el trabajador móvil. Crear un grupo es opcional, pero puede ayudarle a administrar los trabajadores móviles que tienen acceso a sus mapas y datos. Para que sus trabajadores móviles accedan a su mapa compartido, deben ser miembros de una organización de ArcGIS. Si el mapa compartido está habilitado para la edición, también tendrá que tener el privilegio de editar entidades.

  1. Si los trabajadores móviles aún no son miembros de una organización de ArcGIS (en ArcGIS Online o ArcGIS Enterprise), cree cuentas para ellos.
  2. Comparta el mapa y las capas con la organización de ArcGIS o cree un grupo para administrar el acceso a sus mapas y datos.

Abrir su mapa desde un vínculo

Los trabajadores móviles pueden buscar su mapa en Field Maps o también puede proporcionarles una URL directamente al mapa. Facilite que sus trabajadores móviles puedan abrir el mapa adecuado y empezar a trabajar, compartiendo un vínculo directo a su mapa mediante un correo electrónico, un mensaje de texto, una página web u otra aplicación. Utilice vínculos para Field Maps que, al tocarlos, abran Field Maps en el mapa que desea que utilicen los trabajadores móviles. Si el mapa está habilitado para la edición, puede empezar a capturar datos cuando se abre el mapa. Si sus trabajadores móviles trabajan sin conexión, los vínculos siguen funcionando.

Vínculos de Field Maps

Los vínculos de Field Maps tienen el siguiente formato: https://fieldmaps.arcgis.app?parameter=value&parameter=value, donde los pares de parámetro y valor se sustituyen por los valores que desea usar para abrir un mapa. Por ejemplo, https://fieldmaps.arcgis.app?referenceContext=center&itemID=3ac4145c1ac44aea86e9ed42e00fbb0d&center=34.0547155,-117.1961714 usa el parámetro itemID y el valor 3ac4145c1ac44aea86e9ed42e00fbb0d para abrir el mapa con ese Id. El parámetro referenceContext y su valor center especifican el tipo de acción que se debe realizar en la aplicación, en este caso, centrar el mapa. El parámetro center y el valor 34.0547155,-117.1961714 proporcionan las coordenadas en las que centrar el mapa.

Parámetros

Los siguientes parámetros son compatibles con vínculos de Field Maps. Si no se transmite ningún parámetro, al tocar el vínculo se abre Field Maps (o se le solicita que abra la aplicación).

ParámetroValoresNotas

anonymousAccess

Se utiliza cuando se llama a un mapa o MMPK que se comparte públicamente y no requiere iniciar sesión para acceder, o cuando se inicia sesión en un portal en Field Maps que permite el acceso anónimo

  • Requiere itemID cuando se llama a un mapa compartido públicamente.
  • El valor es un booleano, true o false.
  • El valor predeterminado es false.

bookmark

Especifica un marcador del mapa

  • Requiere itemID y referenceContext=center.
  • Se abre el mapa en un punto de visualización concreto especificando un marcador del mapa. Los espacios se codifican como +.
  • El vínculo no puede incluir parámetros distintos de itemID o bookmark.

callback

La URL a la que llamar cuando la captura del activo u observación se completa

  • Requiere itemID, ya sea referenceContext=addFeature, referenceContext=updateFeature o referenceContext=track, y featureSourceURL.
  • Si lo desea, antes de llamar a la URL, ofrezca un mensaje al usuario, especificado con el parámetro callbackprompt.
  • Si se pasan parámetros en la URL de devolución de llamada, cada valor del parámetro debe contar con una codificación URL y, después, toda la URL de devolución de llamada debe estar codificada (conlleva codificar los valores de nuevo).

callbackPrompt

Envía los mensajes al trabajador móvil antes de ejecutar la devolución de llamada y muestra este valor en el mensaje donde lo tomará el trabajador móvil

  • Requiere itemID, ya sea referenceContext=addFeature, referenceContext=updateFeature o referenceContext=track, y callback.
  • El valor debe contar con una codificación URL (los espacios se pueden codificar como + o %20).

center

Un conjunto de coordenadas de latitud y longitud (y, x) en el que se centra el mapa

  • Requiere itemID y referenceContext=center.
  • El centro se debe indicar como un valor de latitud/longitud (y, x) separado por comas en WGS84 (WKID: 4326).

featureAttributes

Un diccionario JSON de entradas de formulario para la entidad recién capturada

  • Requiere itemID, ya sea referenceContext=addFeature o referenceContext=updateFeature y featureSourceURL.
  • Las entradas especificadas sobrescriben los valores existentes.
  • Si la entrada no se encuentra en el formulario editable o el tipo de valor proporcionado es incorrecto, la entrada se ignora.
  • Las fechas deben representarse con un valor numérico mediante milisegundos desde el tiempo Epoch.
  • Las entradas con un dominio de valor codificado asociado utilizan el código de dominio (no la descripción de dominio).
  • Las entradas deben presentar una codificación URL antes de transmitirse a Field Maps.

featureID

Identifica de forma única la entidad dentro de la capa que se va a actualizar. Debe ser un campo GlobalID.

  • Requiere referenceContext=updateFeature
  • La capa que contiene la entidad debe admitir actualizaciones de entidades.

featureSourceURL

La URL de la capa en la que se crea una instancia de la captura

  • Requiere itemID, además de referenceContext=addFeature o referenceContext=updateFeature
  • Si lo desea, proporcione entradas para el formulario con el parámetro featureAttributes.

foreignKeyField

El campo de la tabla secundaria que define la relación y recibe la clave de la entidad principal

  • Requiere referenceContext=addRelatedFeature, itemID, featureSourceURL y featureID.

geometry

Define la ubicación para la entidad recién capturada

  • Requiere itemID, ya sea referenceContext=addFeature o referenceContext=updateFeature y featureSourceURL.
  • El valor es una coordenada que contiene x, y y z, o una representación JSON de una geometría (punto, línea o polígono).
  • Los valores JSON deben tener codificación URL.

itemID

El itemID para que se abra el mapa

  • Requiere referenceContext.
  • El Id. de elemento se encuentra en la URL de la página de elemento de su mapa. Por ejemplo, si la URL de la página de elemento de su mapa es https://www.arcgis.com/home/item.html?id=0c900ae2a1084d27b608233921ef1a84, el Id. de elemento del mapa es 0c900ae2a1084d27b608233921ef1a84.
  • Entre los tipos de mapas admitidos se incluyen mapas web, MMPK y áreas sin conexión.

portalURL

La URL del portal de su organización

  • Si se especifica y el trabajador móvil ha cerrado sesión o se ha conectado a otro portal (incluido ArcGIS Online), se le pide que cierre su sesión y se le dirige directamente a la pantalla de inicio de sesión de su organización, donde se le pide que inicie sesión.
  • Se proporciona la misma URL que se introduce en el navegador cuando se desea acceder al portal, por ejemplo, https://myportal.mycompany.com/arcgis.

referenceContext

Lo que debería hacer la aplicación, si procede, una vez que se abre y el usuario ha iniciado sesión

Se admiten los siguientes valores:

  • addFeature
  • addRelatedFeature
  • center
  • abrir
  • buscar
  • recorrido
  • updateFeature
Nota:

Si desea utilizar varios valores ReferenceContext en una sola dirección URL, como open y search, especifique solo un valor: el uso principal del parámetro ReferenceContext. Por ejemplo, al especificar search implica que el mapa es open. Consulte los ejemplos de vínculo Field Maps a continuación.

scale

La escala (en unidades de mapa) en la que se debe renderizar el mapa

  • Requiere itemID y center.

search

Una dirección, lugar, coordenada o entidad que buscar

  • Requiere itemID.
  • Los espacios se codifican como +.
  • Las entidades se identifican con los mismos términos que se utilizan para buscarlas en el mapa.

trackingDuration

Especifica la duración del rastreo en horas

  • Requiere referenceContext=track y trackingON=true.
  • La unidad es horas y se admiten decimales.

trackingON

Especifica si el rastreo de ubicación está activado o desactivado

  • Requiere referenceContext=track.
  • El valor es un booleano, true o false.

useAntennaHeight

Especifica si la altura de la antena del receptor actual se resta del valor z de cada vértice de la ubicación

  • Requiere itemID, referenceContext=addFeature, geometry y featureSourceURL.
  • El valor es un booleano, true o false.
  • El valor predeterminado es false.
Nota:

Próximamente, se admitirá en Android.

useLocationProfile

Especifica si el perfil de ubicación actual se usa para transformar la ubicación

  • Requiere itemID, referenceContext=addFeature, geometry y featureSourceURL.
  • El valor es un booleano, true o false.
  • El valor predeterminado es false.
Nota:

Próximamente, se admitirá en Android.

wkid

Especifica coordenadas centrales en otra referencia espacial

  • Requiere itemID, center y scale.
  • El valor predeterminado es WKID: 4326 (WGS84) si no se especifica el parámetro.

Siga leyendo ejemplos de uso de estos parámetros para conseguir un comportamiento específico con un vínculo de Field Maps.

Abrir el mapa

Utilice los siguientes parámetros para abrir el mapa:

  • referenceContext=open
  • itemID
  • portalURL (opcional)

Entre los tipos de mapas admitidos se incluyen mapas web, MMPK y áreas sin conexión.

A continuación, se muestran algunos ejemplos:

Acceder a un mapa público sin iniciar sesión

Utilice los siguientes parámetros para acceder a un mapa público:

  • referenceContext=open
  • itemID
  • anonymousAccess=true
  • portalURL (opcional)

A continuación, encontrará un ejemplo:

  • https://fieldmaps.arcgis.app/?referenceContext=open&itemID=5dce807aeb5c4b33bce767d278df9c3d&anonymousAccess=true

Inicie sesión en un portal que permita el acceso anónimo

Utilice los siguientes parámetros para acceder a un portal que permita el acceso anónimo:

  • anonymousAccess=true
  • portalURL

A continuación, encontrará un ejemplo:

  • https://fieldmaps.arcgis.app/?portalURL=https://myportal.mycompany.com/gis&anonymousAccess=true

Centrar y escalar el mapa

Utilice los siguientes parámetros para especificar el centro y la escala del mapa indicado, en lugar de utilizar los ajustes del centro del mapa y la escala predeterminados al abrir el mapa:

  • referenceContext=center
  • itemID
  • center
  • scale (opcional)
  • wkid (opcional)
  • bookmark (opcional)

El sistema de coordenadas predeterminado es WGS84, pero se puede cambiar con el parámetro wkid.

A continuación, se muestran algunos ejemplos:

Buscar en un mapa

Utilice los siguientes parámetros para abrir el mapa y buscar una dirección, lugar, coordenada o entidad (activo u observación):

  • referenceContext=search
  • itemID
  • search

A continuación, se muestran algunos ejemplos:

Ver un marcador

Utilice los siguientes parámetros para ver la ubicación especificada por un marcador del mapa:

  • referenceContext=center
  • itemID
  • bookmark

En el siguiente vínculo de ejemplo se abre el mapa en un marcador llamado Centennial Park:

https://fieldmaps.arcgis.app/?referenceContext=center&itemID=0c900ae2a1084d27b608233921ef1a84&bookmark=Centennial+Park

Iniciar la captura de una entidad

Abra el mapa y empiece a capturar una entidad utilizando los siguientes parámetros. Si lo desea, proporcione entradas de formulario para aplicarlas al nuevo activo u observación.

  • itemID
  • referenceContext=addFeature
  • featureSourceURL
  • geometry (opcional): si se proporciona, define la forma de la entidad. Si no se proporciona, se utiliza la ubicación GPS del trabajador móvil para el punto o el primer vértice si es una línea o polígono.
  • useAntennaHeight (opcional)
  • useLocationProfile (opcional)
  • featureAttributes (opcional)
  • callback (opcional)
  • callbackPrompt (opcional)
Nota:

Próximamente, se admitirá useAntennaHeight, useLocationProfile en vínculos en Android.

A continuación, se muestran algunos ejemplos:

Iniciar la actualización de una entidad

Abra el mapa y empiece a actualizar una entidad existente utilizando los siguientes parámetros. Si lo desea, proporcione entradas de formulario para aplicarlas al activo u observación actualizados.

  • itemID
  • referenceContext=updateFeature
  • featureSourceURL
  • featureID
  • featureAttributes (opcional)
  • geometry (opcional)
  • callback (opcional)
  • callbackPrompt (opcional)
Nota:

Esta funcionalidad no se aplica a las filas de tabla.

A continuación, se muestran algunos ejemplos:

Agregar una entidad relacionada

Abra el mapa y agregue una nueva entidad relacionada utilizando los siguientes parámetros:

  • itemID
  • referenceContext=addRelatedFeature
  • featureSourceURL
  • featureID
  • foreignKeyField

El siguiente vínculo de ejemplo abre un mapa y agrega una entidad relacionada basada en el nombre del campo de clave externa al que se asocia la nueva entidad:

https://fieldmaps.arcgis.app/?referenceContext=addRelatedFeature&itemID=0c900ae2a1084d27b608233921ef1a84& featureSourceURL=https://services9.arcgis.com/QjGvjfQhsHAmqfjP/arcgis/rest/ services/DamageAssessment_Apr2018_631d0895e7d3404bb78e8e04e92d896e/FeatureServer/ 1&featureID=bb0a0c92-9f53-4367-a6a1-bc6edc605be0&foreignKeyField=FacilityID

Iniciar rastreo de ubicación

Utilice los siguientes parámetros para habilitar el rastreo de ubicación y definir una duración del rastreo:

  • referenceContext=track
  • trackingON=true
  • trackingDuration

El siguiente vínculo de ejemplo activa el rastreo de ubicación durante 120 horas:

https://fieldmaps.arcgis.app/?referenceContext=track&trackingOn=true&trackingDuration=120​

Nota:

También puede utilizar un vínculo para desactivar el rastreo de ubicación. Por ejemplo:

https://fieldmaps.arcgis.app/?referenceContext=track&trackingOn=false

Proporcionar una guía para la captura de datos

Aunque esta documentación ofrece información sobre el uso de Field Maps, los trabajadores móviles que capturan datos en el campo a menudo necesitan algo más ligero, que puedan imprimir y llevar consigo (especialmente si trabajan sin conexión). Proporcionarles una guía de campo básica de una sola página que los ayude con tareas comunes y algunos problemas le facilitará su trabajo de apoyo a los trabajadores móviles. Se proporciona una plantilla de guía de campo centrada en tareas comunes de captura de datos y escrita para el trabajador móvil. Utilícela para empezar a crear sus propias referencias para los trabajadores móviles.

  1. Descargue la plantilla de guía de campo.
  2. Personalice la guía (agregue su logotipo, sugerencias específicas de su organización para la solución de problemas, etc.). Asegúrese de eliminar la primera sección que incluye los pasos de personalización.
  3. Proporcione la guía a los trabajadores móviles.

    Los trabajadores móviles pueden guardarse la guía en el bolsillo y usarla para resolver problemas mientras están en el campo.

Proporcionar instrucciones para el rastreo de la ubicación

Si su organización requiere el rastreo de ubicación, es útil proporcionar a los trabajadores móviles instrucciones sobre cómo empezar a rastrear su ubicación en la aplicación móvil Field Maps. A continuación se proporciona una plantilla para las instrucciones del rastreo de ubicación:

  1. Descargar la plantilla de instrucciones de rastreo de ubicación.
  2. Siga las instrucciones del documento para personalizar la plantilla y compartirla con los trabajadores móviles.

Administración de dispositivos móviles

La Administración de dispositivos móviles (MDM, por sus siglas en inglés) hace referencia al software que se utiliza en la administración de dispositivos móviles en una organización. Se utiliza MDM para mejorar la seguridad de los datos y de la red, además de para establecer y aplicar políticas de dispositivos móviles. Además, utilizar la MDM aumenta la eficiencia de la administración y las implementaciones de aplicaciones para dispositivos móviles, incluido el control de cómo y cuándo se actualiza una aplicación. Para obtener más información sobre el enfoque de Esri frente a la MDM, consulte Patrones de implementación móviles y seguros de ArcGIS en el ArcGIS Trust Center.

Durante la preparación para implementar Field Maps en los dispositivos móviles de su organización mediante MDM, puede que desee modificar determinada configuración de perfil y de la aplicación. Se incluye la URL del portal y la configuración de VPN por aplicación.

Configuración de la aplicación Field Maps

La Configuración de la aplicación (a veces llamada AppConfig) hace referencia a un formato para proporcionar configuración de la aplicación, como la URL del portal, entre otros. En lugar de configurar estos ajustes manualmente siempre que se instala una aplicación móvil, puede utilizar su MDM para especificar y aplicar configuraciones de la aplicación automáticamente. Esta configuración se define como diccionario de pares de clave-valor en un archivo XML. La forma en que se crea un diccionario depende de la MDM que esté utilizando. Para obtener más información sobre la configuración de la aplicación, visite la Comunidad AppConfig.

Field Maps cuenta con la siguiente configuración, que se puede implementar con la configuración de la aplicación en su MDM:

ClaveValorNotas

anonymousAccess

Especifica si se debe iniciar sesión anónimamente o si se requieren credenciales

  • El valor del parámetro anonymousAccess se ignora si:
    • El portalURL no se especifica.
    • El portal especificado en portalURL no admite el acceso anónimo.
  • Si anonymousAccess es true y se especifica el portalURL, cuando se abra Field Maps, las credenciales no serán necesarias y se iniciará sesión en el portal de forma anónima.
  • El valor es un booleano, true o false.
Nota:

Al conectarse a un portal de forma anónima, los mapas públicos de Grupos destacados aparecen en la lista Mapas. Los trabajadores móviles pueden buscar cualquier mapa compartido públicamente en el portal.

isAutoSyncEnabled

Especifica si se habilita la sincronización automática

  • El valor es un booleano, true o false.
  • El valor predeterminado es true.
  • Si isAutoSyncEnabled es false, el botón de alternancia de sincronización automática se oculta en la configuración Perfil y el panel Sincronización del dispositivo móvil.

locationProfiles

Define los parámetros de uno o varios perfiles de ubicación

  • Se requieren los siguientes parámetros:
    • name: el nombre del perfil de ubicación.
    • mapCoordinateSystem: el código WKID para el sistema de coordenadas del mapa.
    • gnssCoordinateSystem: el código WKID para el sistema de coordenadas del receptor GNSS.
    • horizontalDatumTransformationName: el nombre de la transformación de datum horizontal.
  • Si locationProfiles contiene varios conjuntos de valores, el primer perfil de ubicación de la lista se establece como el perfil predeterminado.
  • Por ejemplo: [ { "name":"RTK", "mapCoordinateSystem":3857, "gnssCoordinateSystem": 6318, "horizontalDatumTransformationName": "~WGS_1984_(ITRF08)_To_NAD_1983_2011" }]

offsetProvider

Especifica el proveedor de desplazamiento

  • Se admiten los siguientes valores:
    • Bad Elf Flex
    • Eos Tools Pro
    • Spike
      Nota:

      Spike solo se admite en iOS.

portalURL

La URL del portal de su organización

  • Cuando se abre Field Maps, pasa directamente a la pantalla de inicio de sesión del portal de su organización.
  • Por ejemplo, https://myportal.mycompany.com/gis.
  • El tipo de valor es cadena de caracteres.

trackingUploadLKLFrequency

Especifica la frecuencia de carga de la última ubicación conocida

  • Invalida la configuración predeterminada de 60 segundos.
  • La unidad es segundos y el valor debe ser mayor que 5.

trackingUploadTracksFrequency

Especifica la frecuencia de carga del rastreo

  • Invalida la configuración predeterminada en la aplicación.
  • La unidad es segundos y el valor debe ser mayor que 30.

useInAppAuth

Especifica si se utiliza una vista web para iniciar sesión y la autenticación en Field Maps

  • El valor es un booleano, true o false.
  • El valor predeterminado es false.
  • Si useInAppAuth es false, la página de inicio de sesión se iniciará con un flujo fuera de proceso.
  • Si useInAppAuth es true, la página de inicio de sesión utilizará una vista web en la aplicación.
Precaución:

Si se requiere una VPN para acceder a sus recursos interiores y su organización restringe el acceso a los navegadores en dispositivos administrados, puede ser necesario cambiar useInAppAuth a true para habilitar el inicio de sesión correctamente en sus portales.

Nota:

Si Field Maps se abre con un vínculo Field Maps, los valores del parámetro de vínculo tienen prioridad sobre los ajustes de configuración de la aplicación.

Red privada virtual por aplicación

Configurar una red privada virtual por aplicación (VPN por aplicación) en su MDM le permite restringir el acceso a recursos internos a aplicaciones administradas concretas. Field Maps se puede implementar con esta configuración. Para configurar una VPN por aplicación y utilizarla en Field Maps, consulte la documentación de software de la MDM que esté utilizando.

Precaución:

Si está en iOS y utiliza ArcGIS Online o ArcGIS Enterprise 10.6.1 o posterior, se utiliza Safari para mostrar la pantalla de inicio de sesión del portal en Field Maps. Para que funcione correctamente con una VPN por aplicación habilitada, el dominio de su portal (por ejemplo, mycompany.com) se debe especificar en la configuración Dominios de Safari en el perfil de la VPN por aplicación que esté utilizando. Si Dominios de Safari no se configura correctamente, los dispositivos móviles asignados no pueden acceder a la pantalla de inicio de sesión del portal de Field Maps. La alternativa es cambiar useInAppAuth a true, lo que forzará que el proceso de inicio de sesión se produzca en una vista web por aplicación, en lugar de hacerlo en Safari.

Cuando se define un Dominio de Safari en el perfil de la VPN por aplicación tal y como se describe anteriormente, la aplicación de navegador Safari también puede acceder al dominio del portal que especificó en la configuración de Dominios de Safari. Si desea bloquear este acceso, configure una Restricción de iOS (si está disponible en su MDM) para Bloquear la aplicación del navegador Safari en los dispositivos que desee.

Si está en Android y utiliza ArcGIS Online o ArcGIS Enterprise 10.6.1 o posterior, se utiliza Chrome Custom Tabs (o su navegador preferido) para mostrar la pantalla de inicio de sesión del portal en Field Maps. Para que funcione correctamente con una VPN por aplicación habilitada, el navegador debe tener un acceso VPN. Considere la posibilidad de cambiar useInAppAuth a true para evitar este requisito y forzar que el proceso de inicio de sesión se produzca en una vista web por aplicación.

Tras ajustar la configuración de la VPN por aplicación para Field Maps en su MDM, cuando se abre la aplicación en un dispositivo móvil administrado, se conecta automáticamente a la VPN por aplicación designada. Cuando se ejecuta Field Maps en segundo plano, la VPN por aplicación sigue conectada, pero solo a Field Maps. Cuando se cierra Field Maps, el dispositivo móvil se desconecta automáticamente de la VPN por aplicación.