Indoor-Bilder importieren (Indoors)

Verfügbar mit der Erweiterung "ArcGIS Indoors Pro" oder "ArcGIS Indoors Maps".

Zusammenfassung

Importiert 360-Grad- und Panoramabilder aus einer .e57-Datei in einen Indoors-Workspace. Die Ausgabe dieses Werkzeugs kann geschossbezogenen Karten und Szenen in ArcGIS Pro hinzugefügt werden.

Verwendung

  • Dieses Werkzeug unterstützt 360-Grad- und Panoramabilder im JPEG-Format in .e57-Dateien. Für die Bilder muss eine equirectangulare (sphärische) Darstellung verwendet werden.

  • Verwenden Sie dieses Werkzeug mit Eingabe-Ebenen-Features mit einer Auswahl oder Definitionsabfrage, um Bilder in bestimmte Etagen zu importieren.

  • Der Parameter Oriented Imagery-Ziel-Layer muss ein Z-aktivierter Oriented Imagery-Layer sein. Verwenden Sie zum Erstellen von ausgerichteten Bilddaten das Werkzeug Oriented Imagery-Dataset erstellen.

  • Verwenden Sie den Parameter Eingabe-Koordinatensystem, um das horizontale und das vertikale Koordinatensystem der Eingabedaten anzugeben.

    • Wenn in der Eingabe-.e57-Datei kein Koordinatensystem angegeben oder definiert wird, wird davon ausgegangen, dass für die Eingabedaten dasselbe Koordinatensystem gilt wie für die Eingabe-Ebenen-Features.
    • Wenn für die Eingabedaten und die Eingabe-Ebenen-Features unterschiedliche Koordinatensysteme verwendet werden, werden die importierten Bildpositionen vom Werkzeug neu projiziert.
  • Zur Unterstützung von geschossbezogenen Informationen wird dem Oriented Imagery-Ziel-Dataset ein LEVEL_ID-Feld hinzugefügt, falls noch keines vorhanden ist.

  • Das Werkzeug weist Bildern Ebenen-IDs durch den Vergleich der Z-Werte der Bilder und Ebenen-Features wie folgt zu:

    • Einem Bild wird die Ebenen-ID des Ebenen-Features zugewiesen, das vertikal am oder direkt unter dem Bild positioniert ist.
    • Wenn ein Bild einen Z-Wert aufweist, der es unter der untersten Ebene oder mehr als 15 Meter über der obersten Ebene platziert, wird dem Bild der Ebenen-ID-Wert NULL zugewiesen.
    • Bildern, die (gemäß XY-Koordinaten) außerhalb aller Ebenen-Features liegen, wird der Ebenen-ID-Wert NULL zugewiesen.
  • Wenn die Eingabedaten und Eingabe-Ebenen-Layer-Features unterschiedliche Z-Ursprünge haben, verwenden Sie den Parameter Höhenanpassung, um den Unterschied auszugleichen. Die Höhenanpassung wird nach einer erforderlichen Reprojektion der Bildpositionen vom Werkzeug vorgenommen.

    Wenn die Eingabedaten beispielsweise Z-Werte relativ zum Meeresspiegel und die Eingabe-Ebenen-Features Z-Werte relativ zum Grund enthalten, verwenden Sie einen negativen Wert für den Parameter Höhenanpassung, um den Unterschied auszugleichen (Beispiel in der folgenden Abbildung).

    Abbildung: Effekt des Parameters "Höhenanpassung"
    Um Bilder mit Ebenen-Features vertikal auszurichten, wird eine negative Höhenanpassung von –400 m vorgenommen.
  • Das Werkzeug gibt Oriented Imagery-Feature-Attribute wie folgt an:

    • Shape: Die X-, Y- und Z-Koordinatenwerte basieren auf den Positionsinformationen für das Bild in der Eingabedatendatei.
    • Name: Der Name des Bildes aus den Metadaten der Eingabedatendatei. Wenn keine Metadaten verfügbar sind, wird der Name der Eingabedatendatei verwendet, wobei inkrementelle Zahlenwerte angefügt werden.
      Hinweis:

      Dieser Wert unterscheidet sich möglicherweise vom Bilddateinamen im Feld ImagePath.

    • LEVEL_ID: Die Ebenen-ID der zugeordneten Ebenen-Features. Wenn keine zugeordnete Ebene ermittelt wird, wird der Wert NULL zugewiesen.
    • ImagePath: Der Pfad der Bilddatei, die dem Feature zugewiesen wurde.
    • AcquisitionDate: Datum und Uhrzeit, zu der die Metadaten der Eingabedatei abgerufen wurden. Wenn keine Metadaten verfügbar sind, wird der Wert für das Datum und die Uhrzeit der letzten Änderung der Eingabedatendatei verwendet.
    • CameraHeading: Die Kamerarichtung basiert auf den Rotationsinformationen für das Bild in der Eingabedatendatei. Die Werte werden in Grad angegeben.
      • Die Richtungswerte werden positiv im Uhrzeigersinn gemessen, wobei Norden als 0 Grad definiert ist.
      • Die Attribute CameraPitch bzw. CameraRoll der ausgerichteten Bilddaten werden von diesem Werkzeug nicht angegeben.
        Hinweis:

        Die Kamerarichtungsdaten werden je nach verwendeter Software möglicherweise anders gespeichert. Überprüfen Sie die Ausgabe des Werkzeugs, um sicherzustellen, dass die CameraHeading-Werte richtig angegeben wurden, und verwenden Sie ggf. das Werkzeug Feld berechnen, um die CameraHeading-Werte anzupassen.

    • HorizontalFieldOfView: Der Sichtbereich der Kamera in horizontaler Richtung, in Grad.
      • Zulässig sind Werte im Bereich von 0 bis 360.
      • Dieses Werkzeug weist standardmäßig den Wert 360 zu. Passen Sie diesen Wert mithilfe des Parameters Horizontaler sichtbarer Bereich an.
    • VerticalFieldOfView: Der Sichtbereich der Kamera in vertikaler Richtung, in Grad.
      • Zulässig sind Werte im Bereich von 0 bis 180.
      • Dieses Werkzeug weist standardmäßig den Wert 180 zu. Passen Sie diesen Wert mithilfe des Parameters Vertikaler sichtbarer Bereich an.
    • OrientedImageryType: Der Typ der ausgerichteten Bilddaten. Dieses Werkzeug weist den Wert 360 zu und gibt damit an, dass die Bilder eine sphärische Rundumsicht oder eine Panorama-Rundumsicht bieten.
  • Die von diesem Werkzeug ausgegebenen ausgerichteten Bilddaten können mit geschossbezogenen Karten zur Verwendung mit dem Geschossfilter verwendet werden.

  • Importierte Bilder werden als lokale Dateien gespeichert. Verwenden Sie das Werkzeug Service aus Oriented Imagery-Dataset generieren, um einen gehosteten Feature-Service mit den importierten Bilddaten zu veröffentlichen.

  • Im Oriented Imagery-Ziel-Dataset vorhandene Features bleiben beim Import erhalten.

Parameter

BeschriftungErläuterungDatentyp
Eingabedaten

Die .e57-Datei mit der Oriented Imagery-Zieldatei, die importiert wird.

File
Eingabe-Ebenen-Features

Der verknüpfte Ebenen-Layer aus dem ArcGIS Indoors-Informationsmodell, der sich im selben Workspace wie der Ziel-Bilder-Layer befindet.

Feature Layer
Ziel-Bildordner

Der vorhandene Ordner, in den die Bilddatendateien geschrieben werden.

Folder
Ziel für Oriented Imagery

Das Oriented Imagery-Ziel-Dataset in dem Indoors-Workspace, der durch die importierten Bilder aktualisiert wird.

Oriented Imagery Layer
Eingabe-Koordinatensystem
(optional)

Der Raumbezug der Eingabe-Bilddatei. Wenn in der Eingabedatendatei kein Koordinatensystem angegeben ist, kann eines ausgewählt werden.

Spatial Reference
Höhenanpassung
(optional)

Der Wert, um den die Z-Werte von importieren Bildern angepasst wird. Wenn die importierten Bilder neu projiziert werden, wird die Anpassung nach der Projektion vorgenommen. Der Standardwert beträgt 0 Meter.

  • Bei einem Wert von –300 Fuß wird der Z-Wert von importierten Bildern um 300 Fuß reduziert.
  • Bei einem Wert von 250 Fuß wird der Z-Wert von importierten Bildern um 250 Fuß erhöht.
