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

Artigo
06/04/2024

Este artigo mostra como usar dados de localização em um aplicativo 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 local para:

Plote o local relatado em um mapa.
Plote o histórico de localização de telemetria em um mapa.
Crie regras de delimitação geográfica para notificar um operador quando um dispositivo entrar ou sair 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 um 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"
}

Observação

O tipo de esquema de ponto de localização geográfica não faz parte da especificação DTDL. O IoT Central atualmente dá suporte o tipo de esquema geopoint e o tipo semântico location para compatibilidade com versões anteriores. Consulte a extensão do IoT Central.

Enviar dados de localização de um dispositivo

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

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

Quando um dispositivo envia dados para a telemetria Tracking mostrada na seção anterior, o payload se parece com o seguinte snippet JSON:

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

Exibir local do dispositivo

É possível exibir dados de localização em vários locais no aplicativo IoT Central. Por exemplo, em exibições associadas a um dispositivo individual ou a painéis.

Ao criar um modo de exibição para um dispositivo, é possível optar por plotar a localização em um mapa ou mostrar os valores individuais:

É possível adicionar peças de mapa a um painel para plotar a localização de um ou mais dispositivos. Ao adicionar uma peça de mapa para mostrar a telemetria de localização, é possível plotar a localização em um período de tempo, como mostrado na captura de tela anterior.

Criar uma regra de delimitação geográfica

É possível usar a telemetria de localização para criar uma regra de delimitação geográfica que gera um alerta quando um dispositivo passa 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 passa para a área retangular:

Próximas etapas

Agora que você aprendeu a configurar um modelo de dispositivo no aplicativo Azure IoT Central, é possível:

Compartilhar via