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

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 telemetrins platshistorik på en karta.
  • Skapa geofencing-regler för att meddela en operatör när en enhet går 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 geoplatsschematyp :

Screenshot showing location property definition in device template

Som referens ser DTDL-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"
}

Anteckning

Schematypen geopoint ingår inte i DTDL-specifikationen. IoT Central stöder för närvarande geopunktsschematypen och platssemantisk typ för bakåtkompatibilitet.

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:

Screenshot showing example view with location data

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. Följande skärmbild visar den plats som rapporterats av en simulerad enhet under de senaste 30 minuterna:

Screenshot showing example dashboard with location data

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:

Screenshot that shows a geofencing rule definition

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: