Haut

Importer des images Indoor (Indoors)

Dans cette rubrique

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

Disponible avec l’extension ArcGIS Indoors Pro ou ArcGIS Indoors Maps.

Synthèse

Importe des images à 360 degrés et des images panoramiques depuis un fichier .e57 vers un espace de travail Indoors. Le résultat de cet outil peut être ajouté aux cartes et scènes tenant compte des étages dans ArcGIS Pro.

Utilisation

  • 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 les entités Niveaux en entrée avec une sélection ou un ensemble de définition pour importer des images vers les étages spécifiques.

  • Le paramètre Couche d’imagerie orientée cible doit être une couche d’imagerie orientée prise en charge des valeurs z. Créez une imagerie orientée avec l’outil Créer un jeu de données d’imagerie orientée.

  • 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 Niveau en entrée ont différents systèmes de coordonnées, l’outil projette à nouveau les emplacements d’image importés.

  • Pour tenir compte des étages, cet outil ajoute un champ LEVEL_ID au jeu de données d’imagerie orientée cible s’il n’est pas déjà 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é une fois toute reprojection nécessaire des emplacements d’image par l’outil.

    Par exemple, si les données en entrée a des valeurs z par rapport au niveau de la mer, et si les entités Niveaux en entrée ont des valeurs z par rapport au niveau du sol, utilisez une valeur de paramètre Ajustement de l’élévation négative pour compenser la différence (exemple dans le diagramme ci-dessous).

    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 positif horaire, le nord étant défini à 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.

  • Le résultat de l’imagerie orientée par cet outil peut être configuré avec les cartes tenant compte des étages à utiliser avec le filtre d’étages.

  • Les images importées sont stockées comme fichiers locaux. 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.

  • 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

Jeu de données d’imagerie orientée cible dans l’espace de travail Indoors qui est mis à jour par les images importées.

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

Jeu de données d’imagerie orientée cible dans l’espace de travail Indoors qui est mis à jour par les images importées.

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