Сводка
Создает точки на основе информации о координатах x, y и z, хранящейся в геопривязанных изображениях. По желанию, добавляет фото файлы к пространственным объектам в выходном классе в виде вложений в базе геоданных.
Иллюстрация
Использование
Этот инструмент считывает информацию о координатах долготы, широты и высоты из файлов фотографий и записывает эти координаты и связанные с ними атрибуты в выходной класс точечных пространственных объектов.
Выходной класс пространственных объектов имеет следующие атрибутивные поля:
- Path – полный путь к файлу изображений, который используется для создания точки, например, C:\data\photos\Pic0001.jpg.
- Name – короткое имя файла изображения, например, Pic0001.jpg.
- DateTime – дата и время создания файла изображения. Если выходной класс пространственных объектов является шейп-файлом, это поле будет иметь строковый тип данных. Если выходной класс пространственных объектов является базой геоданных, это поле будет типа Дата.
Присутствие в поле DateTime пустых ячеек или значений null может свидетельствовать о том, что ваше устройство не захватило пригодную для использования метку времени с фотографии. Файлы фотографий могут иметь информацию о дате создания или изменения файла, но они часто не предоставляют дату и время, когда была сделана фотография.
- Direction – направление, в котором устройство было ориентировано при получении снимка. Диапазон значений находится в пределах от 0 до 359.99, где 0 означает север, 90 – восток и т.д. Если устройство не записывает направление, то это поле будет иметь значение Null, 0 или -999999, в зависимости от устройства и указанного выходного местоположения. Значение направления может использовать градусы, отсчитанные от истинного или магнитного севера. Для получения более подробной информации см. документацию к устройству.
Примечание:
Следует с осторожностью использовать информацию о направлении в фотографиях с геометками, поскольку эти данные могут быть не точными. Для получения информации о точности данных о направлении см. документацию к устройству.
- X — координата x, в которой была сделана фотография.
- Y — координата y, в которой была сделана фотография.
- Z — высота в метрах, на которой была сделана фотография. Если устройство не записывает высоту, то это поле будет иметь значение Null, 0 или -999999, в зависимости от устройства и указанного выходного местоположения.
Выходные значения DateTime можно использовать для анализа и отображения выходного класса пространственных объектов во времени .
Выходные данные инструмента включают в себя диаграмму-график, показывающую временную шкалу фотографий, где количество отметок времени в поле DateTime отображается при помощи бинов даты и времени, которые вычисляются автоматически, но могут быть настроены.
Если координатами изображения x,y являются значения 0.0, для данного изображения точка не создается. Пустые координаты часто возникают из-за того, что устройство не имеет достаточного сигнала для захвата координат. Если был выбран параметр Включить фотографии без геометок (ALL_PHOTOS в скриптах Python), то фотографии добавляются как выходные объекты с пустой геометрией.
Выходной класс пространственных объектов имеет и вертикальную, и XY систему координат - GCS_WGS_1984, поскольку ее используют GPS-приемники.
Синтаксис
arcpy.management.GeoTaggedPhotosToPoints(Input_Folder, Output_Feature_Class, {Invalid_Photos_Table}, {Include_Non-GeoTagged_Photos}, {Add_Photos_As_Attachments})
Parameter | Объяснение | Тип данных |
Input_Folder | Папка, в которой расположены файлы изображений. Файлы изображений в этой папке сканируются рекурсивно. Изображения, расположенные на корневом уровне папки, а также в любой подчиненной папке, добавляются в выходные данные. | Folder |
Output_Feature_Class | Выходной класс точечных объектов. | Feature Class |
Invalid_Photos_Table (Дополнительный) | Дополнительная выходная таблица, которая содержит список всех файлов изображений входной папки с некорректными метаданными EXIF или с пустыми или недействительными координатами. Если путь не указан, таблица не создается. | Table |
Include_Non-GeoTagged_Photos (Дополнительный) | Указывает, будут ли все файлы фотографий включены в выходной класс объектов или только те, которые имеют допустимые координаты.
| Boolean |
Add_Photos_As_Attachments (Дополнительный) | Указывает, добавляются ли входные фотографии к выходным объектам в виде вложений в базе геоданных. Лицензия:Для добавления вложений требуется лицензия не ниже ArcGIS Desktop Standard, а также выходной класс пространственных объектов в базе геоданных версии не ниже 10.
| Boolean |
Пример кода
Следующий сниппет окна Python демонстрирует, как использовать инструмент GeoTaggedPhotosToPoints.
import arcpy
arcpy.GeoTaggedPhotosToPoints_management("c:/data/photos",
"c:/data/city.gdb/photo_points", "",
"ONLY_GEOTAGGED", "ADD_ATTACHMENTS")
Следующий скрипт демонстрирует работу инструмента GeoTaggedPhotosToPoints.
"""Name: GeoTaggedPhotosToPoints example
Description: Convert a folder of photos to points, then perform a buffer
"""
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inFolder = "photos"
outFeatures = "city.gdb/photos_points"
badPhotosList = "city.gdb/photos_noGPS"
photoOption = "ONLY_GEOTAGGED"
attachmentsOption = "ADD_ATTACHMENTS"
buffers = "city.gdb/photos_points_buffer"
bufferDist = "1 Miles"
arcpy.GeoTaggedPhotosToPoints_management(inFolder, outFeatures, badPhotosList,
photoOption, attachmentsOption)
arcpy.Buffer_analaysis(outFeatures, buffers, bufferDist)
Информация о лицензиях
- Basic: Ограничено
- Standard: Да
- Advanced: Да