Вы можете включить в опросы вопросы с изображениями, аудио или другими файлами, чтобы пользователи могли отправлять вложения со своими ответами на опрос.
Подсказка:
Изображения и аудио также можно добавлять к другим вопросам в опрос для справки или в целях настройки оформления. Более подробную информацию см. в разделе Добавление медиа в опрос.
По умолчанию для вопросов с изображениями, аудио и другими файлами допускается одно вложение. Если задать оформление 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 автоматически создает имя файла для изображений, содержащихся в вопросе. Имя файла содержит имя вопроса в качестве префикса и уникальный номер. Для некоторых вопросов вы можете изменить имена файлов, чтобы сделать их более понятными. Подробнее см. Настройка имен файлов. Если данные опроса экспортируются и публикуются как векторный слой, для повторного использования в Survey123 рекомендуется не изменять имена файлов. Дополнительные сведения см. в разделе Ключевые слова.
Извлечение метаданных изображения
Вы можете использовать функцию pulldata("@exif") для извлечения тегов метаданных стандарта Exchangeable Image File (EXIF) из ответа на вопрос с изображением. Ввод этого примера в вопрос с типом decimal извлекает из изображения, полученного с устройства, значение широты:
pulldata("@exif", ${image}, "GpsLatitude")
Часто используемые теги местоположений EXIF для использования с функционалом pulldata("@exif") перечислены в следующей таблице:
| Тег 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("@exif") для свойства objects, как описано ниже:
pulldata("@exif", ${image}, "objects")
После того как этот объект JSON перемещен в другое поле, можно использовать путь к имени объекта Spike. в функции pulldata("@json") для извлечения определенного значения из массива JSON. Подробнее о функции pulldata("@json") см. Получение значения из 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. Нажмите и удерживайте заголовок Об ArcGIS Survey123 в верхней части страницы О программе, чтобы открыть дополнительную информацию об устройстве, включая поддерживаемые им аудиокодеки. На устройствах Windows аудиофайлы всегда записываются в формате WAV без сжатия.
Вы также можете отправить аудио-файл, хранящийся на вашем устройстве, с помощью вопроса-файла. Список поддерживаемых типов аудио файлов см. в разделе Файлы.
По умолчанию Survey123 автоматически создает имя файла для аудио, содержащихся в вопросе. Имя файла содержит имя вопроса в качестве префикса и уникальный номер. Для некоторых вопросов вы можете изменить имена файлов, чтобы сделать их более понятными. Подробнее см. Настройка имен файлов. Если данные опроса экспортируются и публикуются как векторный слой, для повторного использования в Survey123 рекомендуется не изменять имена файлов. Дополнительные сведения см. в разделе Ключевые слова.
Файлы
Вопрос типа Файл позволяет пользователям отправлять разные типы файлов.
Максимальный размер файла по умолчанию для отдельного изображения составляет 10 МБ. Для вопросов типа Файл в веб-приложении Survey123 можно задать максимальный размер файла в мегабайтах, используя max-size в столбце bind::esri:parameters. Например, max-size=5 позволяет пользователям прикреплять файл размером до 5 МБ.
Примечание:
Максимальный размер файла для отдельного вложения, отправленного из приложения для полевых работ Survey123, составляет 10 МБ.
При применении к вопросам типа Файл параметр max-size поддерживается только в веб-приложении Survey123. Максимальный размер не может превышать 500 МБ для 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.
По умолчанию Survey123 автоматически создает имя файла для файлов, содержащихся в вопросе. Имя файла содержит имя вопроса в качестве префикса и уникальный номер. Вы можете изменить имена файлов, чтобы сделать их более понятными. Подробнее см. Настройка имен файлов. Если данные опроса экспортируются и публикуются как векторный слой, для повторного использования в Survey123 рекомендуется не изменять имена файлов. Дополнительные сведения см. в разделе Ключевые слова.
Ключевые слова
Survey123 использует ключевые слова вложений, чтобы связать вложения с определенными вопросами опроса. Когда вы создаете вопрос в виде изображения, аудио или файла в опросе и публикуете его, имя вопроса используется в качестве ключевого слова в таблице вложений. Например, если опрос содержит вопросы об изображениях с именами image_closeup и image_wideview, значение, хранящееся в столбце KEYWORDS таблицы вложений, будет либо image_closeup, либо image_wideview для каждой фотографии. Survey123 автоматически сопоставляет ключевое слово вложения с именем вопроса, чтобы связать вложения с вопросами.
Цель соединения ключевых слов наиболее очевидна при печати отчетов; Survey123 гарантирует, что правильная фотография будет напечатана в качестве ответа на правильный вопрос в опросе. Соединение ключевых слов также используется, чтобы иметь возможность редактирования Изображений во Входящих.
Если вы измените имя вопроса типа Изображение и повторно опубликуете опрос, вы также должны изменить ключевое слово для всех существующих записей вложений.
Внимание:
При экспорте данных Survey123 столбец KEYWORDS таблицы вложений не сохраняется.
Если эти данные затем повторно публикуются в виде размещенного сервиса объектов, у вас есть один вопрос типа Изображение, а для вложений используются имена файлов по умолчанию, вы можете использовать скрипт Обновить ключевые слова вложений блокнота Python, чтобы повторно заполнить столбец KEYWORDS. Если в вашем опросе есть более одного вопроса типа Изображение, вы не можете использовать блокнот и должны вручную определить, какой файл связан с каким вопросом, и ввести название вопроса в столбец KEYWORDS для каждой записи вложения. Более подробно см. в этой статье Техническая поддержка.
Если эти данные повторно публикуются в виде сервиса объектов ArcGIS Server, вы должны в первую очередь добавить столбец KEYWORDS в таблицу вложений. Вы можете использовать инструмент Обновить вложения, чтобы добавить этот столбец. Если у вас есть один вопрос типа Изображение, а для вложений используются имена файлов по умолчанию, вы можете использовать скрипт Обновить ключевые слова вложений блокнота Python, чтобы повторно заполнить столбец KEYWORDS. Если в вашем опросе есть более одного вопроса типа Изображение, вы не можете использовать блокнот и должны вручную определить, какой файл связан с каким вопросом, и ввести название вопроса в столбец KEYWORDS для каждой записи вложения. Более подробно см. в этой статье Техническая поддержка.
В любой среде, когда вы в следующий раз просматриваете эти записи в Survey123, значение ключевого слова в таблице вложений будет соответствовать имени вопроса, а связь будет установлена автоматически.
Настройка имен файлов.
По умолчанию Survey123 автоматически создает имя файла для изображений, аудио и файлов, содержащихся в вопросе. Имя файла содержит имя вопроса в качестве префикса и уникальный номер. Вы можете изменить имена файлов, чтобы сделать их более понятными. Например, вы можете включить имя и фамилию подписывающего лица в имя файла подписи. Для фотографии вы можете указать дату или описание объекта, который вы фотографируете.
Внимание:
Настраиваемые имена файлов поддерживаются для вопросов изображений, аудио и файлов в веб-приложении. Настраиваемые имена файлов поддерживаются для вопросов изображений только в полевом приложении.
Индивидуальные имена файлов задаются по мере добавления файла к вопросу типа media и не обновляются автоматически, чтобы отразить последующие изменения в опросе. Например, если имя файла ссылается на текстовый вопрос и значение этого вопроса изменилось после добавления файла, имя файла не будет обновлено, чтобы отразить это изменение.
Вы можете использовать параметр fileName в столбце bind::esri:parameters, чтобы динамически задать имя файла для создаваемого файла. В следующем примере имя файла изображения ASSET406-20221018145109.jpg состоит из вопроса assets_id и текущей даты и времени:
Примеры синтаксиса см. в разделе Пример изображений и аннотаций в Survey123 Connect.
Имена файлов должны соответствовать следующим требованиям:
- Имена файлов должны быть уникальными для всех вопросов во всех опросах на устройстве. В папке Мои вложения к опросу хранятся все изображения для всех опросов на устройстве и она не может содержать файлы с одинаковыми именами. Чтобы убедиться в уникальности имен, воспользуйтесь функцией now() в выражении fileName.
- Имена файлов не могут быть длиннее 140 символов.
- Имена поля не должны содержать пробелов и следующих специальных символов: \ / : * ? < > ; | . , ". Пробелы и специальные символы будут заменены нижними подчеркиваниями.
Внимание:
В полевом приложении, если выражение для параметра fileName приводит к тому, что имя файла становится неуникальным или превышается его максимальная длина, будет использоваться автоматически сгенерированное для изображения имя файла. Точно так же, когда пользователи вручную редактируют имя файла в опросе, это имя не будет принято, если оно дублируется или будет превышена его максимальная длина.
В веб-приложении, если выражение для параметра fileName, либо ручная правка имени файла приводит к дублированию, следующий по порядку номер будет присвоен к новому имени файла.
Следующие параметры могут использоваться в столбце body::esri:style для вопроса для дальнейшего управления именами файлов:
- fileNameVisible — указывает, будет ли имя файла отображаться в опросе. По умолчанию – true. Чтобы скрыть имя файла, введите fileNameVisible=false.
- allowRename — указывает, разрешено ли пользователям редактировать имя файла вручную. По умолчанию – true. Пользователи не могут редактировать имя файла, когда fileNameVisible=false, даже если allowRename=true.