Compartir a través de


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

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 notificar datos de ubicación.

Puede utilizar los datos de ubicación para:

  • Traza la ubicación reportada en un mapa.
  • Traza el historial de ubicaciones de telemetría en un mapa.
  • Cree reglas de geovallas para notificar a un operador cuando un dispositivo entra o sale de un área específica.

Agregar 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 utilizan el tipo semántico de ubicación y el tipo de esquema de geolocalización :

Captura de pantalla que muestra la definición de la propiedad de ubicación en la plantilla de dispositivo

Como referencia, las definiciones del lenguaje de definición de gemelos digitales (DTDL) v2 para estas capacidades tienen un aspecto similar 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 de geopunto no forma parte de la especificación DTDL. IoT Central admite actualmente 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.

Enviar 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 tiene un aspecto 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 de seguimiento que se muestra en la sección anterior, la carga tiene un aspecto similar al siguiente fragmento de código JSON:

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

Mostrar la ubicación del dispositivo

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

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

Captura de pantalla que muestra una vista de ejemplo con datos de ubicación

Puede agregar mosaicos de mapa a un cuadro de mando para trazar la ubicación de uno o varios dispositivos. Al agregar un mosaico de mapa para mostrar la telemetría de ubicación, puede trazar la ubicación durante un período de tiempo, como se muestra en la captura de pantalla anterior.

Crear una regla de geovallas

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

Captura de pantalla que muestra una definición de regla de geovalla

Pasos siguientes

Ahora que sabe cómo usar las propiedades en la aplicación de Azure IoT Central, consulte: