Generar dataset de posicionamiento en interiores (Posicionamiento en interiores)

Resumen

Genera un dataset de posicionamiento en interiores para una instalación de ArcGIS IPS existente. Puede utilizar un método basado en estudios topográficos o sin ellos para generar el dataset.

Esta herramienta actualiza las clases de entidad Datasets de posicionamiento IPS y Puntos de posicionamiento IPS, así como la tabla Señales de posicionamiento IPS en el Modelo de información de ArcGIS IPS.

Uso

  • La herramienta genera un dataset de posicionamiento en interiores utilizando uno de los siguientes métodos:

    • Basado en estudios topográficos: las entidades de registro IPS consisten en señales recopiladas durante un estudio topográfico utilizando la aplicación ArcGIS IPS Setup. Para este método, solo necesita proporcionar entidades de nivel y registro IPS, pero también puede proporcionar entidades de baliza IPS para habilitar el posicionamiento de radio adaptable y lograr una mejor precisión de posicionamiento en los dispositivos Android. Si se proporcionan entidades de baliza IPS, se filtran las señales de radio que no son emitidas por las balizas en la clase de entidad Balizas IPS, pero que se capturan durante un registro de estudio topográfico IPS.
    • Sin estudios topográficos: estas entidades se utilizan para simular la propagación de la señal Bluetooth en todo el ambiente interior. Para este método, debe proporcionar entidades de balizas IPS, áreas IPS, paredes y nivel.
  • El valor del parámetro Nombre del dataset de salida debe ser único en el campo Dataset Name de la clase de entidad configurada en el parámetro Datasets de posicionamiento IPS objetivo.

  • El valor del parámetro Entidades de nivel debe ser una clase de entidad o una capa de entidades que se ajuste a la clase de entidad Niveles del modelo de información ArcGIS Indoors.

    • Si se utiliza el método de generación basado en estudios topográficos, un nivel debe estar asociado con al menos una entidad de registro IPS válida en el campo LEVEL_ID.
    • Si se utiliza el método de generación sin estudios topográficos, un nivel debe estar asociado con al menos cuatro balizas, un área IPS y una entidad de pared.
    • Además, los siguientes atributos deben ser válidos y estar actualizados y no deben ser NULL:
      • LEVEL_ID
      • VERTICAL_ORDER
      • FACILITY_ID

  • El valor del parámetro Entidades de registros IPS debe ser una capa de entidad o una clase de entidad que se ajuste a la clase de entidad IPS_Recordings del modelo de ArcGIS IPS. En un flujo de trabajo de implementación típico, el valor del parámetro forma parte de un mapa que se ha compartido con ArcGIS Online o ArcGIS Enterprise.

    Nota:

    Se permiten implementaciones mixtas de Bluetooth y WiFi, pero solo para diferentes instalaciones dentro de un mismo emplazamiento. Algunas instalaciones pueden proporcionar posicionamiento Bluetooth y, otras, posicionamiento WiFi, pero no es posible procesar los registros Bluetooth y los registros WiFi para la misma instalación en un único dataset de posicionamiento en interiores.

    Si una instalación contiene registros topográficos de ambos tipos de radio, seleccione las entidades de uno de los tipos de opción antes de ejecutar la herramienta. Por ejemplo, utilice la herramienta Seleccionar por atributo para seleccionar todos los registros Bluetooth de una instalación que contenga ambos tipos y ejecute la herramienta solo en las entidades seleccionadas. El campo SITE_ID solo puede contener un Id. de sitio por trabajo de geoprocesamiento. Procese sitios adicionales como datasets de posicionamiento en interiores independientes.

  • El valor del parámetro Entidades de baliza IPS debe ser una capa de entidad o una clase de entidad que se ajuste a la clase de entidad IPS Beacons del modelo de datos IPS. La geometría de la entidad debe ser exacta y los siguientes atributos deben ser válidos y estar actualizados y no deben ser NULL:

    • UUID
    • MAJOR
    • MINOR
    • LEVEL_ID
    • RSSI_1M
    Nota:

    Consulte el artículo de blog Cómo mantener los datos de la baliza para ArcGIS IPS para obtener información adicional.

  • El valor del parámetro Entidades de área IPS debe ser una clase de entidad poligonal o una capa de entidades que represente con precisión las áreas interiores donde desea habilitar el posicionamiento en interiores. Se deben cumplir estas condiciones:

    • El esquema de entidades de área IPS incluye el campo LEVEL_ID.
    • La entidad de área IPS está asociada a un nivel existente utilizando el atributo LEVEL_ID.
    • El atributo LEVEL_ID no debe ser NULL.
    • La geometría de la entidad debe estar contenida en el nivel asociado.

    Puede derivar el valor del parámetro Entidades de área IPS de varias maneras. Un método recomendado es seleccionar entidades etiquetadas como corredores y pasillos de la clase de entidad Unidades en el modelo de información ArcGIS Indoors. Si lo prefiere, puede crear manualmente entidades de área IPS, lo que le permite la flexibilidad de personalizar el dataset según sus necesidades y preferencias. La selección del método de derivación depende de sus requisitos y de la complejidad del caso de uso.

  • El valor del parámetro Entidades de pared debe ser una capa de entidades o una clase de entidad que represente con la mayor precisión posible la extensión física de las paredes de las instalaciones en las que se va a implementar el posicionamiento en interiores. Estas entidades pueden extraerse de un modelo de información Indoors existente. El esquema del valor del parámetro Entidades de pared debe incluir todos los atributos necesarios para tener en cuenta las plantas. Se deben cumplir estas condiciones:

    • La pared debe estar asociada a un nivel existente utilizando el atributo LEVEL_ID.
    • El atributo LEVEL_ID no debe ser NULL.
    • La geometría de la entidad debe estar contenida en el nivel asociado.
  • El valor del parámetro Actualizar dataset existente debe ser un valor booleano. Para actualizar un dataset de posicionamiento en interiores, marque el parámetro Actualizar dataset existente.

    Nota:

    Comparta el dataset de posicionamiento en interiores (las clases de entidad Datasets de posicionamiento IPS y Puntos de posicionamiento IPS y la tabla Señales de posicionamiento IPS) en el mapa si desea actualizar el dataset en el futuro.

  • El valor del parámetro Dataset existente solo está disponible cuando el parámetro Actualizar dataset existente está activado. El valor del parámetro debe ser el nombre de un dataset de posicionamiento en interiores existente contenido en el valor del parámetro Datasets de posicionamiento IPS objetivo. Los datos contenidos en este dataset se utilizarán junto con las entradas de la herramienta para generar una versión actualizada del dataset existente.

Parámetros

EtiquetaExplicaciónTipo de datos
Datasets de posicionamiento IPS objetivo

La clase de entidad donde se almacenará el dataset de posicionamiento en interiores generado.

Feature Layer
Nombre del dataset de salida

El nombre del dataset de posicionamiento en interiores de salida.

El nombre del dataset de salida debe ser único en el campo Dataset Name de la clase de entidad Posicionamiento de IPS de destino.

String
Método de generación

Especifica el método que se utilizará para generar el dataset de posicionamiento en interiores.

  • Basado en estudios topográficosEl dataset se generará mediante el procesamiento de registros IPS.
  • Sin estudios topográficosEl dataset se generará simulando la propagación de la señal Bluetooth a través del ambiente interior.
String
Entidades de nivel

Las entidades poligonales que representan las huellas de los niveles dentro de las instalaciones.

Feature Layer
Entidades de registros de IPS
(Opcional)

La clase de entidad o servicio de entidades que contiene registros de IPS Setup.

Al actualizar los datasets de posicionamiento basados ​​en estudios topográficos, es posible utilizar los registros de calidad y de estudios topográficos de IPS Setup; sin embargo, los registros de calidad solo se pueden usar cuando el parámetro Actualizar dataset existente está marcado.

Este parámetro es obligatorio si el parámetro Método de generación está configurado en Basado en estudios topográficos.

Feature Layer
Entidades de baliza IPS
(Opcional)

Las entidades de punto que representan la posición y los ajustes de las balizas de Bluetooth implementadas en el entorno interior.

Al generar el dataset de posicionamiento en interiores Bluetooth con el parámetro Método de generación configurado en Basado en estudios topográficos, proporcionar entidades de baliza válidas habilita el posicionamiento de radio adaptable, lo que mejora la precisión del posicionamiento en interiores de los dispositivos Android.

Este parámetro es obligatorio si el parámetro Método de generación está configurado en Sin estudios topográficos.

Feature Layer
Entidades de área de IPS
(Opcional)

Las entidades de polígono que representan el área en la que se generará el dataset de posicionamiento en interiores.

Este parámetro es obligatorio si el parámetro Método de generación está configurado en Sin estudios topográficos.

Feature Layer
Entidades de pared
(Opcional)

Las entidades poligonales que representan la extensión física de las paredes.

Este parámetro es obligatorio si el parámetro Método de generación está configurado en Sin estudios topográficos.

Feature Layer
Actualizar dataset existente
(Opcional)

Especifica si se creará un dataset de posicionamiento en interiores combinando un dataset existente y las entradas de la herramienta. Este parámetro solo es válido si el parámetro Método de generación está establecido en Basado en estudios topográficos.

  • Activado: se creará un dataset de posicionamiento en interiores mediante la combinación de un dataset existente y las entradas de la herramienta.
  • Desactivado: se creará un nuevo dataset de posicionamiento en interiores. Esta es la opción predeterminada.

Boolean
Dataset existente
(Opcional)

El nombre de un dataset existente contenido en la clase de entidad configurada en el parámetro Datasets de posicionamiento IPS objetivo. El valor del parámetro debe ser el nombre de un dataset de posicionamiento en interiores existente contenido la clase de entidad de destino. Los datos contenidos en este dataset se utilizarán junto con las entradas de la herramienta para generar una versión actualizada del dataset existente. Este parámetro solo se utiliza en combinación con el parámetro Actualizar dataset existente.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Datasets de posicionamiento de IPS actualizados

La clase de entidad de datasets de posicionamiento IPS actualizados que contiene el dataset de posicionamiento en interiores recién creado.

Feature Layer

arcpy.indoorpositioning.GenerateIndoorPositioningDataset(target_ips_positioning_datasets, dataset_name, generation_method, in_levels, {in_ips_recordings}, {in_beacons}, {in_ips_areas}, {in_walls}, {update_existing}, {existing_dataset})
NombreExplicaciónTipo de datos
target_ips_positioning_datasets

La clase de entidad donde se almacenará el dataset de posicionamiento en interiores generado.

Feature Layer
dataset_name

El nombre del dataset de posicionamiento en interiores de salida.

El nombre del dataset de salida debe ser único en el campo Dataset Name de la clase de entidad Posicionamiento de IPS de destino.

String
generation_method

Especifica el método que se utilizará para generar el dataset de posicionamiento en interiores.

  • SURVEY_BASEDEl dataset se generará mediante el procesamiento de registros IPS.
  • SURVEY_LESSEl dataset se generará simulando la propagación de la señal Bluetooth a través del ambiente interior.
String
in_levels

Las entidades poligonales que representan las huellas de los niveles dentro de las instalaciones.

Feature Layer
in_ips_recordings
(Opcional)

La clase de entidad o servicio de entidades que contiene registros de IPS Setup.

Al actualizar los datasets de posicionamiento basados ​​en estudios topográficos, es posible utilizar los registros de calidad y de estudios topográficos de IPS Setup; sin embargo, los registros de calidad solo se pueden usar cuando el parámetro update_existing está configurado en UPDATE_EXISTING.

Este parámetro es obligatorio si el parámetro generation_method se define como SURVEY_BASED.

Feature Layer
in_beacons
(Opcional)

Las entidades de punto que representan la posición y los ajustes de las balizas de Bluetooth implementadas en el entorno interior.

Al generar el dataset de posicionamiento en interiores Bluetooth con el parámetro generation_method configurado en SURVEY_BASED, proporcionar entidades de baliza válidas habilita el posicionamiento de radio adaptable, lo que mejora la precisión del posicionamiento en interiores de los dispositivos Android.

Este parámetro es obligatorio si el parámetro generation_method se define como SURVEY_LESS.

Feature Layer
in_ips_areas
(Opcional)

Las entidades de polígono que representan el área en la que se generará el dataset de posicionamiento en interiores.

Este parámetro es obligatorio si el parámetro generation_method se define como SURVEY_LESS.

Feature Layer
in_walls
(Opcional)

Las entidades poligonales que representan la extensión física de las paredes.

Este parámetro es obligatorio si el parámetro generation_method se define como SURVEY_LESS.

Feature Layer
update_existing
(Opcional)

Especifica si se creará un dataset de posicionamiento en interiores combinando un dataset existente y las entradas de la herramienta. Este parámetro solo es válido si el parámetro generation_method está establecido en SURVEY_BASED.

  • UPDATE_EXISTINGSe creará un dataset de posicionamiento en interiores mediante la combinación de un dataset existente y las entradas de la herramienta.
  • NO_UPDATE_EXISTINGSe creará un nuevo dataset de posicionamiento en interiores. Esta es la opción predeterminada.
Boolean
existing_dataset
(Opcional)

El nombre de un dataset existente contenido en la clase de entidad configurada en el parámetro target_ips_positioning_datasets. El valor del parámetro debe ser el nombre de un dataset de posicionamiento en interiores existente contenido en la clase de entidad de destino. Los datos contenidos en este dataset se utilizarán junto con las entradas de la herramienta para generar una versión actualizada del dataset existente. Este parámetro solo se utiliza en combinación con el parámetro update_existing.

String

Salida derivada

NombreExplicaciónTipo de datos
out_ips_datasets

La clase de entidad de datasets de posicionamiento IPS actualizados que contiene el dataset de posicionamiento en interiores recién creado.

Feature Layer

Muestra de código

Ejemplo 1 de GenerateIndoorPositioningDataset (secuencia de comandos independiente de Python)

La siguiente secuencia de comandos independiente de Python muestra cómo utilizar el método basado en estudios topográficos de la función GenerateIndoorPositioningDataset para generar un dataset de posicionamiento en interiores.

# Name: GenerateIndoorPositioningDataset_example1.py
# Description: Generates an indoor positioning dataset
# using the survey-based method.

# Import system modules
import arcpy.indoorpositioning as ips

# Set local variables
ips_datasets = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\IPS_Positioning_Datasets"
dataset_name = 'NewDataset'
levels = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\Levels"
ips_recordings = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\IPS_Recordings"

# Call the GenerateIndoorPositioningDataset tool

ips.GenerateIndoorPositioningDataset(target_ips_positioning_datasets=ips_datasets,
                                     dataset_name=dataset_name,
                                     generation_method='SURVEY_BASED',
                                     in_levels=levels,
                                     in_ips_recordings=ips_recordings)
Ejemplo 2 de GenerateIndoorPositioningDataset (secuencia de comandos independiente de Python)

La siguiente secuencia de comandos independiente de Python muestra cómo utilizar el método sin estudios topográficos de la función GenerateIndoorPositioningDataset para generar un dataset de posicionamiento en interiores.

# Name: GenerateIndoorPositioningDataset_example2.py
# Description: Generates an indoor positioning dataset
# using the survey-less method.

# Import system modules
import arcpy.indoorpositioning as ips

# Set local variables
ips_datasets = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\IPS_Positioning_Datasets"
dataset_name = 'NewDataset'
levels = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\Levels"
beacons = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\IPS_Beacons"
ips_areas = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\IPS_Areas"
walls = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\\Walls"

# Call the GenerateIndoorPositioningDataset tool
ips.GenerateIndoorPositioningDataset(target_ips_positioning_datasets=ips_datasets,
                                     dataset_name=dataset_name,
                                     generation_method='SURVEY_LESS',
                                     in_levels=levels,
                                     in_beacons=beacons,
                                     in_ips_areas=ips_areas,
                                     in_walls=walls)
Ejemplo 3 de GenerateIndoorPositioningDataset (secuencia de comandos independiente de Python)

La siguiente secuencia de comandos independiente de Python muestra cómo actualizar un dataset de posicionamiento en interiores existente utilizando el método basado en estudios topográficos combinando los datos de un dataset existente y las entradas de la herramienta.

# Name: GenerateIndoorPositioningDataset_example3.py 
# Description: Updates an existing indoor positioning dataset using the
# survey-based method by combining data from an existing dataset and the 
# tool inputs.

# Import system modules 

import arcpy.indoorpositioning as ips

# Set local variables 
ips_datasets = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Positioning_Datasets" 
existing_dataset = 'Dataset1' 
dataset_name = 'Dataset1_updated'
levels = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\Levels" 
ips_recordings = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Recordings" 

# Call the GenerateIndoorPositioningDataset tool 
ips.GenerateIndoorPositioningDataset(target_ips_positioning_datasets=ips_datasets,
                                     dataset_name=dataset_name,
                                     generation_method='SURVEY_BASED',
                                     in_levels=levels,
                                     in_ips_recordings=ips_recordings,
                                     update_existing="UPDATE_EXISTING",
                                     existing_dataset=existing_dataset)

Información de licenciamiento

  • Basic: No
  • Standard: Requiere ArcGIS IPS
  • Advanced: Requiere ArcGIS IPS

Temas relacionados