Фотографии с геометками в точки (Управление данными)

Краткая информация

Создает точки на основе информации о координатах 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, для данного изображения точка не создается. Пустые координаты могут возникать из-за того, что устройство не имеет достаточного сигнала для захвата координат. Если был выбран параметр Включить фотографии без геометок, то фотографии добавляются как выходные объекты с пустой геометрией.

  • Выходной класс пространственных объектов имеет и вертикальную, и XY систему координат - GCS_WGS_1984, поскольку ее используют GPS-приемники.

Параметры

ПодписьОписаниеТип данных
Входная папка

Папка, в которой расположены файлы изображений (.jpg и .tif). Файлы изображений в этой папке сканируются рекурсивно. Изображения, расположенные на корневом уровне папки, а также в любой подчиненной папке, добавляются в выходные данные.

Folder
Выходной класс объектов

Выходной класс точечных объектов.

Feature Class
Некорректная таблица фотографий
(Дополнительный)

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

Если значение не задано, таблица создана не будет.

Table
Включить фотографии без геометок
(Дополнительный)

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

  • Отмечено - в выходной класс пространственных объектов добавляются все фотографии. Если файл изображений не содержит сведений о координатах, он добавляется в виде объекта с пустой геометрией. Это значение по умолчанию
  • Не отмечено - в выходной класс пространственных объектов добавляются только фотографии с корректной информацией о координатах.
Boolean
Добавить фотографии как вложения
(Дополнительный)

Указывает, добавляются ли входные фотографии к выходным объектам в виде вложений в базе геоданных.

Примечание:

Для добавления вложений требуется чтобы выходной класс пространственных объектов был в базе геоданных версии 10 или более новой.

  • Проверено - фотографии будут добавлены к выходным объектам в виде вложений в базе геоданных, скопированных в базу геоданных. Это значение по умолчанию
  • Не отмечено - фотографии не добавляются в выходные объекты в виде вложений в базе геоданных.
Boolean

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
(Дополнительный)

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

  • ALL_PHOTOSВ выходной класс пространственных объектов добавляются все фотографии. Если файл изображений не содержит сведений о координатах, он добавляется в виде объекта с пустой геометрией. Это значение по умолчанию
  • ONLY_GEOTAGGEDВ выходной класс пространственных объектов добавляются только фотографии с корректной информацией о координатах.
Boolean
Add_Photos_As_Attachments
(Дополнительный)

Указывает, добавляются ли входные фотографии к выходным объектам в виде вложений в базе геоданных.

Примечание:

Для добавления вложений требуется чтобы выходной класс пространственных объектов был в базе геоданных версии 10 или более новой.

  • ADD_ATTACHMENTSФотографии будут добавлены к выходным объектам в виде вложений базы геоданных, скопированных в базу геоданных. Это значение по умолчанию
  • NO_ATTACHMENTSФотографии не добавляются к выходным объектам в виде вложений базы геоданных.
Boolean

Пример кода

GeoTaggedPhotosToPoints, пример 1 (окно Python)

Следующий сниппет окна Python показывает, как использовать функцию GeoTaggedPhotosToPoints.

import arcpy
arcpy.management.GeoTaggedPhotosToPoints("c:/data/photos", 
                                         "c:/data/city.gdb/photo_points", "", 
                                         "ONLY_GEOTAGGED", "ADD_ATTACHMENTS")
GeoTaggedPhotosToPoints, пример 2 (автономный скрипт).

Скрипт, демонстрирующий использование функции 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)

Связанные разделы