Använda plats data i en Azure IoT Central-lösningUse location data in an Azure IoT Central solution

Den här artikeln visar hur du använder plats data i ett IoT Central-program.This article shows you how to use location data in an IoT Central application. En enhet som är ansluten till IoT Central kan skicka plats data som telemetri-Stream eller använda en enhets egenskap för att rapportera plats data.A device connected to IoT Central can send location data as telemetry stream or use a device property to report location data.

Ett Solution Builder kan använda plats data för att:A solution builder can use the location data to:

  • Rita den rapporterade platsen på en karta.Plot the reported location on a map.
  • Kartlägg plats historiken för telemetri om en karta.Plot the telemetry location history om a map.
  • Skapa regler för avgränsning för att meddela en operatör när en enhet går in eller lämnar ett angivet utrymme.Create geofencing rules to notify an operator when a device enters or leaves a specific area.

Lägga till plats funktioner i en enhets mallAdd location capabilities to a device template

Följande skärm bild visar en enhets mall med exempel på en enhets egenskap och telemetri som använder plats data.The following screenshot shows a device template with examples of a device property and telemetry type that use location data. Definitionerna använder den semantiska plats typen och schema typen för geolokalisering:The definitions use the location semantic type and the geolocation schema type:

Skärm bild som visar definition för plats egenskap i enhets mal len

För referens ser de digitala DTDL-definitionerna (Endefinierade definitions språk) för dessa funktioner ut som i följande kodfragment: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"
}

Anteckning

Schema typen för den här typen är inte en del av DTDL-specifikationen.The geopoint schema type is not part of the DTDL specification. IoT Central stöder för närvarande schema typen för geolokalisering och den semantiska plats typen för bakåtkompatibilitet.IoT Central currently supports the geopoint schema type and the location semantic type for backwards compatibility.

Skicka plats data från en enhetSend location data from a device

När en enhet skickar data för egenskapen DeviceLocation som visas i föregående avsnitt, ser nytto lasten ut som följande JSON-kodfragment: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
  }
}

När en enhet skickar data för spårnings telemetri som visas i föregående avsnitt, ser nytto lasten ut som följande JSON-kodfragment: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
  }
}

Visa enhets platsDisplay device location

Du kan visa plats data på flera platser i IoT Central-programmet.You can display location data in multiple places in your IoT Central application. Till exempel för vyer som är kopplade till en enskild enhet eller på instrument paneler.For example, on views associated with an individual device or on dashboards.

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:When you create a view for a device, you can choose to plot the location on a map, or show the individual values:

Skärm bild som visar exempel visning med plats data

Du kan lägga till kart paneler på en instrument panel för att rita platsen för en eller flera enheter.You can add map tiles to a dashboard to plot the location of one or more devices. När du lägger till en kart panel för att Visa telemetri för platser kan du rita upp platsen under en tids period.When you add a map tile to show location telemetry, you can plot the location over a time period. Följande skärm bild visar platsen som rapporteras av en simulerad enhet under de senaste 30 minuterna:The following screenshot shows the location reported by a simulated device over the last 30 minutes:

Skärm bild som visar exempel instrument panel med plats data

Skapa en regel för avgränsningCreate a geofencing rule

Du kan använda telemetri för att skapa en regel för en avgränsning som genererar en avisering när en enhet flyttas in i eller ut ur ett rektangulärt område.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. Följande skärm bild visar en regel som använder fyra villkor för att definiera ett rektangulärt område med hjälp av latitud-och longitud-värden.The following screenshot shows a rule that uses four conditions to define a rectangular area using latitude and longitude values. Regeln genererar ett e-postmeddelande när enheten flyttas till det rektangulära utrymmet:The rule generates an email when the device moves into the rectangular area:

Skärm bild som visar en regel definition för en inhägnad

Nästa stegNext steps

Nu när du har lärt dig hur du använder egenskaper i ditt Azure IoT Central-program, se:Now that you've learned how to use properties in your Azure IoT Central application, see: