Вопросы типа Media

Вы можете включить в опросы вопросы с изображениями, аудио или другими файлами, чтобы пользователи могли отправлять вложения со своими ответами на опрос.

Подсказка:

Изображения и аудио также можно добавлять к другим вопросам в опрос для справки или в целях настройки оформления. Более подробную информацию см. в разделе Добавление медиа в опрос.

По умолчанию для вопросов с изображениями, аудио и другими файлами допускается одно вложение. Если задать оформление multiline в столбце appearance, можно включить несколько вложений.

Изображения

Вопрос типа изображение позволяет отправлять изображения, сохраненные на устройствах, либо фотографии, снятые на камеру устройства.

Фотография, сделанная в Survey123, сохраняется как файл .jpg с уровнем качества, зависящим от камеры вашего устройства. Размер изображения, измеряемый в пикселах по самому длинному краю, можно задать во вкладке Опции в Survey123 Connect. Этот размер применяется ко всем вопросам типа Изображение в опросе. Доступны следующие опции:

  • 320 пикселов
  • 640 пикселов
  • 1280 пикселов
  • 1920 пикселов
  • Опция Неограниченно позволяет прикрепить к опросу фотографию любого размера.)

По умолчанию размер изображения составляет 1280 пикселов. Отправленные изображения, сохраненные на устройстве, имеют свой исходный тип файла, разрешение и качество.

Размеры этих изображений не влияют на предварительный просмотр изображений в полевом приложении Survey123. Это управляется параметром previewHeight. Этот параметр поддерживает все типы устройств, поддерживаемые параметром height, но высота изображения предварительного просмотра в конечном счете ограничена шириной экрана устройства и соотношением сторон изображения. Используйте previewHeight=0, если хотите, чтобы изображения предварительного просмотра были максимального размера без ненужных пробелов.

Вы можете установить максимально допустимый размер изображения для каждого отдельного вопроса типа Изображение в опросе. Укажите max-pixels в столбце parameters в XLSForm для вопроса, которому вы хотите задать ограничение. Например, max-pixels=100 уменьшает масштаб изображения пропорционально 100 пикселам по самому длинному краю. Если параметр max-pixels не указан, используется размер изображения, установленный в Survey123 Connect.

Вопрос типа изображение может быть ограничен конкретным методом получения, задав method=camera или method=browse в столбце body::esri:style XLSForm. Вы также можете установить для оформления значение new-front или new-rear, чтобы ограничить вопрос типа изображение использованием только изображений с камеры устройства, используя по умолчанию фронтальную или заднюю камеру соответственно. Когда используется оформление annotate, вы можете также указать method=map.

Максимальный размер файла по умолчанию для отдельного изображения составляет 10 МБ. Для вопросов типа изображение в веб-приложении Survey123 можно задать максимальный размер файла в мегабайтах, используя max-size в столбце bind::esri:parameters. Например, max-size=5 позволяет пользователям прикреплять изображение размером до 5 МБ.

Примечание:

Максимальный размер файла для отдельного вложения, отправленного из приложения для полевых работ Survey123, составляет 10 МБ.

При применении к вопросам типа Изображение параметр max-size поддерживается только в веб-приложении Survey123. Максимальный размер файла не может превышать 100 МБ для ArcGIS Online и 20 МБ для ArcGIS Enterprise.

Вопросы с изображениями поддерживают другие виды оформления, позволяющие подписывать фотографии, рисовать или ставить подпись. Дополнительные сведения см. в разделе Оформление.

Имена файлов изображений

По умолчанию Survey123 автоматически создает имя файла для изображений, содержащихся в вопросе типа Изображение. Имя файла содержит имя вопроса в качестве префикса и уникальный номер. Для некоторых вопросов типа Изображение вы можете изменить имена файлов, чтобы сделать их более понятными. Например, вы можете включить имя и фамилию подписывающего лица в имя файла подписи. Для фотографии вы можете указать дату или описание объекта, который вы фотографируете.

Вы можете использовать параметр fileName в столбце bind::esri:parameters, чтобы динамически задать имя файла для следующего захваченного изображения. В следующем примере имя файла изображения состоит из значения из вопроса assets_id и текущей даты и времени:

Синтаксис имени файла изображения в XLSForm

Примеры синтаксиса см. в разделе Пример изображений и аннотаций в Survey123 Connect.

Имена файлов изображения должны соответствовать следующим требованиям:

  • Имена файлов должны быть уникальными для всех вопросов типа Изображение во всех опросах на устройстве. В папке Мои вложения к опросу хранятся все изображения для всех опросов на устройстве и она не может содержать файлы с одинаковыми именами. Чтобы убедиться в том, что имена файлов уникальны, рассмотрите возможность использования такой функции, как now() в выражении fileName.
  • Имена файлов не могут быть длиннее 140 символов.
  • Имена поля не должны содержать пробелов и следующих специальных символов: \ / : * ? < > ; | . , ". Пробелы и специальные символы будут заменены нижними подчеркиваниями.
Внимание:

Если выражение для параметра fileName приводит к тому, что имя файла становится неуникальным или превышается его максимальная длина, в Survey123 будет использоваться автоматически сгенерированное для изображения имя файла. Точно так же, когда пользователи вручную редактируют имя файла в опросе, это имя не будет принято, если оно дублируется или будет превышена его максимальная длина.

Следующие параметры могут использоваться в столбце body::esri:style для вопроса типа Изображение для дальнейшего управления именами файлов изображений:

  • fileNameVisible — указывает, будет ли имя файла отображаться в опросе. По умолчанию – true. Чтобы скрыть имя файла, введите fileNameVisible=false.
  • allowRename — указывает, разрешено ли пользователям редактировать имя файла вручную. По умолчанию – true. Пользователи не могут редактировать имя файла, когда fileNameVisible=false, даже если allowRename=true.

Извлечение метаданных изображения

Вы можете использовать функцию pulldata() для извлечения тегов метаданных стандарта Exchangeable Image File (EXIF) из ответа на вопрос с изображением. Ввод этого примера в вопрос с типом decimal извлекает из изображения, полученного с устройства, значение широты:

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

Часто используемые теги местоположений EXIF для использования с функционалом pulldata() перечислены в следующей таблице:

Тег XMLОписание

GpsLatitude

Широта местоположения устройства в виде строкового значения

GpsLongitude

Долгота местоположения устройства в виде строкового значения

GpsAltitude

Высота местоположения устройства в виде строкового значения

GpsLatitudeRef

Направление широты (например, С,В,Ю,З) местоположения устройства в виде строкового значения

GpsLongitudeRef

Направление долготы (например, С,В,Ю,З) местоположения устройства в виде строкового значения

GpsDestDistance

Расстояние между устройством и целевыми местоположениями, в километрах, в виде целочисленного

GpsImgDirection

Направление к целевому местоположению от местоположения устройства в виде строкового

GpsDestLatitude

Широта целевого местоположения в виде строкового значения

GpsDestLongitude

Долгота целевого местоположения в виде строкового значения

GpsDestLatitudeRef

Направление широты (например, С,В,Ю,З) целевого местоположения в виде строкового значения

GpsDestLongitudeRef

Направление долготы (например, С,В,Ю,З) целевого местоположения в виде строкового значения

Следующий пример можно использовать для отображения значений широты и долготы в одном поле, которое затем можно использовать для заполнения вопроса типа Геоточка:

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

Другие теги изображений EXIF, которые могут быть извлечены с помощью Survey123, перечислены ниже. В зависимости от используемого оборудования не все эти теги будут доступны.

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

Чтобы подробно ознакомиться с этими тегами, см. пример EXIF в разделе Survey123 Connect.

Внимание:

Если вопрос типа Изображение содержит несколько изображений, данные EXIF не могут быть извлечены из изображений с помощью функции pulldata("@exif"). Если вам необходимо извлечь данные EXIF из нескольких изображений одного вопроса, воспользуйтесь повтором.

Интеграция Spike

Вопросы с типом image также поддерживают интеграцию с решением Spike для лазерного измерения разработанного ikeGPS, которое позволяет захватывать измерения и местоположение объекта с фотографии. Дополнительные сведения об использовании Spike с Survey123 см. в разделе Внешний вид.

Spike записывает ряд дополнительных пользовательских тегов, внося объект JSON в EXIF-тег ImageDescription, содержащий нестандартные свойства, относящиеся к устройству Spike и измерениям, которые оно выполнило. Теги описаны в следующей таблице:

Тег SpikeОписание

device_id

ID устройства Spike в виде значения string

local_accuracy

Точность устройства Spike в виде значения decimal

destination_altitude

Высота целевого местоположения в виде значения rational

declination

Склонение устройства Spike в виде значения rational

pitch

Тангаж устройства Spike в виде значения rational

rotation

Поворот устройства Spike в виде значения string

objects

Массив JSON измеренных объектов (площадь и длина) в виде значения string

P2P.capture_id

ID двух изображений процесса точка-точка в виде значения string

P2P.horizontal_distance

Расстояние по горизонтали между двумя точками в метрах

P2P.distance

Расстояние между двумя точками в метрах

P2P.gradient

Градиент между двумя точками в градусах

P2P.vertical_distance

Расстояние по вертикали между двумя точками в метрах

P2P.azimuth

Азимут двух точек в градусах

Чтобы открыть эти теги Spike, сначала извлеките объект JSON, который хранится в EXIF, используя pulldata для свойства objects, как описано ниже:

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

После того как этот объект JSON перемещен в другое поле, можно использовать путь к имени свойства spike. для извлечения определенного значения из массива JSON. В следующем примере извлекается тангаж устройства Spike из вопроса с массивом внутри него:

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

Массив objects также содержит площади и длины, захваченные устройством Spike. Этот массив содержит измеренные на изображении объекты, включая фигуры и линии, а также форму выравнивания, используемую для преобразования изображения. Объекты в массиве могут быть извлечены путем ссылки на их положение в массиве – порядок, который соответствует порядку, в котором они были захвачены. В следующем примере возвращается первая площадь или линия в массиве:

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

Примечание:

Позиция 0 в массиве всегда содержит форму выравнивания.

Чтобы вернуть количество объектов, присутствующих в массиве, используйте свойство length следующим образом:

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

Примеры использования этих тегов см. в образце опроса Spike в Survey123 Connect. Дополнительную информацию о Spike см. на странице Продукты ikeGPS.

Аудио

Вопрос типа Аудио позволяет записывать и выгружать аудио в Survey123. Запись извлекается при помощи формата по умолчанию для вашего устройства. Строка состояния показывает, сколько времени записи осталось. Пользователи могут приостановить или завершить запись в любой момент. По завершении записи можно отредактировать имя файла, выбрав его.

Примечание:

Приостановка аудио во время записи в полевом приложении невозможно в Android.

В настоящее время выгрузка существующего аудиофайла доступна только в веб-приложении.

По умолчанию максимальный размер аудиозаписи ограничен 10 МБ в полевом приложении и 10 минутами в веб-приложении.

Можно задать меньший размер в мегабайтах с помощью параметра max-size в столбце bind::esri:parameters. Запись автоматически останавливается при достижении максимального размера файла. Например, max-size=5 позволит пользователю записывать до 5 МБ аудио.

Можно, кроме того, задать время в секундах в параметре max-duration в столбце bind::esri:parameters. Запись автоматически останавливается при достижении максимальной продолжительности. Например, max-duration=30 позволит пользователю записывать до 30 секунд аудио.

Внимание:
Максимальный размер файла для отдельного вложения, отправленного из приложения для полевых работ Survey123, составляет 10 МБ. Убедитесь, что установленный вами max-duration или max-size не приведет к тому, что аудиофайл превысит максимальный размер файла.

По умолчанию файлы на устройствах iOS и Android кодируются кодеком Advanced Audio Coding (AAC), если устройство его поддерживает. Можно задать подходящие аудиокодеки в параметре codec в столбце bind::esri:parameters. Можно ввести несколько кодеков, разделенных запятыми, например, codec=amr-nb,aac. Используется первый кодек, совместимый с устройством.

Примечание:

Кодеки, поддерживаемые устройством, перечислены на странице О программе полевого приложения Survey123. Нажмите и удерживайте баннер Powered by ArcGIS AppStudio в нижней части страницы О программе, чтобы открыть дополнительную информацию об устройстве, включая поддерживаемые им аудиокодеки. На устройствах Windows аудиофайлы всегда записываются в формате WAV без сжатия.

Вы также можете отправить аудио-файл, хранящийся на вашем устройстве, с помощью вопроса-файла. Список поддерживаемых типов аудиофайлов см. в разделе Файлы ниже.

Файлы

Вопрос типа Файл позволяет пользователям отправлять разные типы файлов.

Максимальный размер файла по умолчанию для отдельного изображения составляет 10 МБ. Для вопросов типа Файл в веб-приложении Survey123 можно задать максимальный размер файла в мегабайтах, используя max-size в столбце bind::esri:parameters. Например, max-size=5 позволяет пользователям прикреплять файл размером до 5 МБ.

Примечание:

Максимальный размер файла для отдельного вложения, отправленного из приложения для полевых работ Survey123, составляет 10 МБ.

При применении к вопросам типа Файл параметр max-size поддерживается только в веб-приложении Survey123. Максимальный размер файла не может превышать 100 МБ для ArcGIS Online и 20 МБ для ArcGIS Enterprise.

По умолчанию для вопроса типа файл разрешен один файл. Используйте multiline для столбца оформление, чтобы разрешить вложение нескольких файлов в вопрос типа файл.

Тип вопроса-файла принимает все типы вложения файлов, поддерживаемые ArcGIS Online и ArcGIS Enterprise. Поддерживаются следующие типы файлов:

КатегорияТип файла

Архив

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

Аудио

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

Данные

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

Документ

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

Изображение

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

Видео

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

*Данный тип вложения не поддерживается в ArcGIS Enterprise.

Вы можете ограничить типы файлов, которые могут быть отправлены в вопрос типа файл, используя столбец body::accept. В этом столбце разрешены как расширения файлов (например, .wav), так и типы MIME (например, audio/*). Можно задать несколько расширений файлов или типов MIME, разделив их запятыми.

Подробнее о принятых форматах для типов MIME см. Список распространенных типов MIME в Mozilla.


В этом разделе
  1. Изображения
  2. Аудио
  3. Файлы