Generate Occupant Features (Générer des entités d’occupant) (Indoors)

Available for an ArcGIS organization licensed with the Indoors extension.

Résumé

Crée ou met à jour les données ponctuelles des employés ou des occupants conformes au modèle d’informations ArcGIS Indoors.

Cet outil génère des entités ponctuelles reposant sur des espaces (unités) de construction en entrée, puis enrichit ces points avec les données des occupants. La sortie de cet outil peut servir à prendre en charge la cartographie et le calcul d’itinéraire Indoors.

Utilisation

  • Le paramètre Input Unit Features (Entités Unités en entrée) doit être une couche ou une classe d’entités conforme au modèle Indoors pour la classe d’entités Unités.

  • Le paramètre Input Unit Features (Entités Unités en entrée) doit inclure le champ AREA_ID décrit par le modèle Indoors pour la classe d’entités Unités.

  • Le paramètre Input Occupant Table (Table Occupant en entrée) doit être une table de géodatabase, une feuille d’un classeur Excel (fichier .xls ou .xlsx) ou un fichier de texte délimité par des virgules (.csv).

  • La Input Occupant Table (Table Occupant en entrée) doit inclure les champs suivants :

    • KNOWNAS - Prénom et nom susceptibles d’être utilisés pour rechercher un occupant
    • EMAIL : adresse électronique de l’occupant
    • CONTACT_PHONE : numéro de téléphone de l’occupant
    • CONTACT_EXTENSION : code d’extension associé à l’occupant, le cas échéant

    En savoir plus sur le chargement des données sur les personnes

  • Par défaut, le système de coordonnées de Input Unit Features (Entités Unités en entrée) sera utilisé comme classe d’entités Occupants en sortie. Il peut être remplacé par le paramètre d’environnement de géotraitement Output Coordinate System (Système de coordonnées en sortie).

  • La sortie de l’outil inclut les champs ci-dessous utilisés par l’application Indoor Space Planner :

    • AREA_ID
    • ORG_LEVEL_1
    • ORG_LEVEL_2
    • JOB_TITLE
    • START_DATE

    Attention :

    Il n’est pas nécessaire ou recommandé d’ajouter le champ AREA_ID à votre table en entrée. Ce champ est géré par l’application Indoor Space Planner. Mettez à jour votre table en entrée avec les autres champs et indiquez les valeurs renseignées pour une expérience avancée.

  • Lors de la préparation d’une carte pour l’application cliente Viewer, Indoors for iOS ou Indoors for Android, vous pouvez utiliser la sortie de l’outil dans la couche de personnes de la carte.

  • L’outil met à jour les attributs Input Unit Features (Entités Unité en entrée) utilisés par Space Planner. Si une entité ponctuelle Occupant est générée pour une unité, les attributs de cette unité sont mis à jour comme suit :

    • ASSIGNMENT_TYPE est défini sur Office (Bureau).
    • AREA_ID est défini sur NULL.

Syntaxe

GenerateOccupantFeatures(in_unit_features, unit_id_field, in_occupant_table, occupant_id_field, out_occupant_feature_class)
ParamètreExplicationType de données
in_unit_features

Entités surfaciques en entrée représentant les espaces de construction susceptibles d’être occupés. Dans le modèle Indoors Informations, il s’agit de la couche d’unités. Le centroïde de chaque espace sera utilisé comme emplacement du point pour le ou les occupants.

Feature Layer
unit_id_field

Le champ dans Input Unit Features (Entités Unité en entrée) qui sera utilisé comme clé primaire pour associer les espaces des bâtiments aux enregistrements dans la Input Occupant Table (Table Occupant en entrée).

Field
in_occupant_table

Table en entrée qui contient des informations sur les occupants d’un bâtiment.

Les informations peuvent être stockées dans une table de géodatabase, une feuille d’un classeur Excel (fichier .xls ou .xlsx) ou un fichier .csv.

Table View
occupant_id_field

Le champ dans Input Occupant Table (Table Occupant en entrée) qui sera utilisé comme clé primaire pour associer les occupants aux Input Unit Features (Entités Unité en entrée).

Field
out_occupant_feature_class

La classe d’entités en sortie créée en associant les valeurs des paramètres Input Unit Features (Entités Unité en entrée) et Input Occupant Table (Table Occupant en entrée).

Feature Class

Sortie dérivée

NomExplicationType de données
updated_unit_feature_class

La Couche d’entités Unité en entrée mises à jour.

Classe d’entités

Exemple de code

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

Le script de fenêtre Python ci-dessous montre comment utiliser la fonction GenerateOccupantFeatures en mode immédiat. Dans cet exemple, les entrées et les sorties sont toutes dans la même géodatabase.

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')
Exemple 2 d’utilisation de l’outil GenerateOccupantFeatures (script autonome)

Le script autonome ci-dessous illustre l'utilisation de la fonction GenerateOccupantFeatures.

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

Informations de licence

  • Basic: Non
  • Standard: Non
  • Advanced: Requiert Indoors

Rubriques connexes