De fotos geoetiquetadas a puntos (Herramientas de administración de datos)

Resumen

Crea puntos a partir de las coordenadas x, y, y z almacenadas en los metadatos de archivos de fotos geoetiquetadas (.jpg, .tif o .heic). Puede agregar los archivos de fotos a las entidades de salida como adjuntos de geodatabase.

Ilustración

Ilustración de la herramienta De fotos geoetiquetadas a puntos

Uso

Esta herramienta lee las coordenadas de longitud, latitud y altitud a partir de archivos de fotos (.jpg, .tif o .heic) y escribe las coordenadas y atributos asociados en una clase de entidad de punto de salida.
La clase de entidad de salida tendrá los siguientes campos de atributos:
- Path—La ruta completa al archivo de foto que se usó para generar el punto, por ejemplo, C:\data\photos\Pic0001.jpg.
- Name—El nombre abreviado del archivo de foto, por ejemplo, Pic0001.jpg.
- DateTime—La hora y fecha de captura originales del archivo de foto. Cuando la clase de entidad de salida sea un shapefile, este campo será de tipo cadena de caracteres. Cuando la clase de entidad de salida sea una geodatabase, este campo será de tipo fecha.
  
  Si el campo DateTime contiene valores nulos o vacíos, puede ser un indicio de que el dispositivo no capturó con la foto una marca de tiempo que pueda utilizar. Los archivos de fotos pueden tener una propiedad de fecha de creación o fecha de modificación, pero pueden no representar la fecha y la hora en las que se capturó la foto.
- Direction—La dirección hacia donde apuntaba el dispositivo cuando se capturó la foto. Los valores oscilan entre 0 y 359,99, donde 0 indica norte, 90 este y así sucesivamente. Si el dispositivo no registra ninguna dirección, en este campo aparecerá el valor Nulo, 0 o -999999, en función del dispositivo y de la ubicación de salida especificada. El valor de dirección puede hacer referencia a grados respecto del norte verdadero o el norte magnético. Para obtener más información, consulte la documentación del dispositivo.
  
  Nota:
  
  Utilice la información de dirección de las fotos geoetiquetadas con precaución, ya que la dirección registrada por el dispositivo puede que no sea exacta. Para obtener información sobre la precisión de la dirección, consulte la documentación del dispositivo.
- X—Coordenada x en la que se capturó la foto.
- Y—Coordenada y en la que se capturó la foto.
- Z—Altitud en metros a la que se capturó la foto. Si el dispositivo no registra ninguna altitud, en el campo aparecerá el valor Nulo, 0 o -999999, en función del dispositivo y de la ubicación de salida especificada.
El campo de salida DateTime se puede utilizar para analizar y representar la clase de entidad de salida en el tiempo.
La salida de la herramienta incluye un gráfico de líneas que muestra la línea temporal de las fotos utilizando un recuento de las marcas de tiempo del campo DateTime en bins de fecha y hora que se calculan automáticamente, pero no se pueden personalizar.
Si las coordenadas x e y de una foto son 0,0, no se generará ningún punto para esa foto. Las coordenadas vacías pueden ocurrir cuando el dispositivo no tiene una señal adecuada para capturar las coordenadas. Si el parámetro Incluir fotos no geoetiquetadas está activado, la foto se agregará como una entidad de salida con geometría nula.
La clase de entidad de salida tendrá un sistema de coordenadas verticales y GCS_WGS_1984 x,y, ya que es el sistema de coordenadas utilizado por los receptores GPS.

Etiqueta	Explicación	Tipo de datos
Carpeta de entrada	La carpeta donde están ubicados los archivos de fotos (.jpg, `.tif` o `.heic`). Esta carpeta se escanea recursivamente para encontrar archivos de fotos; cualquier foto al nivel de la base de la carpeta, así como en cualquier subcarpeta, se agregará a la salida.	Folder
Clase de entidad de salida	La clase de entidad de puntos de salida.	Feature Class
Tabla de fotos no válidas (Opcional)	Una tabla de salida que enumerará todos los archivos de fotos de la carpeta de entrada con metadatos Exif no válidos o coordenadas vacías o no válidas. Si no se especifica ningún valor, la tabla no se crea.	Table
Incluir fotos no geoetiquetadas (Opcional)	Especifica si todos los archivos de fotos se incluirán en la clase de entidad de salida o si solo se incluirán aquellos con coordenadas válidas. Activado—Todas las fotos se incluirán como registros en la clase de entidad de salida. Si un archivo de foto no tiene información de coordenadas, se incluirá como una entidad con geometría nula. Esta es la opción predeterminada. Desactivado—Solamente las fotos con información de coordenadas válidas se incluirán en la clase de entidad de salida.	Boolean
Agregar fotos como adjuntos (Opcional)	Especifica si las fotos de entrada se agregarán a las entidades de salida como adjuntos de geodatabase. Nota: Para agregar adjuntos es necesario que la clase de entidad de salida se encuentre en una geodatabase de la versión 10 o posterior. Activado—Se agregarán fotos a las entidades de salida como adjuntos de geodatabase copiados internamente en la geodatabase. Esta es la opción predeterminada. Desactivado—No se agregarán fotos a las entidades de salida como adjuntos de geodatabase.	Boolean

arcpy.management.GeoTaggedPhotosToPoints(Input_Folder, Output_Feature_Class, {Invalid_Photos_Table}, {Include_Non-GeoTagged_Photos}, {Add_Photos_As_Attachments})

Nombre	Explicación	Tipo de datos
Input_Folder	La carpeta donde están ubicados los archivos de fotos (.jpg, `.tif` o `.heic`). Esta carpeta se escanea recursivamente para encontrar archivos de fotos; cualquier foto al nivel de la base de la carpeta, así como en cualquier subcarpeta, se agregará a la salida.	Folder
Output_Feature_Class	La clase de entidad de puntos de salida.	Feature Class
Invalid_Photos_Table (Opcional)	Una tabla de salida que enumerará todos los archivos de fotos de la carpeta de entrada con metadatos Exif no válidos o coordenadas vacías o no válidas. Si no se especifica ningún valor, la tabla no se crea.	Table
Include_Non-GeoTagged_Photos (Opcional)	Especifica si todos los archivos de fotos se incluirán en la clase de entidad de salida o si solo se incluirán aquellos con coordenadas válidas. `ALL_PHOTOS`—Todas las fotos se incluirán como registros en la clase de entidad de salida. Si un archivo de foto no tiene información de coordenadas, se incluirá como una entidad con geometría nula. Esta es la opción predeterminada. `ONLY_GEOTAGGED`—Solamente las fotos con información de coordenadas válidas se incluirán en la clase de entidad de salida.	Boolean
Add_Photos_As_Attachments (Opcional)	Especifica si las fotos de entrada se agregarán a las entidades de salida como adjuntos de geodatabase. Nota: Para agregar adjuntos es necesario que la clase de entidad de salida se encuentre en una geodatabase de la versión 10 o posterior. `ADD_ATTACHMENTS`—Se agregarán fotos a las entidades de salida como adjuntos de geodatabase copiados internamente en la geodatabase. Esta es la opción predeterminada. `NO_ATTACHMENTS`—No se agregarán fotos a las entidades de salida como adjuntos de geodatabase.	Boolean

Muestra de código

Ejemplo 1 de "GeoTaggedPhotosToPoints" (ventana de Python)

El siguiente fragmento de la ventana de Python muestra cómo utilizar la función GeoTaggedPhotosToPoints.

import arcpy
arcpy.management.GeoTaggedPhotosToPoints("c:/data/photos",
                                         "c:/data/city.gdb/photo_points", "",
                                         "ONLY_GEOTAGGED", "ADD_ATTACHMENTS")

Ejemplo 2 de "GeoTaggedPhotosToPoints" (script independiente)

El siguiente script muestra cómo utilizar la función 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)

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal, La salida tiene valores Z

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí