Etiqueta | Explicación | Tipo de datos |
Carpeta de entrada | La carpeta donde están ubicados los archivos de fotos (.jpg o .tif). 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.
| 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.
| Boolean |
Resumen
Crea puntos a partir de las coordenadas x, y y z almacenadas en los metadatos de archivos de fotos geoetiquetadas (.jpg o .tif). Puede agregar los archivos de fotos a las entidades de salida como adjuntos de geodatabase.
Ilustración
Uso
Esta herramienta lee las coordenadas de longitud, latitud y altitud a partir de archivos de fotos (.jpg o .tif) 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— La coordenada x en la que se capturó la foto.
- Y— La coordenada y en la que se capturó la foto.
- Z— La 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 bines 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.
Parámetros
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 o .tif). 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.
| 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.
| Boolean |
Muestra de código
El siguiente fragmento de la ventana de Python muestra cómo utilizar la herramienta GeoTaggedPhotosToPoints.
import arcpy
arcpy.management.GeoTaggedPhotosToPoints("c:/data/photos",
"c:/data/city.gdb/photo_points", "",
"ONLY_GEOTAGGED", "ADD_ATTACHMENTS")
En el siguiente script se 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)