Använda platsdata i en Azure IoT Central-lösning

Artikel
03/04/2024

Den här artikeln visar hur du använder platsdata i ett IoT Central-program. En enhet som är ansluten till IoT Central kan skicka platsdata som telemetriström eller använda en enhetsegenskap för att rapportera platsdata.

Du kan använda platsdata för att:

Rita den rapporterade platsen på en karta.
Rita telemetriplatshistoriken på en karta.
Skapa geofencing-regler för att meddela en operatör när en enhet kommer in i eller lämnar ett visst område.

Lägga till platsfunktioner i en enhetsmall

Följande skärmbild visar en enhetsmall med exempel på en enhetsegenskap och telemetrityp som använder platsdata. Definitionerna använder platssemantisk typ och schematyp för geoplats :

Som referens ser DTDL v2-definitionerna (Digital Twins Definition Language) ut som följande kodfragment:

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

Kommentar

Schematypen geopoint ingår inte i DTDL-specifikationen. IoT Central stöder för närvarande geopoint-schematypen och plats semantisk typ för bakåtkompatibilitet, se IoT Central-tillägget.

Skicka platsdata från en enhet

När en enhet skickar data för egenskapen DeviceLocation som visas i föregående avsnitt ser nyttolasten ut som följande JSON-kodfragment:

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

När en enhet skickar data för telemetrispårningen som visas i föregående avsnitt ser nyttolasten ut som följande JSON-kodfragment:

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

Visa enhetens plats

Du kan visa platsdata på flera platser i IoT Central-programmet. Till exempel på vyer som är associerade med en enskild enhet eller på instrumentpaneler.

När du skapar en vy för en enhet kan du välja att rita platsen på en karta eller visa de enskilda värdena:

Du kan lägga till kartpaneler på en instrumentpanel för att rita platsen för en eller flera enheter. När du lägger till en kartpanel för att visa platstelemetri kan du rita platsen under en tidsperiod, enligt föregående skärmbild.

Skapa en geofencing-regel

Du kan använda platstelemetri för att skapa en geofencing-regel som genererar en avisering när en enhet flyttas till eller från ett rektangulärt område. Följande skärmbild visar en regel som använder fyra villkor för att definiera ett rektangulärt område med hjälp av latitud- och longitudvärden. Regeln genererar ett e-postmeddelande när enheten flyttas till det rektangulära området:

Nästa steg

Nu när du har lärt dig hur du använder egenskaper i ditt Azure IoT Central-program kan du läsa:

Dela via