Korzystanie z danych lokalizacji w rozwiązaniu usługi Azure IoT Central

  • Artykuł

W tym artykule pokazano, jak używać danych lokalizacji w aplikacji usługi IoT Central. Urządzenie połączone z usługą IoT Central może wysyłać dane lokalizacji jako strumień telemetrii lub używać właściwości urządzenia do raportowania danych lokalizacji.

Możesz użyć danych lokalizacji, aby:

  • Wykreślij zgłoszoną lokalizację na mapie.
  • Wykreślij historię lokalizacji telemetrii na mapie.
  • Utwórz reguły geofencingu, aby powiadomić operatora o wejściu urządzenia lub opuszczeniu określonego obszaru.

Dodawanie możliwości lokalizacji do szablonu urządzenia

Poniższy zrzut ekranu przedstawia szablon urządzenia z przykładami właściwości urządzenia i typu telemetrii, które używają danych lokalizacji. Definicje używają typu semantycznego lokalizacji i typu schematu geolokalizacji :

Screenshot showing location property definition in device template

Do celów referencyjnych definicje języka DTDL (Digital Twins Definition Language) w wersji 2 dla tych funkcji wyglądają podobnie do następującego fragmentu kodu:

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

Uwaga

Typ schematu punktu geograficznego nie jest częścią specyfikacji DTDL. Usługa IoT Central obecnie obsługuje typ schematu punktu geograficznego i typ semantyczny lokalizacji w celu zapewnienia zgodności z poprzednimi wersjami, zobacz rozszerzenie usługi IoT Central.

Wysyłanie danych lokalizacji z urządzenia

Gdy urządzenie wysyła dane dla właściwości DeviceLocation pokazanej w poprzedniej sekcji, ładunek wygląda podobnie do następującego fragmentu kodu JSON:

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

Gdy urządzenie wysyła dane dotyczące danych telemetrycznych śledzenia pokazanych w poprzedniej sekcji, ładunek wygląda podobnie do następującego fragmentu kodu JSON:

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

Wyświetlanie lokalizacji urządzenia

Dane lokalizacji można wyświetlać w wielu miejscach w aplikacji usługi IoT Central. Na przykład w widokach skojarzonych z pojedynczym urządzeniem lub na pulpitach nawigacyjnych.

Podczas tworzenia widoku dla urządzenia można wybrać wykreślenie lokalizacji na mapie lub pokazać poszczególne wartości:

Screenshot showing example view with location data

Kafelki mapy można dodawać do pulpitu nawigacyjnego, aby wykreślić lokalizację jednego lub większej liczby urządzeń. Po dodaniu kafelka mapy w celu wyświetlenia telemetrii lokalizacji można wykreślić lokalizację w danym okresie, jak pokazano na poprzednim zrzucie ekranu.

Tworzenie reguły geofencingu

Za pomocą telemetrii lokalizacji można utworzyć regułę geofencingu, która generuje alert, gdy urządzenie przechodzi do lub z prostokątnego obszaru. Poniższy zrzut ekranu przedstawia regułę, która używa czterech warunków do zdefiniowania prostokątnego obszaru przy użyciu wartości szerokości i długości geograficznej. Reguła generuje wiadomość e-mail, gdy urządzenie przechodzi do prostokątnego obszaru:

Screenshot that shows a geofencing rule definition

Następne kroki

Teraz, gdy już wiesz, jak używać właściwości w aplikacji usługi Azure IoT Central, zobacz: