Geopuntos

Las preguntas geopunto permiten capturar una ubicación concreta en una encuesta. Aunque las respuestas de las encuestas en Survey123 siempre intentan capturar la ubicación de un dispositivo, incluso si no hay ninguna pregunta geopoint, una pregunta geopoint visible en el formulario mejora la captura de la información de ubicación.

Pregunta de geopunto predeterminada

Plantéese lo siguiente al utilizar geopuntos:

  • Puede agregar varias preguntas geopoint, geotrace o geoshape a una encuesta, pero solo se puede utilizar una de ellas como geometría del registro de la encuesta. Se pueden usar varias preguntas de mapa si todas las preguntas, excepto una, tienen el valor bind::esri:fieldType definido como null.
  • Cada repetición de una encuesta también puede tener más de una pregunta geopoint, geotrace o geoshape, pero solo se puede utilizar una de ellas como geometría de un registro repetido. Puede usar varias preguntas de mapa con el mismo método descrito anteriormente.
  • De forma predeterminada, Survey123 muestra valores de latitud y longitud WGS84 en formato de grados/minutos/segundos. Para cambiar esta visualización en una encuesta, seleccione la pestaña Mapa y elija otro valor de Formato de coordenadas.
  • De manera predeterminada, una pregunta geopunto usa un mapa base en línea. Si la encuesta se va a usar sin conexión, consulte Usar mapas base sin conexión.
  • Las ubicaciones de puntos de la primera pregunta geopoint en una repetición se pueden mostrar en cualquier mapa de la encuesta. Para obtener más información, consulte Superposiciones de puntos en mapas.
  • Si no incluye ninguna pregunta geopoint, geotrace o geoshape en una encuesta, la capa de entidades principal de su encuesta tendrá un tipo de geometría de esriGeometryPoint. La ubicación de punto se rellenará con la información de ubicación disponible en el dispositivo en el momento en que se abre la encuesta. Este comportamiento se aplica incluso si la encuesta tiene repeticiones que contienen preguntas de mapa, pero no incluye ninguna pregunta de mapa fuera de las repeticiones.
  • Al definir la columna appearance de la pregunta geopoint en press-to-locate, Survey123 solo capturará un punto cuando el usuario interactúe con la pregunta.
  • Cuando se capturan respuestas usando un mapa, la aplicación web no admite todas las características de la aplicación de campo Survey123. Las siguientes características se admiten en la Survey123 de campoSurvey123pero no en la aplicación web:
    • Mapas base sin conexión.
    • Cálculo de promedios de ubicación para preguntas de geopunto.
    • Simbología de geopunto.
    • Umbrales de precisión de ubicación y expresiones de calidad de ubicación.
    • Todas las propiedades de pulldata("@geopoint"). La aplicación web solo admite propiedades de x, y, z, horizontalAccuracy, verticalAccuracy, speed, y direction.

Umbral de precisión de ubicación

De manera predeterminada, Survey123 no comprueba la precisión en los valores de posición que captura. Si la precisión de la posición es importante para los resultados de la encuesta, puede definir un umbral de precisión con promedio de ubicación. Puede hacerlo introduciendo un valor numérico en la columna body::accuracyThreshold de la pregunta geopoint. Este valor será el umbral de precisión por encima del cual dejan de capturarse valores cuando se promedia una ubicación.

Mensaje de error cuando una respuesta sobrepase el umbral de precisión de 5 metros

Cuando no se promedia, el panel de mapa de la aplicación de campo Survey123 muestra una advertencia si la precisión de la posición es mayor que el umbral definido, pero no impide que el usuario capture ubicaciones. Para capturar una ubicación que satisfaga el umbral, espere hasta que no haya advertencia y seleccione el botón de ubicación. Las posiciones que no cumplen el umbral de precisión se pasan por alto automáticamente al promediar.

Expresiones de calidad de ubicación

El umbral de precisión de ubicación es un número único, un valor mínimo para la precisión horizontal de una ubicación determinada. Para advertir a un usuario de que su ubicación no cumple con otros requisitos de calidad más complejos, o para impedirle que envíe esa ubicación, se puede utilizar una expresión. Las siguientes son las columnas (junto con sus columnas de mensaje asociadas) en las que puede introducir estas expresiones:

  • Las columnas constraint y constraint_message se pueden utilizar para evitar que el usuario capture una ubicación en una pregunta geopoint cuando la expresión de calidad de ubicación no se cumple.
  • Las columnas bind::esri:warning y bind::esri:warning_message pueden utilizarse para mostrar una advertencia al usuario si la expresión de calidad de ubicación no se cumple. Si no se cumple la expresión de calidad de ubicación, la barra que contiene el valor de coordenada de la parte superior de la pregunta geopoint cambia al color amarillo. En tal caso, el usuario puede capturar la ubicación a pesar de ello.
Mensaje de advertencia cuando la respuesta no cumple la expresión de calidad de ubicación

Es posible crear una expresión en cualquiera de estas columnas utilizando cualquier pregunta de la encuesta; se suelen utilizar preguntas o parámetros relacionados con la ubicación de la encuesta.

Para conocer los parámetros de ubicación que se pueden utilizar, consulte la sección Extraer valores de geopuntos a continuación.

Por ejemplo, la siguiente expresión puede utilizarse para garantizar que el usuario se ha detenido casi por completo antes de capturar una ubicación, y que la precisión horizontal sea superior a 5 metros:

pulldata("@geopoint", ., "horizontalAccuracy") < 5 and pulldata("@geopoint", ., "speed") < 0.1

Sugerencia:

Si bien es posible que desee que el usuario capture un punto cuando está parado, rara vez un dispositivo reportará un valor de velocidad de cero. Por esta razón, el ejemplo anterior busca una velocidad inferior a 0,1 para introducir un margen de error aceptable.

Si la ubicación se debe capturar en las condiciones descritas por la expresión, introduzca la expresión en la columna constraint. Si es solo una recomendación, al introducir la expresión en la columna bind::esri:warning se muestra al usuario el mensaje de advertencia correspondiente. El usuario puede seguir capturando la ubicación en la pregunta geopoint.

Los mensajes de constraint y bind::esri:warning se muestran si la expresión en estas columnas se evalúa como falsa.

Para expresiones muy largas o complejas, se recomienda separar estas funciones de pulldata("@geopoint") en preguntas individuales y referirse a estos nombres de preguntas en la expresión. Por ejemplo, para realizar la misma función que en el ejemplo anterior, puede utilizar el siguiente cálculo en una pregunta denominada hAccuracy:

pulldata("@geopoint", ${location}, "horizontalAccuracy")

A continuación, puede utilizar el siguiente cálculo en una pregunta denominada currentSpeed:

pulldata("@geopoint", ${location}, "speed")

El siguiente cálculo se puede utilizar como la restricción o expresión de advertencia para la pregunta geopoint:

(${hAaccuracy} < 5) and (${currentSpeed} < 0.1)

Reportar rango de confianza del 95 por ciento

Es posible que su organización necesite que los datos recopilados se reporten como rango de confianza (IC) específico. De forma predeterminada, cuando el tipo de precisión que se devuelve es cuadrático medio (RMS), el IC será del 68 por ciento. Para alcanzar el 95 por ciento de IC en su encuesta, multiplique la precisión horizontal por 1,7308 y la precisión vertical por 1,9600. Para obtener más información sobre estos factores de conversión, consulte la Norma nacional de EE. UU. sobre precisión de datos espaciales.

Ejemplo de alta precisión

En este ejemplo, se debe alcanzar el mínimo absoluto del conjunto de variables; sin embargo, la captura de ubicaciones con algunas variables menos estrictas se deja a criterio del usuario. Puede que haya problemas de seguridad o riesgos que eviten que el usuario se quede en la ubicación el tiempo necesario para cumplir los requisitos deseados. En tal caso, se muestra una advertencia y el usuario puede decidir si capturar la ubicación o esperar más tiempo.

El autor de la encuesta define los siguientes requisitos de precisión mínima absoluta:

  • La precisión horizontal con un 95 por ciento de IC es menor que dos metros.
  • La precisión vertical con un 95 por ciento de IC es menor que dos metros.
  • La dilución de la precisión de posición (PDOP) es menor o igual que 6,0.
  • Se usan cinco satélites o más.

El autor de la encuesta define los siguientes requisitos de precisión deseada:

  • La precisión horizontal con un 95 por ciento de IC es menor que un metro.
  • La precisión vertical con un 95 por ciento de IC es menor que un metro.
  • La PDOP es menor o igual que 2,0
  • Se usan siete satélites o más.

Se puede utilizar el siguiente cálculo en una pregunta denominada haccuracy68cep:

pulldata("@geopoint", ${location}, "horizontalAccuracy")

A continuación, se puede utilizar el siguiente cálculo en una pregunta denominada haccuracy95ci:

${haccuracy68cep} * 1.7308

Con cálculos similares hechos para la precisión vertical, se introduce la siguiente expresión en la columna constraint para representar la precisión mínima absoluta:

${accuracyType} = 0 and ${haccuracy95ci} < 2 and ${vaccuracy95ci} < 2 and ${pdop} <= 6 and ${satellitesInUse} >= 5

La siguiente expresión se introduce en la columna bind::esri:warning para representar la precisión deseada. Los valores que se usan aquí suelen ser más pequeños que los que se usan para la precisión mínima absoluta. Se prefieren valores más pequeños, pero se pueden utilizar los valores mínimos más grandes.

${accuracyType} = 0 and ${haccuracy95ci} < 1 and ${vaccuracy95ci} < 1 and ${pdop} <= 2 and ${satellitesInUse} >= 7

Capas de entidades 3D

De manera predeterminada, las preguntas geopunto de Survey123 no admiten valores del eje z (altitud); solo capturan la latitud y la longitud en una capa de entidades bidimensional. Puede cambiarlo introduciendo esriFieldTypePointZ en el campo bind::esri:fieldType de la pregunta, lo que permite que el valor de la altitud se capture en la capa de entidades. También permite que el campo de altitud se modifique al especificar un valor de geopunto.

Valores predeterminados

Es posible establecer una ubicación predeterminada para una pregunta geopoint proporcionando un conjunto de valores de longitud y latitud (en grados decimales) separados por espacios en la columna default. Por ejemplo, -37.814552 144.966071 hará que la pregunta geopoint tenga una ubicación predeterminada en Melbourne, Australia.

Sugerencia:

Los valores predeterminados de ubicación situados en el hemisferio sur generan un error en Microsoft Excel, ya que el valor se lee como una fórmula porque comienza con un signo menos (-). En estos casos, introduzca un apóstrofo antes del primer valor, y Excel lo leerá de la forma prevista. Si agrega un apóstrofo, no se provoca ningún cambio en el comportamiento de Survey123.

Si no se proporciona un valor predeterminado, la pregunta geopoint se actualiza automáticamente a la ubicación actual del dispositivo. Para evitar esto, defina el valor predeterminado como null. La pregunta geopoint mostrará a continuación las opciones para habilitar la captura de la ubicación, cargar la página del mapa para establecer una ubicación manualmente o refrescar un cálculo si aplica.

Las preguntas de geopunto que se cambian de un estado no relevante a uno relevante no se actualizarán automáticamente a la ubicación del dispositivo. Establezca el valor predeterminado como posición para que el dispositivo identifique automáticamente la ubicación actual cuando la pregunta sea relevante.

Las preguntas geopoint contenidas en encuestas que se inician desde la Bandeja de entrada, Borradores o Bandeja de salida no se actualizarán automáticamente a la ubicación actual del dispositivo. Establezca el valor predeterminado como posición para obtener automáticamente la ubicación actual identificada por el dispositivo cuando la encuesta se abre desde una carpeta.

Cálculos

Puede llenar una pregunta geopoint usando los resultados de otras preguntas. La respuesta de una pregunta geopoint tiene el formato de una lista de valores de longitud y latitud (en grados decimales) separados por espacios y seguidos de valores opcionales, empezando por la altitud y la precisión (en metros). Al rellenar la respuesta de una pregunta geopoint, debe seguir esta estructura para que la respuesta sea válida.

Como no puede hacer esto directamente al rellenar desde las preguntas select_one, se recomienda usar la función substr() para ayudar a crear una respuesta válida. Por ejemplo, el nombre del geopunto puede ser el siguiente:

+059.38330_+018.00000

Este valor usa un número fijo de caracteres para la latitud y la longitud, incluidos ceros que normalmente se truncarían con un guion bajo entre los dos valores, ya que la columna name no admite espacios. Esto crea un valor que se puede descomponer con la función substr() para rellenar el siguiente ejemplo de pregunta geopoint:

concat(substr(${LocationValue}, 0, 10), " ", substr(${LocationValue}, -10))

Este ejemplo toma los 10 primeros caracteres del valor (la latitud) y los 10 últimos caracteres (la longitud) y los presenta separados por un espacio para producir un resultado de geopunto válido.

También puede usar la función pulldata() para rellenar una pregunta geopoint usando un archivo .csv adjunto. En primer lugar, agregue el archivo .csv a la carpeta contenido multimedia de la encuesta. A continuación, agregue a la columna calculation algo parecido a lo siguiente:

pulldata('Intersections', 'Lat', 'IntersectionID', ${intersection}) + " " + pulldata('Intersections', 'Long', 'IntersectionID', ${intersection})

Al igual que en el ejemplo substr(), esto combina los valores de latitud y longitud de una ubicación con un espacio para crear una respuesta válida para una pregunta geopunto basada en una pregunta anterior.

Consulte los ejemplos de estos cálculos en las muestras de Survey123 Connect.

Obligatorias y de solo lectura

