Uso de los datos de ubicación en una solución de Azure IoT CentralUse location data in an Azure IoT Central solution

En este artículo se muestra cómo usar los datos de ubicación en una aplicación de IoT Central.This article shows you how to use location data in an IoT Central application. 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.A device connected to IoT Central can send location data as telemetry stream or use a device property to report location data.

Un generador de soluciones puede usar los datos de ubicación para lo siguiente:A solution builder can use the location data to:

  • Trazar la ubicación indicada en un mapa.Plot the reported location on a map.
  • Trazar el historial de ubicaciones de telemetría en un mapa.Plot the telemetry location history om a map.
  • Crear reglas de geovalla para notificar a un operador cuando un dispositivo entra o sale de un área específica.Create geofencing rules to notify an operator when a device enters or leaves a specific area.

Incorporación de capacidades de ubicación a una plantilla de dispositivoAdd location capabilities to a device template

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.The following screenshot shows a device template with examples of a device property and telemetry type that use location data. Las definiciones usan el tipo semántico location y el tipo de esquema geolocation:The definitions use the location semantic type and the geolocation schema type:

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

Como referencia, las definiciones del lenguaje de definición de Digital Twins (DTDL) para estas funciones son similares al siguiente fragmento de código:For reference, the Digital Twins Definition Language (DTDL) definitions for these capabilities look like the following snippet:

{
  "@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.The geopoint schema type is not part of the DTDL specification. Actualmente, IoT Central admite el tipo de esquema geopoint y el tipo semántico location para la compatibilidad con versiones anteriores.IoT Central currently supports the geopoint schema type and the location semantic type for backwards compatibility.

Envío de datos de ubicación desde un dispositivoSend location data from a device

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:When a device sends data for the DeviceLocation property shown in the previous section, the payload looks like the following JSON snippet:

{
  "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:When a device sends data for the Tracking telemetry shown in the previous section, the payload looks like the following JSON snippet:

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

Visualización de la ubicación del dispositivoDisplay device location

Puede mostrar los datos de ubicación en varios lugares de la aplicación de IoT Central.You can display location data in multiple places in your IoT Central application. Por ejemplo, en las vistas asociadas a un dispositivo individual o a los paneles.For example, on views associated with an individual device or on dashboards.

Al crear una vista para un dispositivo, puede optar por trazar la ubicación en un mapa o mostrar los valores individuales:When you create a view for a device, you can choose to plot the location on a map, or show the individual values:

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

Puede agregar mosaicos de mapa a un panel para trazar la ubicación de uno o más dispositivos.You can add map tiles to a dashboard to plot the location of one or more devices. 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.When you add a map tile to show location telemetry, you can plot the location over a time period. En la siguiente captura de pantalla se muestra la ubicación indicada por un dispositivo simulado durante los últimos 30 minutos:The following screenshot shows the location reported by a simulated device over the last 30 minutes:

Captura de pantalla que muestra el panel de ejemplo con datos de ubicación

Creación de una regla de geovallaCreate a geofencing rule

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.You can use location telemetry to create a geofencing rule that generates an alert when a device moves into or out of a rectangular area. 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.The following screenshot shows a rule that uses four conditions to define a rectangular area using latitude and longitude values. La regla genera un correo electrónico cuando el dispositivo se mueve al área rectangular:The rule generates an email when the device moves into the rectangular area:

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

Pasos siguientesNext steps

Ahora que ha aprendido a usar propiedades en una aplicación de Azure IoT Central, consulte:Now that you've learned how to use properties in your Azure IoT Central application, see: