Gebäudenutzer-Features generieren (Indoors)

Available for an ArcGIS organization licensed with the Indoors extension.

Zusammenfassung

Erstellt oder aktualisiert Mitarbeiter- und Gebäudenutzer-Punktdaten, die dem ArcGIS Indoors-Informationsmodell entsprechen.

Das Werkzeug generiert Punkt-Features basierend auf Eingabe-Raumeinheiten in Gebäuden (Räume) und reichert diese Punkte mit Gebäudenutzerdaten an. Die Ausgabe dieses Werkzeugs kann zur Unterstützung von Indoors-Kartenerstellung und -Routing verwendet werden.

Verwendung

  • Der Parameter Eingabe-Raum-Features muss ein Feature-Layer oder eine Feature-Class sein, der bzw. die dem Indoors-Informationsmodell für die Units-Feature-Class entspricht.

  • Der Parameter Eingabe-Raum-Features muss das AREA_ID-Feld enthalten, das vom Indoors-Informationsmodell für die Eingabe-Feature-Class beschrieben wird.

  • Der Parameter Eingabetabelle der Gebäudenutzer muss eine Geodatabase-Tabelle, eine Tabelle in einer Excel-Arbeitsmappe (.xls- oder .xlsx-Datei) oder eine durch Trennzeichen getrennte Textdatei (.csv) sein.

  • Die Eingabetabelle der Gebäudenutzer muss die folgenden Felder enthalten:

    • KNOWNAS: Der Vor- und Nachname, der wahrscheinlich bei der Suche nach einem Gebäudenutzer verwendet wird
    • EMAIL: Die E-Mail-Adresse des Gebäudenutzers
    • CONTACT_PHONE: Die Telefonnummer des Gebäudenutzers
    • CONTACT_EXTENSION: Die Durchwahl des Gebäudenutzers, falls zutreffend

    Weitere Informationen zum Laden von Personendaten

  • Standardmäßig wird das Koordinatensystem der Eingabe-Raum-Features für den Parameter Ausgabe-Occupant-Feature-Class verwendet. Dies kann mit der Einstellung der Geoverarbeitungsumgebung "Ausgabe-Koordinatensystem" überschrieben werden.

  • Die Ausgabe des Werkzeugs enthält die folgenden von der App Indoor Space Planner verwendeten Felder:

    • AREA_ID
    • ORG_LEVEL_1
    • ORG_LEVEL_2
    • JOB_TITLE
    • START_DATE

    Vorsicht:

    Es ist nicht notwendig oder empfohlen, dass Sie das Feld AREA_ID Ihrer Eingabetabelle hinzufügen. Dieses Feld wird von der App Indoor Space Planner verwaltet. Aktualisieren Sie Ihre Eingabetabelle mit den anderen Feldern, und stellen Sie für eine verbesserte Benutzererfahrung ausgefüllte Werte zur Verfügung.

  • Beim Vorbereiten einer Karte für die Client-Apps Viewer, Indoors for iOS oder Indoors for Android können Sie die Ausgabe des Werkzeugs im Karten-Layer "People" verwenden.

  • Das Werkzeug aktualisiert die von Space Planner verwendeten Eingabe-Raum-Features-Attribute. Wenn ein Nutzer-Punkt-Feature für einen Raum generiert wird, werden die Attribute dieses Raums wie folgt aktualisiert:

    • ASSIGNMENT_TYPE ist auf Office festgelegt.
    • AREA_ID ist auf NULL festgelegt.

Syntax

GenerateOccupantFeatures(in_unit_features, unit_id_field, in_occupant_table, occupant_id_field, out_occupant_feature_class)
ParameterErklärungDatentyp
in_unit_features

Die Eingabe-Polygon-Features, die die Räume im Gebäude darstellen, die möglicherweise genutzt werden. Im Indoors-Informationsmodell ist dies der Layer "Units". Der Schwerpunkt der einzelnen Räume wird als Punktposition für die Gebäudenutzer verwendet.

Feature Layer
unit_id_field

Das Feld in den Eingabe-Raum-Features, das als Primärschlüssel verwendet wird, um Räume im Gebäude mit Datensätzen in der Eingabetabelle der Gebäudenutzer zu verknüpfen.

Field
in_occupant_table

Die Eingabetabelle, die Informationen über Gebäudenutzer enthält.

Die Informationen können in einer Geodatabase-Tabelle, einer Tabelle in einer Excel-Arbeitsmappe (.xls- oder .xlsx-Datei) oder einer durch Trennzeichen getrennten Textdatei (.csv) gespeichert werden.

Table View
occupant_id_field

Das Feld in der Eingabetabelle der Gebäudenutzer, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Eingabe-Raum-Features zu verknüpfen.

Field
out_occupant_feature_class

Die Ausgabe-Feature-Class, die durch Verknüpfen der Parameterwerte für Eingabe-Raum-Features und Eingabetabelle der Gebäudenutzer erstellt wird.

Feature Class

Abgeleitete Ausgabe

NameErklärungDatentyp
updated_unit_feature_class

Der aktualisierte Eingabe-Raum-Feature-Layer.

Feature-Class

Codebeispiel

GenerateOccupantFeatures – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion GenerateOccupantFeatures im unmittelbaren Modus verwendet wird. In diesem Beispiel sind die Eingaben und Ausgaben in der gleichen Geodatabase enthalten.

import arcpy
arcpy.indoors.GenerateOccupantFeatures('C:/Indoors/ExampleCampus.gdb/Indoors/Units', 
                                       'UNIT_ID', 
                                       'C:/Indoors/ExampleCampus.gdb/EMPLOYEEINFO', 
                                       'LOCATION', 
                                       'C:/Indoors/ExampleCampus.gdb/Indoors/People')
GenerateOccupantFeatures  – Beispiel 2 (eigenständiges Skript)

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

# Name: Indoors_GenerateOccupantFeatures_example2.py
# Description: Imports occupant information from an Excel spreadsheet to a 
#              points feature class in an Indoors geodatabase.

import arcpy

# Use the Indoors geodatabase's Units feature class as the input unit features
in_unit_features = 'C:/Indoors/ExampleCampus.gdb/Indoors/Units'

# The join will use the NAME field from Units feature class
unit_id_field = 'NAME'

# Use an Excel spreadsheet as the input occupant table
in_occupant_table = r'C:\Indoors\EmployeeInfo.xls\MarketingDept$'

# The spreadsheet's OFFICE column has values that match those in Units' NAME field
occupant_id_field = 'OFFICE'

# Output People Points feature class
out_occupant_feature_class = 'C:/Indoors/ExampleCampus.gdb/Indoors/People'

# Execute GenerateOccupantFeatures
arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field, 
                                       in_occupant_table, occupant_id_field, 
                                       out_occupant_feature_class)

Lizenzinformationen

  • Basic: Nein
  • Standard: Nein
  • Advanced: Erfordert Indoors

Verwandte Themen