Haut

Importer des images Indoor (Indoors)

Dans cette rubrique

  1. Synthèse
  2. Utilisation
  3. Paramètres
  4. Environnements
  5. Informations de licence

Synthèse

Importe des images à 360 degrés et des images panoramiques depuis un fichier .e57 dans un jeu de données d’imagerie orientée. Le résultat de cet outil peut être ajouté aux cartes et scènes tenant compte des étages dans ArcGIS Pro.

Utilisation

  • Utilisez cet outil pour charger des images à 360 degrés et des images panoramiques dans un jeu de données d’imagerie orientée. Vous pouvez inclure des couches d’imagerie orientée tenant compte des étages dans des cartes tenant compte des étages.

  • Cet outil prend en charge les images JPEG à 360 degrés et panoramiques contenues dans les fichiers .e57. Les images doivent utiliser une représentation équirectangulaire (sphérique).

  • Utilisez cet outil avec des entités Niveaux en entrée avec une sélection ou un ensemble de définition afin d’importer uniquement les images pour des étages spécifiques.

  • La valeur du paramètre Couche d’imagerie orientée cible doit être une couche d’imagerie orientée compatible avec les valeurs Z. Créez une imagerie orientée avec l’outil Créer un jeu de données d’imagerie orientée.

    La couche d’imagerie orientée cible peut provenir d’un jeu de données d’imagerie orientée local ou d’un service d’entités hébergé. Si vous importez des photos dans un service d’entités hébergé, le service d’entités doit prendre en charge les pièces jointes de l’entité.

  • Utilisez le paramètre Système de coordonnées en entrée pour préciser les systèmes de coordonnées horizontal et vertical des données en entrée.

    • Si aucun système de coordonnées n’est spécifique ou défini dans le fichier .e57 en entrée, les données en entrée sont censées être dans le même système de coordonnées que les entités Niveaux cibles.
    • Si les données en entrée et les entités Niveaux possèdent des systèmes de coordonnées différents, l’outil reprojette les localisations des images importées.

  • Pour tenir compte des étages, cet outil ajoute le champ LEVEL_ID au jeu de données d’imagerie orientée cible, s’il n’est pas présent.

  • L’outil attribue des ID Niveau aux images selon une comparaison des valeurs z des images et des entités Niveaux comme suit :

    • Une image est attribuée à l’ID Niveau de l’entité Niveaux qui est positionné verticalement au niveau de l’image ou immédiatement sous l’image.
    • Si une image a une valeur z qui la place sous le niveau le plus bas ou à plus de 15 mètres au-dessus du niveau le plus élevé, l’image est attribuée à une valeur ID Niveau de type Null.
    • Les images en dehors de toute entité Niveaux (selon des coordonnées x,y) sont attribuées à une valeur ID Niveau de type Null.

  • Si les données en entrée et les entités de couche Niveaux en entrée ont des valeurs origines z différentes, utilisez le paramètre Ajustement de l’élévation pour compenser la différence. L’ajustement de l’élévation est appliqué après toute reprojection nécessaire des localisations des images.

    Par exemple, si les données en entrée présentent des valeurs Z relatives au niveau de la mer et que les entités Niveaux en entrée présentent des valeurs Z relatives au niveau du sol, utilisez une valeur de paramètre Ajustement de l’élévation négative pour compenser la différence. Le diagramme suivant illustre un exemple :

    Diagramme de l’effet du paramètre Ajustement de l’élévation
    Un ajustement de l’élévation négatif de -400 m est appliqué pour aligner verticalement les images avec les entités Niveaux.

  • L’outil remplit les attributs d’entité de l’imagerie orientée comme suit :

    • Shape– Les valeurs de coordonnées x, y et z sont basées sur les informations d’emplacement du fichier des données en entrée pour l’image.
    • Name– Le nom de l’image depuis les métadonnées du fichier de données en entrée. Si aucune métadonnée n’est disponible, le nom de fichier de données en entrée est utilisé avec les valeurs incrémentielles représentant des chiffres ajoutées.
      Remarque :

      Cette valeur peut différer du nom de fichier image dans le champ ImagePath.

    • LEVEL_ID– ID de niveau de l’entité Niveaux associée. Si aucun niveau associé n’est déterminé, une valeur de type Null est attribuée.
    • ImagePath– Chemin d’accès du fichier image associé à l’entité.
    • AcquisitionDate– Date et heure d’acquisition des métadonnées du fichier en entrée. Si aucune métadonnée n’est disponible, la dernière valeur modifiée de date et d’heure du fichier de données en entrée est utilisée.
    • CameraHeading– Direction de la caméra en fonction des informations de rotation du fichier des données en entrée pour l’image. Les valeurs sont en degrés.
      • Les valeurs de direction sont mesurées dans le sens horaire positif, le nord correspondant à 0 degré.
      • Cet outil ne remplit pas les attributs CameraPitch ou CameraRoll de l’imagerie orientée.
        Remarque :

        Les informations relatives à la direction de la caméra peuvent être stockées différemment en fonction du logiciel utilisé. Passez en revue le résultat de l’outil pour vérifier que les valeurs CameraHeading sont exactes, et utilisez l’outil Calculer le champ pour ajuster les valeurs CameraHeading, le cas échéant.

    • HorizontalFieldOfView– Étendue de la caméra dans la direction horizontale, en degrés.
      • Les valeurs valides sont comprises entre 0 et 360.
      • Par défaut, cet outil attribue une valeur de 360. Ajustez cette valeur avec le paramètre Champ de vision horizontal.
    • VerticalFieldOfView– Étendue de la caméra dans la direction verticale, en degrés.
      • Les valeurs valides sont comprises entre 0 et 180.
      • Par défaut, cet outil attribue une valeur de 180. Ajustez cette valeur avec le paramètre Champ de vision vertical.
    • OrientedImageryType– Type d’imagerie orientée. Cet outil attribue une valeur de 360, qui indique que les images fournissent des vues des environs sphériques ou panoramiques.

  • L’imagerie orientée générée par cet outil peut être configurée comme tenant compte des étages en vue de son utilisation avec le filtre des étages dans les cartes tenant compte des étages.

  • Les images importées sont stockées en tant que fichiers locaux dans le dossier spécifié avec le paramètre Dossier d’images cible.

    Si la valeur du paramètre Imagerie orientée cible est un jeu de données d’imagerie orientée local, utilisez l’outil Générer un service à partir d’un jeu de données d’imagerie orientée pour publier un service d’entités hébergé avec l’imagerie importée.

    Si la valeur du paramètre Imagerie orientée cible est un service d’entités hébergé, les images importées sont ajoutées en tant que pièces jointes aux entités dans la couche d’imagerie orientée.

  • Les entités existantes dans le jeu de données d’imagerie orientée cible sont préservées lors de l’importation.

Paramètres

Boîte de dialoguePython

ÉtiquetteExplicationType de données
Données en entrée

Fichier .e57 contenant le fichier d’imagerie orientée cible qui sera importé.

File
Entités Niveau en entrée

La couche Niveaux associée provenant du modèle d’information ArcGIS Indoors qui réside dans le même espace de travail que la couche des images cible.

Feature Layer
Dossier d’images cible

Dossier existant où les fichiers d’imagerie sont enregistrés.

Folder
Imagerie orientée cible

Couche d’imagerie orientée cible à laquelle ajouter les entités.

Oriented Imagery Layer
Système de coordonnées en entrée
(Facultatif)

Référence spatiale du fichier d’image en entrée. Un système de coordonnées peut être sélectionné si aucun n’est spécifié dans le fichier de données en entrée.

Spatial Reference
Ajustement de l’élévation
(Facultatif)

La valeur selon laquelle les valeurs z des images importées sont ajustées. Si les images importées sont reprojetées, l’ajustement est appliqué après projection. La valeur par défaut est 0 mètre.

  • Une valeur de -300 pieds réduits la valeur z des images importées de 300 pieds.
  • Une valeur de 250 mètres accroît la valeur z des images importées de 250 mètres.
Double
Champ de vision horizontal
(Facultatif)

Largeur efficace du champ de vision des images importées, en degrés. Les valeurs valides sont comprises entre 0 et 360. La valeur par défaut est 360.

Double
Champ de vision vertical
(Facultatif)

Hauteur du champ de vision effective des images importées, en degrés. Les valeurs valides sont comprises entre 0 et 180. La valeur par défaut est 180.

Double

Sortie obtenue

ÉtiquetteExplicationType de données
Imagerie orientée cible mise à jour

Jeu de données d’imagerie orientée mis à jour dans l’espace de travail Indoors. Les données d’imagerie orientée existantes sont conservées lors de l’importation. Une nouvelle entité ponctuelle est ajoutée pour chaque image dans les données en entrée, avec l’image associée comme pièce jointe. Les attributs sont définis sur les entités ponctuelles récemment ajoutées selon les attributs du fichier image en entrée.

Oriented imagery Layer

arcpy.indoors.ImportIndoorImages(in_data, in_level_features, target_image_folder, target_oriented_imagery, {in_coordinate_system}, {elevation_adjustment}, {horizontal_field_of_view}, {vertical_field_of_view})
NomExplicationType de données
in_data

