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

Сводка

Создает точки на основе информации о координатах 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
(Дополнительный)

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

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

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

Лицензия:

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

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

Пример кода

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

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

import arcpy
arcpy.GeoTaggedPhotosToPoints_management("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.GeoTaggedPhotosToPoints_management(inFolder, outFeatures, badPhotosList, 
                                         photoOption, attachmentsOption)
arcpy.Buffer_analaysis(outFeatures, buffers, bufferDist)

Информация о лицензиях

  • Basic: Ограничено
  • Standard: Да
  • Advanced: Да

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