Las preguntas geopoint rellenan automáticamente una encuesta con una ubicación proporcionada por el dispositivo si hay alguna disponible. Si el dispositivo no proporciona una ubicación válida en la respuesta de la encuesta, Survey123 devuelve una ubicación de 0,0, que está en el océano a cierta distancia de la costa de África. Si se marca la pregunta geopoint como required, no se puede enviar la encuesta con este valor nulo. La encuesta solo se acepta una vez que el dispositivo proporcione una ubicación o se envíe una manualmente.

Al marcar una pregunta geopoint como read-only, no se pueden introducir respuestas manuales. Esto puede resultar útil para preguntas en las que es necesaria una respuesta automática y una respuesta manual causaría problemas con el dataset. Es recomendable usarlo con uno de los cálculos que se han descrito antes, ya que proporciona un valor de geopunto discreto que los usuarios no pueden cambiar.

Geobúsqueda y geocodificación

Las preguntas geopunto incluyen una funcionalidad de geobúsqueda, que permite a los usuarios buscar una dirección o un punto de interés y hacer que el mapa se acerque y coloque el marcador de geopunto en esta ubicación.

De manera predeterminada, la funcionalidad de geobúsqueda devuelve resultados de todo el mundo empleando ArcGIS Geocoding Service para buscar las direcciones.

De manera predeterminada, la geobúsqueda devuelve resultados de todo el mundo empleando ArcGIS Geocoding Service para buscar las direcciones. Los usuarios que hayan iniciado sesión también verán todos los servicios de geocodificación configurados de las organizaciones.

Nota:
Geocodificar con ArcGIS Geocoding Service consumirá créditos. Para obtener más información, consulte Comprender los créditos.

Para definir un localizador específico del que devolver resultados, proporcione el Id. de elemento del localizador en la columna bind::esri:parameters, por ejemplo, geocode=36ff9e8c13e042a58cfce4ad87f55d19. El localizador utilizado en una encuesta de ArcGIS Online debe ser un elemento de ArcGIS Online. El localizador utilizado en una encuesta de ArcGIS Enterprise debe ser un elemento del mismo portal que la encuesta.

También puede configurar una pregunta para que solo realice una geocodificación agregando una pregunta de texto con la apariencia geocode. Para obtener más información, consulte Apariencia de geocodificación.

Geocodificación inversa

Puede realizar geocodificación inversa en la aplicación de campo con una pulsación larga en el mapa o las coordenadas con la vista completa de geopuntos abierta, pero no se guarda ni se envía en la encuesta. El valor con geocodificación inversa puede obtenerse del geopunto si utiliza pulldata("@geopoint", ${location}, "reversegeocode"), que devuelve la ubicación como un objeto JSON. Puede extraer propiedades individuales del objeto al indicar el nombre de la propiedad, pero estas propiedades varían en función del localizador utilizado. En el caso de ArcGIS Geocoding Service, se devuelve un objeto JSON similar al siguiente:

{
	"address": {
		"Match_addr": "207-361 Flinders St, Melbourne, Victoria, 3000",
		"LongLabel": "207-361 Flinders St, Melbourne, Victoria, 3000, AUS",
		"ShortLabel": "207-361 Flinders St",
		"Addr_type": "StreetAddress",
		"Type": "",
		"PlaceName": "",
		"AddNum": "283",
		"Address": "283 Flinders St",
		"Block": "",
		"Sector": "",
		"Neighborhood": "Melbourne",
		"District": "Melbourne",
		"City": "Melbourne",
		"MetroArea": "",
		"Subregion": "",
		"Region": "Victoria",
		"RegionAbbr": "VIC",
		"Territory": "",
		"Postal": "3000",
		"PostalExt": "",
		"CntryName": "Australia",
		"CountryCode": "AUS"
	},
	"location": {
		"x": 144.96721048751365,
		"y": -37.81768543612741,
		"spatialReference": {
			"wkid": 4326,
			"latestWkid": 4326
		}
	}
}

Para extraer un valor específico del objeto JSON, utilice una función pulldata("@geopoint") similar a la siguiente, que extrae la propiedad Match_addr:

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")

El servicio de geocodificación predeterminado de su organización se utiliza al realizar la geocodificación inversa. Para utilizar otro servicio de geocodificación, introduzca la URL del localizador como parámetro opcional en la función con el formato pulldata("@geopoint", ${location}, "reversegeocode", ${locatorURL}). Si el servicio está protegido o la encuesta está destinada a usuarios públicos, debe configurar un elemento de proxy que tenga guardadas credenciales de acceso.

Si se proporciona una URL del localizador, se pueden proporcionar parámetros adicionales que se entregarán a la URL. Al igual que con las propiedades proporcionadas con el objeto JSON, estos parámetros difieren en función del servicio de geocodificación utilizado. El siguiente ejemplo utiliza el parámetro featureTypes, que limita el valor devuelto a un tipo específico de ubicación para devolver solo el negocio o el hito más cercano:

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr", "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer", "featureTypes=POI")
Sugerencia:

Si el servicio de geocodificación predeterminado para su implementación de ArcGIS Enterprise es ArcGIS Geocoding Service, o si utiliza ArcGIS Geocoding Service como parámetro de URL del localizador en una encuesta corporativa, como se muestra en los pasos mostrados arriba, podría aparecer un error de token al realizar la geocodificación inversa. Para evitarlo, cree un elemento de proxy que tenga credenciales de acceso a ArcGIS Online guardadas para un usuario con permisos para realizar geocodificación. Este elemento se puede definir como el servicio de geocodificación predeterminado para un portal o el destino de un parámetro de URL de localizador en la función de geocodificación inversa.

Para obtener más información sobre los parámetros de la URL de geocodificación inversa, incluida una lista completa de parámetros que se pueden entregar a la URL, consulte reverseGeocode en la documentación de API REST de ArcGIS.

Puede incluir varios cálculos de geocodificación inversa sin que ello afecte al rendimiento ni a los créditos. Por ejemplo, podrían incluirse las siguientes tres llamadas para propiedades individuales:

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")

pulldata("@geopoint", ${location}, "reversegeocode.address.LongLabel")

pulldata("@geopoint", ${location}, "reversegeocode.address.ShortLabel")

Se realiza una geocodificación inversa para el primer cálculo, lo que consume créditos. A continuación, la respuesta se almacena en caché y se utiliza para los otros dos cálculos. Solo se requiere una nueva llamada al geoservicio si la URL de solicitud de geocodificación inversa ha cambiado, ya sea debido a un cambio de ubicación, a la utilización de otro parámetro de solicitud o a la caducidad del token de acceso original.

Configurar un elemento de localizador de proxy

Para configurar un elemento de localizador de proxy, siga estos pasos:

  1. Inicie sesión en su organización de ArcGIS con una cuenta que tenga privilegios de geocodificación.
  2. En la página Contenido, busque Agregar elemento > Desde una URL para ArcGIS Online, o bien Agregar elemento > Desde la web para ArcGIS Enterprise, y asegúrese de que el tipo seleccionado sea Servicio web de ArcGIS Server.
  3. Use la URL como localizador deseado, por ejemplo, https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer en el caso de ArcGIS Geocoding Service.

    Se detectará como un servicio seguro.

  4. Agregue el nombre de usuario y la contraseña de una cuenta de ArcGIS que tenga privilegios de geocodificación.
  5. Elija Almacenar credenciales con el elemento de servicio. No solicitar autenticación.
  6. Proporcione un título y etiquetas.
  7. Haga clic en Agregar elemento.
  8. Comparta este elemento de localizador en línea públicamente.

Para obtener más información, consulte Requisitos para configurar sus propios localizadores para ArcGIS Online o Configurar los servicios de utilidades con un portal para ArcGIS Enterprise.

Extraer valores de geopuntos

Si desea deconstruir una respuesta de geopunto, puede usar la función pulldata("@geopoint") para extraer los valores y rellenar los valores de otras preguntas. El siguiente ejemplo extrae el valor de precisión horizontal de una pregunta geopoint:

pulldata("@geopoint", ${location}, "horizontalAccuracy")

La disponibilidad de las propiedades de geopunto depende del hardware. En la tabla siguiente se enumeran las propiedades que se pueden extraer de un geopunto:

Nombre de propiedadDescripciónUnidad

x

Longitud: un valor positivo en el hemisferio oriental y un valor negativo en el hemisferio occidental.

Grados decimales

y

Latitud: un valor positivo en el hemisferio norte y un valor negativo en el hemisferio sur.

Grados decimales

z

Altitud, metros sobre el nivel del mar (predeterminado) o altura por encima del elipsoide (si se selecciona en la configuración de la aplicación de campo).

Metros

horizontalAccuracy

Precisión horizontal de las coordenadas x e y.

Metros

verticalAccuracy

Precisión vertical de la coordenada z.

Metros

velocidad

Velocidad en el suelo.

Metros por segundo

verticalSpeed

Velocidad vertical.

Metros por segundo

dirección

La dirección de viaje se mide en el sentido de las agujas del reloj desde el norte.

Grados decimales

positionSourceType

Categoría del origen de posición. Los resultados posibles son: Desconocido (0), Usuario (1), Ubicación del sistema (2), Dispositivo externo (3), Dispositivo de red (4) y Archivo (5).

N/A

positionSourceInfo.antennaHeight

Altura de la antena del dispositivo. La distancia desde la antena hasta la superficie del suelo se resta de los valores de la altitud.

Metros

positionSourceInfo.altitudeType

Tipo de altitud seleccionado. Los resultados potenciales son la altitud sobre el nivel medio del mar (0) y la altura sobre el elipsoide (1). Está disponible para todos los tipos de proveedores de ubicación.

N/A

En la tabla siguiente se enumeran las propiedades adicionales que se pueden extraer de un geopunto capturado con un receptor de alta precisión:

Nombre de propiedadDescripciónUnidad

magneticVariation

Ángulo entre el norte magnético y el norte verdadero.

Grados decimales

fixType

Tipo de ajuste de posición de la coordenada. Los resultados posibles son NoFix (0), GPS (1), DifferentialGPS (2), PrecisePositioningService (3), RTKFixed (4), RTKFloat (5), Estimated (6), Manual (7), Simulator (8) y SBAS (9).

N/A

positionSourceInfo

Información del dispositivo como un objeto JSON. Resulta útil para depuraciones y validaciones. También se pueden devolver elementos individuales mediante un nombre completo de elemento. Consulte las siguientes filas de la tabla para conocer todos los elementos disponibles.

N/A

positionSourceInfo.pluginName

Nombre de origen de posición interno. Solo está disponible en el caso del proveedor de ubicación integrado del dispositivo.

N/A

positionSourceInfo.deviceAddress

Dirección del dispositivo. Solo está disponible para los receptores GNSS externos.

N/A

positionSourceInfo.deviceName

Nombre del dispositivo. Solo está disponible para los receptores GNSS externos.

N/A

positionSourceInfo.deviceType

Tipo de dispositivo externo. Los resultados posibles son: Desconocida (-1), Bluetooth (0), Puerto de serie (1) y Bluetooth LE (2). Solo está disponible para los receptores GNSS externos.

N/A

positionSourceInfo.networkName

Nombre del origen de posición de red. Solo está disponible para los proveedores de ubicación de red.

N/A

positionSourceInfo.networkAddress

Dirección del origen de posición de red. Solo está disponible para los proveedores de ubicación de red.

N/A

positionSourceInfo.networkPort

Puerto del origen de posición de red. Solo está disponible para los proveedores de ubicación de red.

N/A

positionSourceInfo.geoidSeparationCustom

Diferencia entre el elipsoide terrestre WGS-84 y el nivel medio del mar según define el usuario en la configuración de la aplicación.

Metros

geoidSeparation

Diferencia entre el elipsoide terrestre WGS-84 y el nivel medio del mar según informa el receptor GNSS. Se suele denominar altura ortométrica.

Metros

accuracyType

Tipo de precisión según indican las propiedades horizontalAccuracy y verticalAccuracy. Los resultados posibles son RMS (0) y DOP (1). RMS es la precisión cuadrática media. Se calcula siguiendo un rango de confianza del 68 por ciento para la latitud, la longitud y los errores de altitud que se recogen en la sentencia GST proporcionada por el receptor. Si el receptor no admite GST, se usa en cambio DOP. DOP es la precisión basada en la dilución de la precisión. Usa un valor de rango de error estimado del usuario (UERE) constante para estimar las precisiones horizontal y vertical.

N/A

positionAccuracy

Error esférico radial medio. Abarca errores horizontales y verticales.

Metros

latitudeError

Valor del error 1-sigma de latitud. Esta propiedad solo se rellena si su dispositivo de posicionamiento es compatible con sentencias GST en transmisiones de NMEA.

Metros

longitudeError

Valor del error 1-sigma de longitud. Esta propiedad solo se rellena si su dispositivo de posicionamiento es compatible con sentencias GST en transmisiones de NMEA.

Metros

altitudeError

Valor del error 1-sigma de altitud. Esta propiedad solo se rellena si su dispositivo de posicionamiento es compatible con sentencias GST en transmisiones de NMEA.

Metros

hdop

Dilución de la precisión horizontal (HDOP) de los datos de posición.

N/A

vdop

Dilución de la precisión vertical (VDOP) de los datos de posición.

N/A

pdop

Dilución de la precisión de posición (PDOP) de los datos de posición. La ecuación utilizada para determinar PDOP es PDOP^2 = HDOP^2 + VDOP^2.

N/A

differentialAge

Antigüedad de la señal y corrección diferenciales que usa el receptor GPS para corregir de forma diferencial la posición.

Segundos

referenceStationId

Id. de estación de referencia diferencial (DSID) de la estación que usa el receptor GPS.

N/A

satellitesVisible

Número de satélites de posicionamiento que son visibles en el momento de la captura de la ubicación

N/A

satellitesInUse

Número de satélites de posicionamiento que se usan para devolver los datos de posición

N/A

Formato de coordenadas

La función pulldata("@geopoint") también se puede usar para extraer valores de geopunto y aplicarles formatos de coordenadas adicionales:

  • pulldata("@geopoint", ${location}, "DMS") devuelve el geopunto como grados, minutos y segundos. Se devuelve como un objeto JSON:
    {
    	"latitudeDegrees": 39,
    	"latitudeHemisphere": "N",
    	"latitudeMinutes": 57,
    	"latitudeSeconds": 36.3,
    	"latitudeText": "39°57'36.3\"N",
    	"longitudeDegrees": 116,
    	"longitudeHemisphere": "E",
    	"longitudeMinutes": 27,
    	"longitudeSeconds": 4,
    	"longitudeText": "116°27'04.0\"E",
    	"text": "39°57'36\"N 116°27'4\"E"
    }
    Es posible extraer estos valores individuales utilizando parámetros adicionales. Por ejemplo, pulldata("@geopoint", ${location}, "DMS.latitudeMinutes") devuelve solo los minutos de latitud.
  • pulldata("@geopoint", ${location}, "DDM") devuelve el geopunto como grados y minutos decimales, y pulldata("@geopoint", ${location}, "DD") devuelve el punto como grados decimales. También se devuelven como objetos JSON y es posible extraer de ellos valores individuales con parámetros adicionales del mismo modo que el formato de grados, minutos y segundos que aparece arriba.

Los siguientes formatos de coordenadas se pueden utilizar con un parámetro de precisión opcional, lo que produce un valor decimal que es una potencia de 10, por ejemplo, 0,01, 0,1, 1, 10 o 100.

  • pulldata("@geopoint", ${location}, "MGRS") devuelve el geopunto como un valor de cuadrícula del Sistema de Referencia de Cuadrícula Militar (MGRS) con una precisión de 1 metro. Al proporcionar un parámetro de precisión opcional, es posible modificar la precisión. Por ejemplo, pulldata("@geopoint", ${location}, "MGRS", 100) devuelve un valor de cuadrícula con una precisión de 100 metros.
  • pulldata("@geopoint", ${location}, "USNG") devuelve el geopunto como un valor de cuadrícula de la Cuadrícula Cartográfica Nacional de EE. UU. (USNG) con una precisión de 1 metro.
  • pulldata("@geopoint", ${location}, "UTM") devuelve el geopunto como coordenadas de la proyección universal transversal de Mercator (UTM) con una precisión de 1 metro. Se devuelve como un objeto JSON:
    {
    	"band": "S",
    	"easting": 452994,
    	"northing": 4423429,
    	"text": "50S 452994E 4423429N",
    	"type": "UTM",
    	"zone": 50
    }
    Es posible extraer estos valores individuales utilizando parámetros adicionales. Por ejemplo, pulldata("@geopoint", ${location}, "UTM.easting", 0.01) devuelve solo el valor Este con una precesión de 1 centímetro.

Simbología de geopunto

Las preguntas geopoint pueden mostrar un símbolo personalizado para el marcador de punto en el mapa utilizando el parámetro symbol de la columna body::esri:style de una encuesta. Este parámetro debe proporcionar el nombre de archivo del símbolo personalizado, que debe ser un archivo .png de la carpeta de contenido multimedia de la encuesta. Vea el siguiente ejemplo:

symbol=hydrant.png

El parámetro symbol también puede aceptar parámetros opcionales para configurar la visualización del símbolo en el mapa. Separe estos parámetros del nombre de archivo con un signo de interrogación y entre ellos mediante el símbolo et (&). Por ejemplo, el parámetro symbol puede tener las propiedades x, y y scale, tal como se muestra a continuación:

symbol=hydrant.png?x=0.2&y=0.7&scale=2

  • El parámetro x especifica el punto de anclaje horizontal del símbolo. Acepta un valor de entre 0 (que representa el borde izquierdo de la imagen) y 1 (que representa el borde derecho). Si no se define, el valor predeterminado es 0,5.
  • El parámetro y especifica el punto de anclaje vertical del símbolo. Acepta un valor de entre 0 (que representa el borde superior de la imagen) y 1 (que representa el borde inferior). Si no se define, el valor predeterminado es 1.
  • El parámetro scale especifica la escala a la que se visualiza la imagen. Los valores inferiores a 1 escalan la imagen hacia abajo, mientras que los valores superiores a 1 escalan la imagen hacia arriba.
Estilo del símbolo para geopunto

El valor proporcionado puede ser una constante o una referencia a una pregunta, por ejemplo, symbol=${symbol_question}. Las expresiones en línea no son compatibles.

Superposiciones de puntos en mapas

Las ubicaciones de puntos de la primera pregunta geopoint en una repetición se pueden mostrar en cualquier pregunta de mapa de una encuesta, definiendo la columna body::esri:style para una pregunta geopoint, geotrace o geoshape como overlay=repeat_name. Todos los puntos capturados para la primera pregunta geopoint de esa repetición se muestran en el mapa. Se pueden utilizar parámetros adicionales para personalizar la simbología de superposición.

Estos parámetros opcionales son compatibles con el estilo de superposición y se pueden separar con el símbolo et (&), por ejemplo, overlay=repeat_name&preview=true:

ParámetroDescripciónEjemplo

vista

Muestre los puntos de superposición en la pregunta del mapa. El valor predeterminado es verdadero.

view=false

vista previa

Muestre los puntos de superposición en el mapa de vista previa. El valor predeterminado es false.

preview=true

icono

El nombre del símbolo de punto que se utilizará para las chinchetas de los mapas. Revise los símbolos disponibles en la biblioteca Símbolos de punto de la documentación de Esri Developer.

icon=esri_pin_two

iconColor

El color del icono utilizado para las chinchetas de los mapas. Este parámetro acepta un nombre de color estándar o un código de color hexadecimal. El valor predeterminado es el negro.

iconColor=Blue

iconOutlineColor

El color del contorno utilizado para las chinchetas de los mapas. Este parámetro acepta un nombre de color estándar o un código de color hexadecimal. El valor predeterminado es el blanco.

iconOutlineColor=#FF4500

iconSize

El tamaño del icono tal como aparece en el mapa. El valor predeterminado es 30.

iconSize=40

etiqueta

Nombre de la pregunta de la encuesta que se utilizará como etiqueta.

label=question_name

labelColor

El color de la etiqueta de un punto. Este parámetro acepta un nombre de color estándar o un código de color hexadecimal. El valor predeterminado es el negro.

labelColor=#FFD700

labelOutlineColor

El color del contorno de la etiqueta. Este parámetro acepta un nombre de color estándar o un código de color hexadecimal. El valor predeterminado es el blanco.

labelOutlineColor=Black

fontSize

El tamaño de fuente de la etiqueta para un punto. El valor predeterminado es 13.

fontSize=16

Estilo de pregunta

Puede configurar el mapa base, las herramientas de mapa y la altura de pregunta para las preguntas de mapa.

Es posible establecer un mapa base predeterminado para preguntas de mapa individuales usando el parámetro map en la columna body::esri:style. Por ejemplo, map="World Topography" establecerá que la pregunta de mapa utilice el mapa base Topografía mundial. También puede establecer el parámetro map utilizando el Id. de elemento del mapa, por ejemplo, map=de26a3cf4cc9451298ea173c4b324736. Este parámetro admite mapas en línea y fuera de línea, incluidos sus propios mapas web. Para obtener más información, consulte Incluir un mapa en una encuesta.

La columna body::esri:style acepta un parámetro mapTools para controlar las herramientas de mapa que están disponibles para las preguntas de mapa. Si no se establece ningún parámetro de herramienta de mapa, se mostrarán todas las herramientas. Se aceptan los siguientes valores:

  • mapTools=search
  • mapTools=mapSwitcher
  • mapTools=zoom
  • mapTools=home
  • mapTools=locate

Se pueden configurar varias herramientas separando cada valor con una coma, por ejemplo, mapTools=search,locate.

La columna body::esri:style acepta un parámetro height para preguntas de mapa.

Puede configurar la altura de una pregunta proporcionando el parámetro height con un número y, opcionalmente, una unidad. La unidad predeterminada es lines, que hace referencia a la altura de la fuente de texto de entrada actual. Por ejemplo, height=5 provoca que cualquiera de estas preguntas se muestre con una altura de cinco líneas.

Como alternativa, puede establecer la unidad en un porcentaje de la altura de pantalla o por número de píxeles, agregándolos como sufijo al valor sin dejar espacios. Por ejemplo, se aceptan los siguientes valores:

  • height=5
  • height=5lines
  • height=25%
  • height=250pixels

Las herramientas de altura y mapa se pueden configurar con un espacio entre ellas, por ejemplo, height=25% mapTools=search,zoom.

Nota:
Controlar las herramientas de mapa y altura de las preguntas no se admite en la aplicación web Survey123.