Double
Horizontaler sichtbarer Bereich
(optional)

Die effektive Breite des sichtbaren Bereichs von importierten Bildern in Grad. Zulässig sind Werte im Bereich von 0 bis 360. Der Standardwert ist 360.

Double
Vertikaler sichtbarer Bereich
(optional)

Die effektive Höhe des sichtbaren Bereichs von importierten Bildern in Grad. Zulässig sind Werte im Bereich von 0 bis 180. Der Standardwert beträgt 180.

Double

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Ziel für Oriented Imagery

Das aktualisierte Oriented Imagery-Dataset im Indoors-Workspace. Vorhandene Oriented Imagery-Daten bleiben beim Import erhalten. Für jedes Bild in den Eingabedaten wird ein neues Punkt-Feature hinzugefügt, wobei das verknüpfte Bild als Anlage hinzugefügt wird. Attribute für neu hinzugefügte Punkt-Features werden basierend auf den Attributen der Eingabe-Bilddatei festgelegt.

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})
NameErläuterungDatentyp
in_data

Die .e57-Datei mit der Oriented Imagery-Zieldatei, die importiert wird.

File
in_level_features

Der verknüpfte Ebenen-Layer aus dem ArcGIS Indoors-Informationsmodell, der sich im selben Workspace wie der Ziel-Bilder-Layer befindet.

Feature Layer
target_image_folder

Der vorhandene Ordner, in den die Bilddatendateien geschrieben werden.

Folder
target_oriented_imagery

Das Oriented Imagery-Ziel-Dataset in dem Indoors-Workspace, der durch die importierten Bilder aktualisiert wird.

Oriented Imagery Layer
in_coordinate_system
(optional)

Der Raumbezug der Eingabe-Bilddatei. Wenn in der Eingabedatendatei kein Koordinatensystem angegeben ist, kann eines ausgewählt werden.

Spatial Reference
elevation_adjustment
(optional)

Der Wert, um den die Z-Werte von importieren Bildern angepasst wird. Wenn die importierten Bilder neu projiziert werden, wird die Anpassung nach der Projektion vorgenommen. Der Standardwert beträgt 0 Meter.

  • Bei einem Wert von –300 Fuß wird der Z-Wert von importierten Bildern um 300 Fuß reduziert.
  • Bei einem Wert von 250 Fuß wird der Z-Wert von importierten Bildern um 250 Fuß erhöht.
Double
horizontal_field_of_view
(optional)

Die effektive Breite des sichtbaren Bereichs von importierten Bildern in Grad. Zulässig sind Werte im Bereich von 0 bis 360. Der Standardwert ist 360.

Double
vertical_field_of_view
(optional)

Die effektive Höhe des sichtbaren Bereichs von importierten Bildern in Grad. Zulässig sind Werte im Bereich von 0 bis 180. Der Standardwert beträgt 180.

Double

Abgeleitete Ausgabe

NameErläuterungDatentyp
updated_target_oriented_imagery

Das aktualisierte Oriented Imagery-Dataset im Indoors-Workspace. Vorhandene Oriented Imagery-Daten bleiben beim Import erhalten. Für jedes Bild in den Eingabedaten wird ein neues Punkt-Feature hinzugefügt, wobei das verknüpfte Bild als Anlage hinzugefügt wird. Attribute für neu hinzugefügte Punkt-Features werden basierend auf den Attributen der Eingabe-Bilddatei festgelegt.

Oriented imagery Layer

Codebeispiel

ImportIndoorImages: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ImportIndoorImages im unmittelbaren Modus verwendet wird.

arcpy.indoors.ImportIndoorImages(r"C:\BuildingScans\BuildingA.e57",
                                 r"C:\IndoorsModel.gdb\Indoors\Levels",
                                 r"C:\indoorsphotos\photos",
                                 r"C:\IndoorsModel.gdb\OIDataset",
                                 '', '', '')
ImportIndoorImages: Beispiel 2 (Python-Fenster)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion ImportIndoorImages verwendet wird.

# 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)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

  • Basic: Nein
  • Standard: Erfordert ArcGIS Indoors Pro oder ArcGIS Indoors Maps
  • Advanced: Erfordert ArcGIS Indoors Pro oder ArcGIS Indoors Maps

Verwandte Themen