Preguntas sobre elementos multimedia

Puede incluir preguntas de imagen, audio y archivo en sus encuestas para que los usuarios puedan enviar adjuntos con las respuestas de la encuesta.

Sugerencia:

También se puede agregar audio e imágenes a otras preguntas de una encuesta a modo de referencia y por razones de estilo. Para obtener más información, consulte Agregar contenido multimedia a una encuesta.

De forma predeterminada, las preguntas de imagen, audio y archivo permiten un adjunto. Al definir su apariencia como multiline en la columna appearance, se pueden incluir varios adjuntos.

Imágenes

El tipo de pregunta de imagen permite a los usuarios enviar imágenes guardadas en su dispositivo o fotos tomadas con la cámara de su dispositivo.

Las fotos tomadas en Survey123 se guardan como archivos .jpg, con un nivel de calidad que depende de la cámara del dispositivo. El tamaño de imagen, medido por los píxeles del borde más largo, se puede definir en la pestaña Opciones de Survey123 Connect. Este tamaño se aplica a todas las preguntas de imagen de la encuesta. Las siguientes opciones están disponibles:

  • 320 píxeles
  • 640 píxeles
  • 1280 píxeles
  • 1920 píxeles
  • Sin restricción: (se pueden adjuntar a la encuesta fotos de cualquier tamaño).

El tamaño de imagen predeterminado es 1280 píxeles. Las imágenes enviadas que estaban guardadas en el dispositivo conservan su tipo de archivo, resolución y calidad originales.

Estos tamaños de imagen no afectan a la vista previa de la imagen proporcionada en la aplicación de campo Survey123. Se puede controlar con el parámetro previewHeight. Este parámetro admite todos los tipos de unidades admitidos por el parámetro height, pero la altura de la imagen de vista previa está limitada en último término por la anchura de la pantalla del dispositivo y por la relación de aspecto de la imagen. Use previewHeight=0 si desea que la vista previa de imagen tenga el máximo tamaño sin ningún espacio en blanco innecesario.

Puede definir el tamaño máximo permitido de una imagen para cada pregunta de imagen individual de una encuesta. Especifique max-pixels en la columna parameters del XLSForm para la pregunta que desee limitar. Por ejemplo, max-pixels=100 reduce la escala de la imagen proporcionalmente a 100 píxeles en el borde más largo. Si no se especifica el parámetro max-pixels, se utiliza el tamaño de imagen establecido en Survey123 Connect.

Puede limitar una pregunta de imagen a un método de captura determinado especificando method=camera o method=browse en la columna body::esri:style del XLSForm. También puede definir la apariencia como new-front o new-rear para que una pregunta de imagen esté limitada a usar solamente imágenes de la cámara del dispositivo, usando la cámara de frontal o posterior, respectivamente, como predeterminada. Cuando se utiliza la apariencia annotate, también puede especificar method=map.

El tamaño máximo predeterminado de una imagen individual es de 10 MB. Para preguntas de imagen en la aplicación web Survey123, puede especificar el tamaño máximo de archivo en megabytes utilizando max-size en la columna bind::esri:parameters. Por ejemplo, max-size=5 permite a los usuarios adjuntar una imagen de hasta 5 MB de tamaño.

Nota:

El tamaño máximo de archivo para un adjunto individual enviado desde la aplicación de campo Survey123 es de 10 MB.

Cuando se aplica a las preguntas de imagen, el parámetro max-size solo se admite en la aplicación web de Survey123. El tamaño máximo no puede superar los 100 MB para ArcGIS Online y los 20 MB para ArcGIS Enterprise.

Las preguntas de imagen también admiten otras apariencias que le permiten anotar las fotos, dibujar en un lienzo o estampar una firma. Para obtener más información, consulte Apariencia.

Nombres de archivos de imagen

De forma predeterminada, Survey123 genera automáticamente un nombre de archivo para las imágenes enviadas en una pregunta de imagen. El nombre de archivo incluye el nombre de pregunta como prefijo, seguido de un número único. Es posible que quiera personalizar los nombres de archivo de algunas preguntas de imagen para que sean más representativos. Por ejemplo, puede incluir el nombre y los apellidos del firmante en un nombre de archivo de firma. Para una foto, puede incluir la fecha o un descriptor del objeto que está fotografiando.

Puede utilizar el parámetro fileName de la columna bind::esri:parameters para establecer dinámicamente el nombre de archivo de la siguiente imagen que se va a capturar. En el siguiente ejemplo, el nombre del archivo de imagen se compone del valor de la pregunta asset_id y de la fecha y hora actuales:

Sintaxis del nombre de archivo de imagen en XLSForm

Consulte ejemplos de sintaxis en la muestra de Imágenes y Anotación en Survey123 Connect.

Los nombres de archivos de imagen deben cumplir los siguientes requisitos:

  • Los nombres de archivo de todas las preguntas de imagen de todas las encuestas del dispositivo deben ser únicos. La carpeta My Survey Attachments almacena todas las imágenes de todas las encuestas del dispositivo y no puede contener nombres de archivo duplicados. Para asegurarse de que los nombres de archivo son únicos, plantéese utilizar una función como now() en la expresión fileName.
  • Los nombres de archivo no pueden tener más de 140 caracteres.
  • Los nombres de archivo no pueden contener espacios ni los siguientes caracteres especiales: \ / : * ? < > ; | . , ". Los espacios y los caracteres especiales se sustituirán por un guion bajo.
Precaución:

Si la expresión del parámetro fileName da como resultado un nombre de archivo duplicado o que supera la longitud máxima, el nombre de archivo generado automáticamente para la imagen se utilizará en Survey123. De forma similar, si los usuarios editan manualmente el nombre de archivo en la encuesta, el nombre de archivo no se aceptará si está duplicado o supera la longitud máxima.

Para controlar más los nombres de los archivos de imagen, es posible aplicar los siguientes parámetros en la columna body::esri:style correspondiente a una pregunta de imagen:

  • fileNameVisible: especifica si el nombre del archivo será visible en la encuesta. El valor predeterminado es true. Para ocultar el nombre de archivo, escriba fileNameVisible=false.
  • allowRename: especifica si los usuarios pueden editar el nombre del archivo manualmente. El valor predeterminado es true. Los usuarios no pueden editar el nombre de archivo si fileNameVisible=false, incluso si allowRename=true.

Extraer metadatos de la imagen

Puede usar la función pulldata() para extraer etiquetas de metadatos estándar de archivo de imagen intercambiable (EXIF) de la respuesta a una pregunta de imagen. Al introducir el siguiente ejemplo en una pregunta decimal, se extrae el valor de latitud del dispositivo de una imagen:

pulldata("@exif", ${image}, "GpsLatitude")

Las etiquetas EXIF de ubicación que se suelen utilizar con la funcionalidad pulldata() se enumeran en la siguiente tabla:

Etiqueta EXIFDescripción

GpsLatitude

La latitud de la ubicación del dispositivo como una cadena de caracteres

GpsLongitude

La longitud de la ubicación del dispositivo como una cadena de caracteres

GpsAltitude

La altitud de la ubicación del dispositivo como una cadena de caracteres

GpsLatitudeRef

La referencia de latitud (es decir, N,E,S,O) de la ubicación del dispositivo como cadena de caracteres

GpsLongitudeRef

La referencia de longitud (es decir, N,E,S,O) de la ubicación del dispositivo como cadena de caracteres

GpsDestDistance

La distancia entre el dispositivo y las ubicaciones de destino, en kilómetros, como un entero

GpsImgDirection

La dirección hacia la ubicación de destino desde la ubicación del dispositivo como una cadena de caracteres

GpsDestLatitude

La latitud de la ubicación del destino como una cadena de caracteres

GpsDestLongitude

La longitud de la ubicación del destino como una cadena de caracteres

GpsDestLatitudeRef

La referencia de latitud (es decir, N,E,S,O) de la ubicación de destino como cadena de caracteres

GpsDestLongitudeRef

La referencia de longitud (es decir, N,E,S,O) de la ubicación de destino como cadena de caracteres

El siguiente ejemplo se puede usar para mostrar los valores de latitud y longitud en un solo campo que, a su vez, se puede usar para rellenar una pregunta geopoint:

string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))

A continuación, se enumeran otras etiquetas EXIF de imagen que Survey123 puede extraer. En función del hardware utilizado, no todas estas etiquetas estarán disponibles.

GpsAltitudeRef

GpsTimeStamp

GpsSatellites

GpsStatus

GpsMeasureMode

GpsDop

GpsSpeedRef

GpsSpeed

GpsTrackRef

GpsTrack

GpsImgDirectionRef

GpsMapDatum

GpsDestBearingRef

GpsDestBearing

GpsDestDistanceRef

GpsProcessingMethod

GpsAreaInformation

GpsDateStamp

GpsVersionId

GpsDifferential

GpsHPositioningError

ImageWidth

ImageLength

ImageBitsPerSample

ImageCompression

ImagePhotometricInterpretation

ImageDescription

ImageMake

ImageModel

ImageStripOffsets

ImageOrientation

ImageSamplesPerPixel

ImageRowsPerStrip

ImageStripByteCounts

ImageXResolution

ImageYResolution

ImagePlanarConfiguration

ImageResolutionUnit

ImageTransferFunction

ImageSoftware

ImageDateTime

ImageArtist

ImageWhitePoint

ImagePrimaryChromaticities

ImageYCbCrCoefficients

ImageYCbCrSubSampling

ImageYCbCrPosition

ImageReferenceBlackWhite

ImageRating

ImageRatingPercent

ImageCopyright

ImageXPTitle

ImageXPComment

ImageXPAuthor

ImageXPKeywords

ImageXPSubject

ImageLensSpecification

ImageLensModel

ImageLensMake

ImageLensSerialNumber

ExtendedSubjectDistanceRange

ExtendedExposureTime

ExtendedFNumber

ExtendedExposureProgram

ExtendedSpectralSensitivity

ExtendedISOSpeedRatings

ExtendedOecf

ExtendedExifVersion

ExtendedDateTimeOriginal

ExtendedDateTimeDigitized

ExtendedComponentsConfiguration

ExtendedCompressedBitsPerPixel

ExtendedShutterSpeedValue

ExtendedApertureValue

ExtendedBrightnessValue

ExtendedExposureBiasValue

ExtendedMaxApertureValue

ExtendedSubjectDistance

ExtendedMeteringMode

ExtendedLightSource

ExtendedFlash

ExtendedFocalLength

ExtendedSubjectArea

ExtendedMakerNote

ExtendedUserComment

ExtendedSubSecTime

ExtendedSubSecTimeOriginal

ExtendedSubSecTimeDigitized

ExtendedFlashPixVersion

ExtendedColorSpace

ExtendedPixelXDimension

ExtendedPixelYDimension

ExtendedRelatedSoundFile

ExtendedFlashEnergy

ExtendedSpatialFrequencyResponse

ExtendedFocalPlaneXResolution

ExtendedFocalPlaneYResolution

ExtendedFocalPlaneResolutionUnit

ExtendedSubjectLocation

ExtendedExposureIndex

ExtendedSensingMethod

ExtendedFileSource

ExtendedSceneType

ExtendedCfaPattern

ExtendedCustomRendered

ExtendedExposureMode

ExtendedWhiteBalance

ExtendedDigitalZoomRatio

ExtendedFocalLengthIn35mmFilm

ExtendedSceneCaptureType

ExtendedGainControl

ExtendedContrast

ExtendedSaturation

ExtendedSharpness

ExtendedDeviceSettingDescription

ExtendedImageUniqueId

Para ver estas etiquetas en detalle, consulte la muestra EXIF en Survey123 Connect.

Precaución:

Si una pregunta de imagen contiene varias imágenes, los datos EXIF no se pueden extraer de las imágenes utilizando la función pulldata("@exif"). Si necesita extraer datos EXIF de varias imágenes enviadas a la misma pregunta, plantéese utilizar una repetición.

Integración de Spike

Las preguntas de imagen también admiten la integración con la solución de medición láser Spike desarrollada por ikeGPS, que le permite capturar las mediciones y la ubicación de un objeto a partir de una foto. Para obtener información sobre cómo utilizar Spike con Survey123, consulte Apariencia.

Spike registra un número de etiquetas personalizadas adicionales escribiendo un objeto JSON a la etiqueta EXIF ImageDescription que contiene propiedades no estándares relacionadas con el dispositivo Spike y las mediciones que ha tomado. Estas etiquetas se describen en la siguiente tabla:

Etiqueta SpikeDescripción

device_id

El Id. del dispositivo Spike como una cadena de caracteres

local_accuracy

La precisión del dispositivo Spike como un decimal

destination_altitude

La altitud de la ubicación de destino como un valor racional

declination

La declinación del dispositivo Spike como un valor racional

pitch

La inclinación del dispositivo Spike como un valor racional

rotation

La rotación del dispositivo Spike como una cadena de caracteres

objects

Una matriz JSON de los objetos medidos (área y longitudes) como una cadena de caracteres

P2P.capture_id

El Id. de las dos imágenes del proceso de punto a punto como una cadena de caracteres

P2P.horizontal_distance

La distancia horizontal entre los dos puntos en metros

P2P.distance

La distancia entre los dos puntos en metros

P2P.gradient

El gradiente entre los dos puntos en grados

P2P.vertical_distance

La distancia vertical entre los dos puntos en metros

P2P.azimuth

El acimut de los dos puntos en grados

Para acceder a estas etiquetas de Spike, primero extraiga el objeto JSON almacenado en EXIF mediante pulldata en la propiedad objects, como se muestra a continuación:

pulldata("@exif", ${image}, "objects")

Una vez que este objeto JSON está en otro campo, puede usar la ruta de nombre de la propiedad spike. para extraer un valor específico de la matriz JSON. El siguiente ejemplo extrae la inclinación del dispositivo Spike desde la pregunta con la matriz incluida:

pulldata("@json", ${spikedata}, "Spike.pitch")

La matriz objects también contiene las áreas y las longitudes capturadas por el dispositivo Spike. Este conjunto contiene los objetos medidos de la imagen, incluidas las formas y líneas, así como una forma de alineación utilizada para la transformación de imágenes. Los objetos del conjunto se pueden extraer haciendo referencia a su posición en el conjunto, un orden que corresponde al orden en que se capturaron. El siguiente ejemplo devuelve la primera línea o área de la matriz:

pulldata("@json", ${spikedata}, "Spike.objects[1].type")

Nota:

La posición 0 del conjunto siempre contiene la forma de alineación.

Para devolver la cantidad de objetos presentes en la matriz, use la propiedad length de este modo:

pulldata("@json", ${spikedata}, "Spike.objects.length")

Para ver ejemplos de estas etiquetas en uso, consulte la encuesta de muestra de Spike en Survey123 Connect. Para obtener más información sobre Spike, consulte la página de productos de ikeGPS.

Audio

El tipo de pregunta de audio permite a los usuarios grabar y cargar audio en Survey123. Con ello se captura un archivo de audio mediante el formato de captura de audio predeterminado de su dispositivo. La barra de progreso indica el tiempo de grabación que queda. Los usuarios pueden detener o poner en pausa la grabación en cualquier momento. Una vez que concluya la grabación, podrá editar el nombre del archivo seleccionándolo.

Nota:

En Android, no está permitido poner el audio en pausa mientras se está grabando en la aplicación de campo.

En este momento, la carga de un archivo de audio existente solo está disponible en la aplicación web.

De forma predeterminada, las grabaciones de audio están limitadas a un tamaño máximo de archivo de 10 MB en la aplicación de campo y a 10 minutos en la aplicación web.

Puede establecer un límite de tamaño menor en megabytes mediante el parámetro max-size de la columna bind::esri:parameters. La grabación se detiene automáticamente cuando se alcanza el tamaño máximo de archivo. Por ejemplo, max-size=5 permite a los usuarios grabar hasta 5 MB de audio.

Como alternativa, puede especificar un límite de tiempo en segundos mediante el parámetro max-duration de la columna bind::esri:parameters. La grabación se detiene automáticamente cuando se alcanza la duración máxima. Por ejemplo, max-duration=30 permite a los usuarios grabar hasta 30 segundos de audio.

Precaución:
El tamaño máximo de archivo para un adjunto individual enviado desde la aplicación de campo Survey123 es de 10 MB. Asegúrese de que el valor de max-duration o max-size que establezca no haga que el archivo de audio supere el tamaño máximo de archivo.

Los archivos de audio se codifican de forma predeterminada en los dispositivos iOS y Android mediante el códec Codificación de audio avanzada (AAC, Advanced Audio Coding), si el dispositivo lo permite. Puede especificar los códecs de audio que prefiera mediante el parámetro codec de la columna bind::esri:parameters. Se pueden proporcionar varios códecs separados por comas; por ejemplo, codec=amr-nb,aac. Se utiliza el primer códec compatible con el dispositivo.

Nota:

Los códecs admitidos por el dispositivo se muestran en la página Acerca de de la aplicación de campo Survey123. Pulse y mantenga pulsado el banner Con tecnología de ArcGIS AppStudio situado al final de la página Acerca de para mostrar información adicional sobre el dispositivo, incluidos los códecs de audio que admite. En dispositivos Windows, los archivos de audio siempre se graban en formato WAV sin comprimir.

También puede enviar un archivo de audio almacenado en su dispositivo utilizando una pregunta de archivo. Para obtener una lista de los tipos de archivos de audio admitidos, consulte la sección Archivos a continuación.

Archivos

El tipo de pregunta de archivo permite a los usuarios enviar una variedad de tipos de archivos.

El tamaño máximo predeterminado de un archivo individual es de 10 MB. Para preguntas de archivo en la aplicación web Survey123, puede especificar el tamaño máximo de archivo en megabytes utilizando max-size en la columna bind::esri:parameters. Por ejemplo, max-size=5 permite a los usuarios adjuntar un archivo de hasta 5 MB de tamaño.

Nota:

El tamaño máximo de archivo para un adjunto individual enviado desde la aplicación de campo Survey123 es de 10 MB.

Cuando se aplica a las preguntas de archivo, el parámetro max-size solo se admite en la aplicación web de Survey123. El tamaño máximo no puede superar los 100 MB para ArcGIS Online y los 20 MB para ArcGIS Enterprise.

De forma predeterminada, una pregunta de archivo permite un solo archivo. Use multiline en la columna appearance para permitir adjuntar varios archivos a una pregunta de archivo.

El tipo de pregunta de archivo acepta todos los tipos de archivo adjunto admitidos por ArcGIS Online y ArcGIS Enterprise. Los tipos de archivos compatibles son los siguientes:

CategoríaTipo de archivo

Archivar

7Z, GTAR, GZ, TAR, TGZ, ZIP

Audio

AIF, M4A, MID, MP2, MP3, MPA, RA, RAM, RMI, WAV, WMA

Datos

CSV, GEODATABASE, GEOJSON, GML, GPKG*, JSON, MDB, PBF*, SD*, VRML, XML

Documento

DOC, DOCX, DOT, PDF, PPT, PPTX, TXT, WPS, XLS, XLSX, XLT

Imagen

BMP, ECW, EMF, EPS, GIF, IMG, J2K, JP2, JPC, JPE, JPEG, JPF, JPG, PNG, PS, PSD, RAW, SID, TIF, TIFF, WMF

Vídeo

AVI, MOV, MP4, MPE, MPEG, MPG, MPV2, QT, WMV

*Este tipo de adjunto no se admite en ArcGIS Enterprise.

Puede limitar los tipos de archivo que se pueden enviar a una pregunta de archivo con la columna body::accept. Esta columna acepta tanto extensiones de archivo (por ejemplo, .wav) como tipos MIME (por ejemplo, audio/*). Es posible establecer varias extensiones de archivo o tipos MIME separándolos con comas.

Para obtener información sobre formatos aceptados para tipos MIME, consulte la Lista de Mozilla de tipos MIME comunes.


En este tema
  1. Imágenes
  2. Audio
  3. Archivos