Utilize dados de localização numa solução Azure IoT CentralUse location data in an Azure IoT Central solution

Este artigo mostra-lhe como utilizar dados de localização numa aplicação IoT Central.This article shows you how to use location data in an IoT Central application. Um dispositivo ligado à IoT Central pode enviar dados de localização como fluxo de telemetria ou usar uma propriedade do dispositivo para reportar dados de localização.A device connected to IoT Central can send location data as telemetry stream or use a device property to report location data.

Um construtor de soluções pode usar os dados de localização para:A solution builder can use the location data to:

  • Traçar a localização relatada num mapa.Plot the reported location on a map.
  • Traçar o histórico de localização da telemetria om um mapa.Plot the telemetry location history om a map.
  • Crie regras de geofencagem para notificar um operador quando um dispositivo entra ou sai de uma área específica.Create geofencing rules to notify an operator when a device enters or leaves a specific area.

Adicione capacidades de localização a um modelo de dispositivoAdd location capabilities to a device template

A imagem que se segue mostra um modelo de dispositivo com exemplos de uma propriedade do dispositivo e tipo de telemetria que utilizam dados de localização.The following screenshot shows a device template with examples of a device property and telemetry type that use location data. As definições utilizam o tipo semântico de localização e o tipo de esquema de geolocalização:The definitions use the location semantic type and the geolocation schema type:

Screenshot mostrando a definição de propriedade de localização no modelo do dispositivo

Para referência, as definições de Linguagem de Definição de Gémeos Digitais (DTDL) para estas capacidades parecem o seguinte corte: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

O tipo de esquema de geoponto não faz parte da especificação DTDL.The geopoint schema type is not part of the DTDL specification. A IoT Central suporta atualmente o tipo de esquema de geoponto e o tipo semântico de localização para retrocompatibilidade.IoT Central currently supports the geopoint schema type and the location semantic type for backwards compatibility.

Enviar dados de localização a partir de um dispositivoSend location data from a device

Quando um dispositivo envia dados para a propriedade DeviceLocation mostrada na secção anterior, a carga útil parece o seguinte corte 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
  }
}

Quando um dispositivo envia dados para a telemetria de rastreio mostrada na secção anterior, a carga útil parece o seguinte corte 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
  }
}

Localização do dispositivo de exibiçãoDisplay device location

Pode apresentar dados de localização em vários locais da sua aplicação IoT Central.You can display location data in multiple places in your IoT Central application. Por exemplo, sobre vistas associadas a um dispositivo individual ou em dashboards.For example, on views associated with an individual device or on dashboards.

Quando cria uma vista para um dispositivo, pode optar por traçar a localização num mapa ou mostrar os valores individuais:When you create a view for a device, you can choose to plot the location on a map, or show the individual values:

Screenshot mostrando a vista de exemplo com dados de localização

Pode adicionar azulejos de mapa a um dashboard para traçar a localização de um ou mais dispositivos.You can add map tiles to a dashboard to plot the location of one or more devices. Quando você adiciona um azulejo de mapa para mostrar telemetria de localização, você pode traçar a localização durante um período de tempo.When you add a map tile to show location telemetry, you can plot the location over a time period. A imagem que se segue mostra a localização reportada por um dispositivo simulado nos últimos 30 minutos:The following screenshot shows the location reported by a simulated device over the last 30 minutes:

Screenshot mostrando exemplo painel de instrumentos com dados de localização

Criar uma regra de geofencingCreate a geofencing rule

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.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. A imagem que se segue mostra uma regra que utiliza quatro condições para definir uma área retangular utilizando valores de latitude e longitude.The following screenshot shows a rule that uses four conditions to define a rectangular area using latitude and longitude values. A regra gera um e-mail quando o dispositivo se move para a área retangular:The rule generates an email when the device moves into the rectangular area:

Screenshot que mostra uma definição de regra de geofencing

Passos seguintesNext steps

Agora que aprendeu a usar propriedades na sua aplicação Azure IoT Central, consulte:Now that you've learned how to use properties in your Azure IoT Central application, see: