Usar dados de localização em uma solução do Azure IoT Central

Este artigo mostra como usar dados de localização em um aplicativo do IoT Central. Um dispositivo conectado ao IoT Central pode enviar dados de localização como fluxo de telemetria ou usar uma propriedade do dispositivo para relatar dados de localização.

Você pode usar os dados de localização para:

• Plote o local relatado em um mapa.
• Plote o histórico de localização de telemetria em um mapa.
• Crie regras de geofencing para notificar um operador quando um dispositivo entra ou sai de uma área específica.

Adicionar recursos de localização a um modelo de dispositivo

A captura de tela a seguir mostra um modelo de dispositivo com exemplos de uma propriedade de dispositivo e tipo de telemetria que usam dados de localização. As definições usam o tipo semântico de localização e o tipo de esquema de localização geográfica :

Como referência, as definições de DTDL (Linguagem de Definição de Gêmeo digital) v2 para esses recursos se parecem com o seguinte snippet:

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

Enviar dados de localização de um dispositivo

Quando um dispositivo envia dados para a propriedade DeviceLocation mostrada na seção anterior, o conteúdo se parece com o seguinte snippet JSON:

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

Quando um dispositivo envia dados para a telemetria de rastreamento mostrada na seção anterior, o conteúdo se parece com o seguinte snippet JSON:

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

Exibir o local do dispositivo

Você pode exibir dados de localização em vários locais em seu aplicativo do IoT Central. Por exemplo, em exibições associadas a um dispositivo individual ou em dashboards.

Ao criar um modo de exibição para um dispositivo, você pode optar por plotar o local em um mapa ou mostrar os valores individuais:

Você pode adicionar blocos de mapa a um painel para plotar o local de um ou mais dispositivos. Ao adicionar um bloco de mapa para mostrar a telemetria de localização, você pode plotar o local durante um período de tempo, conforme mostrado na captura de tela anterior.

Criar uma regra de geodelimitação

Você pode usar a telemetria de localização para criar uma regra de geofencing que gera um alerta quando um dispositivo se move para dentro ou para fora de uma área retangular. A captura de tela a seguir mostra uma regra que usa quatro condições para definir uma área retangular usando valores de latitude e longitude. A regra gera um email quando o dispositivo se move para a área retangular:

Próximas etapas

Agora que você sabe como usar propriedades em seu aplicativo do Azure IoT Central, confira:

• Telemetria, propriedade e payloads de comando
• Tutorial: Criar e conectar um aplicativo cliente ao seu aplicativo do Azure IoT Central