Fichier .e57 contenant le fichier d’imagerie orientée cible qui sera importé.

File
in_level_features

La couche Niveaux associée provenant du modèle d’information ArcGIS Indoors qui réside dans le même espace de travail que la couche des images cible.

Feature Layer
target_image_folder

Dossier existant où les fichiers d’imagerie sont enregistrés.

Folder
target_oriented_imagery

Couche d’imagerie orientée cible à laquelle ajouter les entités.

Oriented Imagery Layer
in_coordinate_system
(Facultatif)

Référence spatiale du fichier d’image en entrée. Un système de coordonnées peut être sélectionné si aucun n’est spécifié dans le fichier de données en entrée.

Spatial Reference
elevation_adjustment
(Facultatif)

La valeur selon laquelle les valeurs z des images importées sont ajustées. Si les images importées sont reprojetées, l’ajustement est appliqué après projection. La valeur par défaut est 0 mètre.

  • Une valeur de -300 pieds réduits la valeur z des images importées de 300 pieds.
  • Une valeur de 250 mètres accroît la valeur z des images importées de 250 mètres.
Double
horizontal_field_of_view
(Facultatif)

Largeur efficace du champ de vision des images importées, en degrés. Les valeurs valides sont comprises entre 0 et 360. La valeur par défaut est 360.

Double
vertical_field_of_view
(Facultatif)

Hauteur du champ de vision effective des images importées, en degrés. Les valeurs valides sont comprises entre 0 et 180. La valeur par défaut est 180.

Double

Sortie obtenue

NomExplicationType de données
updated_target_oriented_imagery

Jeu de données d’imagerie orientée mis à jour dans l’espace de travail Indoors. Les données d’imagerie orientée existantes sont conservées lors de l’importation. Une nouvelle entité ponctuelle est ajoutée pour chaque image dans les données en entrée, avec l’image associée comme pièce jointe. Les attributs sont définis sur les entités ponctuelles récemment ajoutées selon les attributs du fichier image en entrée.

Oriented imagery Layer

Exemple de code

Exemple 1 ImportIndoorImages (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction ImportIndoorImages en mode immédiat.

arcpy.indoors.ImportIndoorImages(r"C:\BuildingScans\BuildingA.e57",
                                 r"C:\IndoorsModel.gdb\Indoors\Levels",
                                 r"C:\indoorsphotos\photos",
                                 r"C:\IndoorsModel.gdb\OIDataset",
                                 '', '', '')
Exemple 2 ImportIndoorImages (fenêtre Python)

Le script autonome ci-dessous illustre l’utilisation de la fonction ImportIndoorImages.

# Import system modules 
import arcpy

#Set parameter values
    in_data=r"C:\BuildingScans\BuildingA.e57"
    in_level_features=r"C:\IndoorsModel.gdb\Indoors\Levels"
    target_image_folder=r"C:\indoorsphotos\photos"
    target_oriented_imagery=r"C:\IndoorsModel.gdb\Indoors\OIDataset"
    in_coordinate_system='PROJCS["NAD_1983_2011_StatePlane_California_VI_FIPS_0406",GEOGCS["GCS_NAD_1983_2011",' \
                           'DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],' \
                           'PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],' \
                           'PROJECTION["Lambert_Conformal_Conic"],PARAMETER["False_Easting",2000000.0],' \
                           'PARAMETER["False_Northing",500000.0],PARAMETER["Central_Meridian",-116.25],' \
                           'PARAMETER["Standard_Parallel_1",32.78333333333333],' \
                           'PARAMETER["Standard_Parallel_2",33.88333333333333],' \
                           'PARAMETER["Latitude_Of_Origin",32.16666666666666],' \
                           'UNIT["Meter",1.0],AUTHORITY["EPSG",6425]]'
    elevation_adjustment="-396 Meters"
    horizontal_field_of_view=360
    vertical_field_of_view=180
    
#Run the tool
ImportIndoorImages_Indoors(in_level_features, target_image_folder, target_oriented_imagery, in_coordinate_system,
                           elevation_adjustment, horizontal_field_of_view, vertical_field_of_view)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Non
  • Standard: Nécessite ArcGIS Indoors Pro ou ArcGIS Indoors Maps
  • Advanced: Nécessite ArcGIS Indoors Pro ou ArcGIS Indoors Maps

Rubriques connexes

  • Vue d’ensemble de la boîte à outils Indoors
  • Rechercher un outil de géotraitement

Vous avez un commentaire à formuler concernant cette rubrique ?

Dans cette rubrique
  1. Synthèse
  2. Utilisation
  3. Paramètres
  4. Environnements
  5. Informations de licence