Uso de los datos de ubicación en una solución de Azure IoT Central

  • Artículo

En este artículo se muestra cómo usar los datos de ubicación en una aplicación de IoT Central. Un dispositivo conectado a IoT Central puede enviar datos de ubicación como flujo de telemetría o usar una propiedad de dispositivo para informar sobre los datos de ubicación.

Puede usar los datos de ubicación para:

  • Trazar la ubicación indicada en un mapa.
  • Trazar el historial de ubicaciones de telemetría en un mapa.
  • Crear reglas de geovalla para notificar a un operador cuando un dispositivo entra o sale de un área específica.

Incorporación de capacidades de ubicación a una plantilla de dispositivo

En la captura de pantalla siguiente se muestra una plantilla de dispositivo con ejemplos de una propiedad de dispositivo y un tipo de telemetría que usan datos de ubicación. Las definiciones usan el tipo semántico location y el tipo de esquema geolocation:

Screenshot showing location property definition in device template

Como referencia, las definiciones del lenguaje de definición de Digital Twins (DTDL) V2 para estas funciones son similares al siguiente fragmento de código:

{
  "@type": [
    "Property",
    "Location"
  ],
  "displayName": {
    "en": "DeviceLocation"
  },
  "name": "DeviceLocation",
  "schema": "geopoint",
  "writable": false
},
{
  "@type": [
    "Telemetry",
    "Location"
  ],
  "displayName": {
    "en": "Tracking"
  },
  "name": "Tracking",
  "schema": "geopoint"
}

Nota:

El tipo de esquema geopoint no es parte de la especificación de DTDL. Actualmente, IoT Central admite el tipo de esquema de punto geográfico y el tipo semántico de ubicación para la compatibilidad con versiones anteriores, consulte Extensión de IoT Central.

Envío de datos de ubicación desde un dispositivo

Cuando un dispositivo envía datos para la propiedad DeviceLocation que se muestra en la sección anterior, la carga útil es similar al siguiente fragmento de código JSON:

{
  "DeviceLocation": {
    "lat": 47.64263,
    "lon": -122.13035,
    "alt": 0
  }
}

Cuando un dispositivo envía datos para la telemetría Tracking que se muestra en la sección anterior, la carga útil es similar al siguiente fragmento de código JSON:

{
  "Tracking": {
    "lat": 47.64263,
    "lon": -122.13035,
    "alt": 0
  }
}

Visualización de la ubicación del dispositivo

Puede mostrar los datos de ubicación en varios lugares de la aplicación de IoT Central. Por ejemplo, en las vistas asociadas a un dispositivo individual o a los paneles.

Al crear una vista para un dispositivo, puede optar por trazar la ubicación en un mapa o mostrar los valores individuales:

Screenshot showing example view with location data

Puede agregar mosaicos de mapa a un panel para trazar la ubicación de uno o más dispositivos. Cuando se agrega un mosaico de mapa para mostrar la telemetría de ubicación, se puede trazar la ubicación en un periodo de tiempo, como se muestra en la captura de pantalla anterior.

Creación de una regla de geovalla

Puede usar la telemetría de ubicación para crear una regla de geovalla que genera una alerta cuando un dispositivo se mueve dentro o fuera de un área rectangular. En la siguiente captura de pantalla se muestra una regla que usa cuatro condiciones para definir un área rectangular con valores de latitud y longitud. La regla genera un correo electrónico cuando el dispositivo se mueve al área rectangular:

Screenshot that shows a geofencing rule definition

Pasos siguientes

Ahora que ha aprendido a usar propiedades en una aplicación de Azure IoT Central, consulte: