Helyadatok használata Egy Azure IoT Central-megoldásban

  • Cikk

Ez a cikk bemutatja, hogyan használhat helyadatokat egy IoT Central-alkalmazásban. Az IoT Centralhoz csatlakoztatott eszközök telemetriai adatfolyamként küldhetnek helyadatokat, vagy eszköztulajdonságokkal jelenthetik a helyadatokat.

A helyadatok a következő célra használhatók:

  • Ábrázolja a jelentett helyet egy térképen.
  • Térképen ábrázolja a telemetriai helyelőzményeket.
  • Geofencing-szabályokat hozhat létre, amelyek értesítik az operátorokat, amikor egy eszköz belép vagy elhagy egy adott területet.

Helyképességek hozzáadása eszközsablonhoz

Az alábbi képernyőképen egy eszközsablon látható, amelyen példák láthatók egy eszköztulajdonságra és a helyadatokat használó telemetriai típusra. A definíciók a hely szemantikai típusát és a földrajzi hely sématípusát használják:

Screenshot showing location property definition in device template

Referenciaként a Digital Twins Definition Language (DTDL) V2 definíciói ezekhez a képességekhez az alábbi kódrészlethez hasonlóan néznek ki:

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

Feljegyzés

A geopont sématípus nem része a DTDL-specifikációnak. Az IoT Central jelenleg támogatja a geopontséma típusát és a hely szemantikai típusát a visszamenőleges kompatibilitás érdekében, lásd az IoT Central-bővítményt.

Helyadatok küldése eszközről

Amikor egy eszköz adatokat küld az előző szakaszban látható DeviceLocation tulajdonságról, a hasznos adatok a következő JSON-kódrészlethez hasonlóan néznek ki:

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

Amikor egy eszköz adatokat küld az előző szakaszban látható nyomkövetési telemetriához, a hasznos adatok a következő JSON-kódrészlethez hasonlóan néznek ki:

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

Eszköz helyének megjelenítése

A helyadatokat több helyen is megjelenítheti az IoT Central-alkalmazásban. Például az egyes eszközökhöz vagy irányítópultokhoz társított nézeteken.

Amikor létrehoz egy nézetet egy eszközhöz, beállíthatja, hogy térképen ábrázolja a helyet, vagy megjelenítse az egyes értékeket:

Screenshot showing example view with location data

Térképcsempéket is hozzáadhat egy irányítópulthoz egy vagy több eszköz helyének ábrázolásához. Amikor térképcsempét ad hozzá a hely telemetriai adatainak megjelenítéséhez, az előző képernyőképen látható módon ábrázolhatja a helyet egy adott időszakban.

Geofencing szabály létrehozása

Helytelemetria használatával létrehozhat egy geofencing szabályt, amely riasztást hoz létre, amikor egy eszköz egy téglalap alakú területre vagy onnan kilép. Az alábbi képernyőképen egy olyan szabály látható, amely négy feltételt használ egy négyszögletes terület szélességi és hosszúsági értékek használatával történő meghatározásához. A szabály egy e-mailt hoz létre, amikor az eszköz a téglalap alakú területre kerül:

Screenshot that shows a geofencing rule definition

Következő lépések

Most, hogy megtanulta, hogyan használhatja a tulajdonságokat az Azure IoT Central-alkalmazásban, tekintse meg a következőket: