Photos géolocalisées vers points (Gestion des données)

Synthèse

Crée des points à partir de coordonnées X, Y et Z stockées dans les métadonnées des fichiers photographiques contenant des balises géographiques (.jpg ou .tif). Vous pouvez ajouter des fichiers photo aux entités en sortie en tant que pièces jointes à la géodatabase.

Illustration

Illustration de l’outil Photos géotaguées vers points

Utilisation

  • Cet outil lit les coordonnées de longitude, de latitude et d’altitude dans des fichiers photo (.jpg ou .tif) et écrit les coordonnées et les attributs associés dans une classe d’entités ponctuelles en sortie.

  • La classe d’entités en sortie inclura les champs attributaires suivants :

    • PathChemin d’accès complet au fichier photo utilisé pour générer le point (par exemple, C:\data\photos\Pic0001.jpg).
    • NameNom court du fichier photo (par exemple, Pic0001.jpg).
    • DateTimeDate et heure de la capture d’origine du fichier photo. Lorsque la classe d’entités en sortie est un shapefile, ce champ est de type chaîne. Lorsque la classe d’entités en sortie est une géodatabase, ce champ est de type date.

      Si le champ DateTime contient des valeurs nulles ou vides, cela peut indiquer que l’appareil n’a pas capturé un horodatage utilisable avec la photo. Les fichiers photo peuvent intégrer une propriété date de création ou date de modification, mais ces dernières peuvent ne pas représenter la date et l’heure de capture de la photo.

    • DirectionDirection dans laquelle l’appareil était dirigé lorsque la photo a été capturée. Les valeurs sont comprises entre 0 et 359,99, où 0 correspond au nord, 90 à l’est et ainsi de suite. Si aucune direction n’est enregistrée par l’appareil, ce champ a une valeur nulle, 0, ou -999999, en fonction de l’appareil et de l’emplacement en sortie que vous avez spécifiés. La valeur de la direction peut désigner les degrés depuis le nord géographique ou le nord magnétique. Consultez la documentation de l’appareil pour en savoir plus.
      Remarque :

      Utilisez avec prudence les informations de direction d’une photo géolocalisée, car la direction enregistrée par l’appareil peut manquer de précision. Consultez la documentation de l’appareil pour en savoir plus sur la précision directionnelle.

    • XCoordonnée x de l’endroit où la photo a été capturée.
    • YCoordonnée y de l’endroit où la photo a été capturée.
    • ZAltitude en mètres de l’endroit où la photo a été capturée. Si aucune altitude n’est enregistrée par l’appareil, ce champ a une valeur nulle, 0, ou -999999, en fonction de l’appareil et de l’emplacement en sortie que vous avez spécifiés.

  • Le champ en sortie DateTime peut servir à analyser et cartographier la classe d’entités en sortie dans le temps.

  • La sortie de l’outil inclut un diagramme linéaire qui affiche la chronologie des photos, avec un nombre d’horodatages dans le champ DateTime et des groupes de date et heure automatiquement calculés pouvant être personnalisés.

  • Si les coordonnées x et y d’une photo sont 0,0, aucun point n’est généré pour cette photo. Des coordonnées vides peuvent se présenter lorsque l’appareil n’a pas de signal adéquat pour capturer des coordonnées. Si le paramètre Inclure les photos non géolocalisées est sélectionné, la photo est ajoutée en tant qu’entité en sortie avec une géométrie nulle.

  • La classe d’entités en sortie a un système de coordonnées GCS_WGS_1984, xy et verticales, puisque c’est le système de coordonnées utilisé par les récepteurs GPS.

Paramètres

ÉtiquetteExplicationType de données
Dossier en entrée

Dossier contenant les fichiers photo (.jpg ou .tif). Ce dossier est analysé itérativement à la recherche de fichiers photo. Toutes les photos présentes dans le niveau de base du dossier, ainsi que dans tous les sous-dossiers, seront ajoutées à la sortie.

Folder
Classe d’entités en sortie

Classe d’entités ponctuelles en sortie.

Feature Class
Table des photos non valides
(Facultatif)

Table en sortie qui répertorie tous les fichiers photo dans le dossier en entrée avec des métadonnées Exif non valides ou des coordonnées vides ou non valides.

Si aucune valeur n’est spécifiée, la table n’est pas créée.

Table
Inclure les photos non géotaguées
(Facultatif)

Spécifie si tous les fichiers photo seront inclus dans la classe d’entités en sortie ou uniquement ceux dont les coordonnées sont valides.

  • Activé : tous les fichiers photo seront inclus en tant qu’enregistrements dans la classe d’entités en sortie. Si un fichier photo ne contient pas d’informations de coordonnées, il sera inclus en tant qu’entité à géométrie nulle. Il s’agit de l’option par défaut.
  • Désactivé : seuls les fichiers photo contenant des informations de coordonnées valides seront inclus dans la classe d’entités en sortie.
Boolean
Ajouter des photos en tant que pièces jointes
(Facultatif)

Spécifie si les photos en entrée seront ajoutées aux entités en sortie en tant que pièces jointes de géodatabase.

Remarque :

Pour ajouter des pièces jointes, la classe d’entités en sortie doit figurer dans une géodatabase version 10 ou ultérieure.

  • Activé : les photos seront ajoutées aux entités en sortie sous la forme de pièces jointes de géodatabase copiées en interne dans la géodatabase. Il s’agit de l’option par défaut.
  • Désactivé : les photos ne seront pas ajoutées aux entités en sortie en tant que pièces jointes de géodatabase.
Boolean

arcpy.management.GeoTaggedPhotosToPoints(Input_Folder, Output_Feature_Class, {Invalid_Photos_Table}, {Include_Non-GeoTagged_Photos}, {Add_Photos_As_Attachments})
NomExplicationType de données
Input_Folder

Dossier contenant les fichiers photo (.jpg ou .tif). Ce dossier est analysé itérativement à la recherche de fichiers photo. Toutes les photos présentes dans le niveau de base du dossier, ainsi que dans tous les sous-dossiers, seront ajoutées à la sortie.

Folder
Output_Feature_Class

Classe d’entités ponctuelles en sortie.

Feature Class
Invalid_Photos_Table
(Facultatif)

Table en sortie qui répertorie tous les fichiers photo dans le dossier en entrée avec des métadonnées Exif non valides ou des coordonnées vides ou non valides.

Si aucune valeur n’est spécifiée, la table n’est pas créée.

Table
Include_Non-GeoTagged_Photos
(Facultatif)

Spécifie si tous les fichiers photo seront inclus dans la classe d’entités en sortie ou uniquement ceux dont les coordonnées sont valides.

  • ALL_PHOTOSTous les fichiers photo seront inclus en tant qu’enregistrements dans la classe d’entités en sortie. Si un fichier photo ne contient pas d’informations de coordonnées, il sera inclus en tant qu’entité à géométrie nulle. Il s’agit de l’option par défaut.
  • ONLY_GEOTAGGEDSeules les photos contenant des informations de coordonnées valides seront incluses dans la classe d’entités en sortie.
Boolean
Add_Photos_As_Attachments
(Facultatif)

Spécifie si les photos en entrée seront ajoutées aux entités en sortie en tant que pièces jointes de géodatabase.

Remarque :

Pour ajouter des pièces jointes, la classe d’entités en sortie doit figurer dans une géodatabase version 10 ou ultérieure.

  • ADD_ATTACHMENTSLes photos seront ajoutées aux entités en sortie sous la forme de pièces jointes à la géodatabase copiées en interne dans la géodatabase. Il s’agit de l’option par défaut.
  • NO_ATTACHMENTSLes photos ne seront pas ajoutées aux entités en sortie en tant que pièces jointes de géodatabase.
Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil GeoTaggedPhotosToPoints (fenêtre Python)

L’extrait de la fenêtre Python ci-dessous illustre l’utilisation de la fonction GeoTaggedPhotosToPoints.

import arcpy
arcpy.management.GeoTaggedPhotosToPoints("c:/data/photos", 
                                         "c:/data/city.gdb/photo_points", "", 
                                         "ONLY_GEOTAGGED", "ADD_ATTACHMENTS")
Exemple 2 d’utilisation de l’outil GeoTaggedPhotosToPoints (script autonome)

Le script suivant montre comment utiliser la fonction 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)

Rubriques connexes