Подпись | Описание | Тип данных |
Входная папка | Папка, в которой расположены файлы изображений (.jpg и .tif). Файлы изображений в этой папке сканируются рекурсивно. Изображения, расположенные на корневом уровне папки, а также в любой подчиненной папке, добавляются в выходные данные. | Folder |
Выходной класс пространственных объектов | Выходной класс точечных объектов. | Feature Class |
Некорректная таблица фотографий (Дополнительный) | Путь к дополнительной выходной таблице, которая содержит список всех файлов изображений входной папки с некорректными метаданными EXIF или с пустыми или недействительными координатами. Если путь не указан, таблица не создается. | Table |
Включить фотографии без геометок (Дополнительный) | Указывает, будут ли все файлы фотографий включены в выходной класс объектов или только те, которые имеют допустимые координаты.
| Boolean |
Добавить фотографии как вложения (Дополнительный) | Указывает, добавляются ли входные фотографии к выходным объектам в виде вложений в базе геоданных. Лицензия:Для добавления вложений требуется лицензия ArcGIS Desktop Standard или ArcGIS Desktop Advanced, а также выходной класс пространственных объектов в базе геоданных версии 10 или более поздней.
| Boolean |
Краткая информация
Создает точки на основе информации о координатах x, y и z, хранящейся в метаданных файлов фотографий с геометками (.jpg или .tif). Вы можете добавить файлы фотографий к выходным объектам в качестве вложений базы геоданных.
Иллюстрация
Использование
Этот инструмент считывает информацию о координатах долготы, широты и высоты из файлов фотографий (.jpg или .tif) и записывает эти координаты и связанные с ними атрибуты в выходной класс точечных пространственных объектов.
Выходной класс пространственных объектов имеет следующие атрибутивные поля:
- 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})
Имя | Описание | Тип данных |
Input_Folder | Папка, в которой расположены файлы изображений (.jpg и .tif). Файлы изображений в этой папке сканируются рекурсивно. Изображения, расположенные на корневом уровне папки, а также в любой подчиненной папке, добавляются в выходные данные. | Folder |
Output_Feature_Class | Выходной класс точечных объектов. | Feature Class |
Invalid_Photos_Table (Дополнительный) | Путь к дополнительной выходной таблице, которая содержит список всех файлов изображений входной папки с некорректными метаданными EXIF или с пустыми или недействительными координатами. Если путь не указан, таблица не создается. | Table |
Include_Non-GeoTagged_Photos (Дополнительный) | Указывает, будут ли все файлы фотографий включены в выходной класс объектов или только те, которые имеют допустимые координаты.
| Boolean |
Add_Photos_As_Attachments (Дополнительный) | Указывает, добавляются ли входные фотографии к выходным объектам в виде вложений в базе геоданных. Лицензия:Для добавления вложений требуется лицензия ArcGIS Desktop Standard или ArcGIS Desktop Advanced, а также выходной класс пространственных объектов в базе геоданных версии 10 или более поздней.
| Boolean |
Пример кода
Следующий сниппет окна Python демонстрирует, как использовать функцию GeoTaggedPhotosToPoints.
import arcpy
arcpy.management.GeoTaggedPhotosToPoints("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.management.GeoTaggedPhotosToPoints(inFolder, outFeatures, badPhotosList,
photoOption, attachmentsOption)
arcpy.analysis.Buffer(outFeatures, buffers, bufferDist)