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

  • Artigo

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 de dispositivo para relatar dados de localização.

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

  • Plote a localização relatada em um mapa.
  • Plote o histórico de localização da telemetria em um mapa.
  • Crie regras de delimitação geográfica 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 degeolocalização :

Screenshot showing location property definition in device template

Para referência, as definições DTDL (Digital Twins Definition Language) V2 para esses recursos se parecem com o seguinte trecho:

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

Nota

O tipo de esquema de geoponto não faz parte da especificação DTDL. Atualmente, o IoT Central suporta o tipo de esquema de geoponto e o tipo semântico de localização para compatibilidade com versões anteriores, consulte Extensão do IoT Central.

Enviar dados de localização a partir de um dispositivo

Quando um dispositivo envia dados para a propriedade DeviceLocation mostrada na seção anterior, a carga útil se parece com o seguinte trecho 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, a carga útil se parece com o seguinte trecho JSON:

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

Localização do dispositivo de visualização

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

Ao criar uma vista para um dispositivo, pode optar por plotar a localização num mapa ou mostrar os valores individuais:

Screenshot showing example view with location data

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

Criar uma regra de delimitação geográfica

Você pode usar a telemetria de localização para criar uma regra de cerca geográfica que gera um alerta quando um dispositivo entra ou sai 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 e-mail quando o dispositivo se move para a área retangular:

Screenshot that shows a geofencing rule definition

Próximos passos

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