Utilizar dados de localização numa solução do Azure IoT Central

  • Artigo

Este artigo mostra-lhe como utilizar dados de localização numa aplicação do IoT Central. Um dispositivo ligado ao IoT Central pode enviar dados de localização como fluxo de telemetria ou utilizar uma propriedade do dispositivo para comunicar dados de localização.

Pode utilizar os dados de localização para:

  • Desenhe a localização comunicada num mapa.
  • Desenhe o histórico de localizações de telemetria num mapa.
  • Crie regras de geofencagem para notificar um operador quando um dispositivo entra ou sai de uma área específica.

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

A captura de ecrã seguinte mostra um modelo de dispositivo com exemplos de uma propriedade do dispositivo e tipo de telemetria que utilizam dados de localização. As definições utilizam o tipo semântico de localização e o tipo de esquema de geolocalização :

Captura de ecrã a mostrar a definição da propriedade de localização no modelo de dispositivo

Para referência, as definições de Linguagem de Definição do Digital Twins (DTDL) V2 para estas capacidades têm o seguinte aspeto:

{
  "@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 geoponto e o tipo semântico de localização para retrocompatibilidade, veja Extensão do IoT Central.

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

Quando um dispositivo envia dados para a propriedade DeviceLocation apresentada na secção anterior, o payload é semelhante ao seguinte fragmento JSON:

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

Quando um dispositivo envia dados para a telemetria de controlo apresentada na secção anterior, o payload é semelhante ao seguinte fragmento JSON:

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

Apresentar a localização do dispositivo

Pode apresentar dados de localização em vários locais da sua aplicação do IoT Central. Por exemplo, em vistas associadas a um dispositivo individual ou em dashboards.

Quando cria uma vista para um dispositivo, pode optar por desenhar a localização num mapa ou mostrar os valores individuais:

Captura de ecrã a mostrar a vista de exemplo com dados de localização

Pode adicionar mosaicos de mapa a um dashboard para desenhar a localização de um ou mais dispositivos. Quando adiciona um mosaico de mapa para mostrar a telemetria de localização, pode desenhar a localização durante um período de tempo, conforme mostrado na captura de ecrã anterior.

Criar uma regra de geofencing

Pode utilizar 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 ecrã seguinte mostra uma regra que utiliza quatro condições para definir uma área retangular com valores de latitude e longitude. A regra gera um e-mail quando o dispositivo se move para a área retangular:

Captura de ecrã que mostra uma definição de regra de geofencing

Passos seguintes

Agora que aprendeu a utilizar propriedades na sua aplicação do Azure IoT Central, veja: