Korzystanie z danych lokalizacji w Azure IoT Central rozwiązaniaUse location data in an Azure IoT Central solution

W tym artykule pokazano, jak używać danych lokalizacji w IoT Central aplikacji.This article shows you how to use location data in an IoT Central application. 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 zgłaszania danych lokalizacji.A device connected to IoT Central can send location data as telemetry stream or use a device property to report location data.

Dane lokalizacji mogą być wykorzystywane do:You can use the location data to:

  • Wykreśla zgłoszoną lokalizację na mapie.Plot the reported location on a map.
  • Wykreśl historię lokalizacji telemetrii na mapie.Plot the telemetry location history om a map.
  • Utwórz reguły geofencingu, aby powiadamiać operatora, gdy urządzenie wchodzi do określonego obszaru lub opuszcza go.Create geofencing rules to notify an operator when a device enters or leaves a specific area.

Dodawanie możliwości lokalizacji do szablonu urządzeniaAdd location capabilities to a device template

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.The following screenshot shows a device template with examples of a device property and telemetry type that use location data. Definicje używają semantycznego typu lokalizacji i typu schematu geolokalizacji:The definitions use the location semantic type and the geolocation schema type:

Zrzut ekranu przedstawiający definicję właściwości lokalizacji w szablonie urządzenia

Dla porównania definicje języka Digital Twins definicji (DTDL) dla tych możliwości wyglądają jak poniższy fragment kodu: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"
}

Uwaga

Typ schematu punktu geograficznego nie jest częścią specyfikacji DTDL.The geopoint schema type is not part of the DTDL specification. IoT Central obecnie obsługuje typ schematu punktu geograficznego i semantyczny typ lokalizacji w celu zapewnienia zgodności z poprzednimi wersjami.IoT Central currently supports the geopoint schema type and the location semantic type for backwards compatibility.

Wysyłanie danych lokalizacji z urządzeniaSend location data from a device

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: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
  }
}

Gdy urządzenie wysyła dane telemetryczne śledzenia pokazane w poprzedniej sekcji, ładunek wygląda podobnie do następującego fragmentu kodu 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
  }
}

Wyświetlanie lokalizacji urządzeniaDisplay device location

Dane lokalizacji można wyświetlać w wielu miejscach w IoT Central aplikacji.You can display location data in multiple places in your IoT Central application. Na przykład w widokach skojarzonych z poszczególnymi urządzeniami lub na pulpitach nawigacyjnych.For example, on views associated with an individual device or on dashboards.

Podczas tworzenia widoku dla urządzenia możesz wykreślić lokalizację na mapie lub wyświetlić poszczególne wartości:When you create a view for a device, you can choose to plot the location on a map, or show the individual values:

Zrzut ekranu przedstawiający przykładowy widok z danymi lokalizacji

Kafelki mapy można dodać do pulpitu nawigacyjnego, aby wykreślić lokalizację jednego lub większej liczby urządzeń.You can add map tiles to a dashboard to plot the location of one or more devices. Po dodaniu kafelka mapy w celu pokazania telemetrii lokalizacji można wykreślić lokalizację w okresie czasu.When you add a map tile to show location telemetry, you can plot the location over a time period. Poniższy zrzut ekranu przedstawia lokalizację zgłoszoną przez symulowane urządzenie w ciągu ostatnich 30 minut:The following screenshot shows the location reported by a simulated device over the last 30 minutes:

Zrzut ekranu przedstawiający przykładowy pulpit nawigacyjny z danymi lokalizacji

Tworzenie reguły geofencinguCreate a geofencing rule

Za pomocą telemetrii lokalizacji można utworzyć regułę geofencingu, która generuje alert, gdy urządzenie przemieszcza się do prostokątnego obszaru lub z tego obszaru.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. 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.The following screenshot shows a rule that uses four conditions to define a rectangular area using latitude and longitude values. Reguła generuje wiadomość e-mail, gdy urządzenie przechodzi do prostokątnego obszaru:The rule generates an email when the device moves into the rectangular area:

Zrzut ekranu przedstawiający definicję reguły geofencingu

Następne krokiNext steps

Teraz, gdy już wiesz, jak używać właściwości w aplikacji Azure IoT Central, zobacz:Now that you've learned how to use properties in your Azure IoT Central application, see: