Resumen
Crea puntos a partir de las coordenadas x-, y-, z- almacenadas en fotos geoetiquetadas. Opcionalmente, agrega archivos de fotos a entidades en la clase de entidad 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 y escribe estas 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 su dispositivo no capturó con la foto una marca de hora que pueda utilizar. Los archivos de fotos pueden tener una propiedad de fecha de creación o fecha de modificación, pero a menudo no representan 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.
La DateTime de salida 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 cronología 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 ocurren con frecuencia debido que el dispositivo no tiene una señal adecuada para capturar las coordenadas. Si el parámetro Incluir fotos no geoetiquetadas está activado (ALL_PHOTOS en Python), 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 XY, ya que es el sistema de coordenadas utilizado por los receptores GPS.
Sintaxis
arcpy.management.GeoTaggedPhotosToPoints(Input_Folder, Output_Feature_Class, {Invalid_Photos_Table}, {Include_Non-GeoTagged_Photos}, {Add_Photos_As_Attachments})| Parámetro | Explicación | Tipo de datos |
Input_Folder | La carpeta donde están ubicados los archivos de fotos. 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) | La tabla de salida opcional 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 una ruta, no se creará esta tabla. | 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. Licencia:Para agregar adjuntos se requiere una licencia de ArcGIS Desktop Standard o superior, y la clase de entidad de salida debe estar en una geodatabase de la versión 10 o superior.
| Boolean |
Muestra de código
El siguiente fragmento de la ventana de Python muestra cómo utilizar la herramienta GeoTaggedPhotosToPoints.
import arcpy
arcpy.GeoTaggedPhotosToPoints_management("c:/data/photos",
"c:/data/city.gdb/photo_points", "",
"ONLY_GEOTAGGED", "ADD_ATTACHMENTS")El siguiente script muestra cómo utilizar la herramienta 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)Información de licenciamiento
- Basic: Limitado
- Standard: Sí
- Advanced: Sí