Delen via


Locatiegegevens gebruiken in een Azure IoT Central-oplossing

In dit artikel leest u hoe u locatiegegevens gebruikt in een IoT Central-toepassing. Een apparaat dat is verbonden met IoT Central, kan locatiegegevens verzenden als telemetriestroom of een apparaateigenschap gebruiken om locatiegegevens te rapporteren.

U kunt de locatiegegevens gebruiken om het volgende te doen:

  • Plot de gerapporteerde locatie op een kaart.
  • Teken de locatiegeschiedenis van de telemetrie op een kaart.
  • Maak geofencingregels om een operator op de hoogte te stellen wanneer een apparaat een specifiek gebied binnenkomt of verlaat.

Locatiemogelijkheden toevoegen aan een apparaatsjabloon

In de volgende schermopname ziet u een apparaatsjabloon met voorbeelden van een apparaateigenschap en telemetrietype dat locatiegegevens gebruikt. De definities maken gebruik van het semantische locatietype en het schematype geolocatie :

Schermopname van de definitie van locatie-eigenschap in apparaatsjabloon

Ter referentie zien de DTDL-definities (Digital Twins Definition Language) v2 voor deze mogelijkheden eruit als het volgende fragment:

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

Notitie

Het geopoint-schematype maakt geen deel uit van de DTDL-specificatie. IoT Central ondersteunt momenteel het geopoint-schematype en het locatie-semantische type voor achterwaartse compatibiliteit. Zie de IoT Central-extensie.

Locatiegegevens vanaf een apparaat verzenden

Wanneer een apparaat gegevens verzendt voor de eigenschap DeviceLocation die in de vorige sectie wordt weergegeven, ziet de nettolading eruit als het volgende JSON-fragment:

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

Wanneer een apparaat gegevens verzendt voor de telemetrie bijhouden die in de vorige sectie wordt weergegeven, ziet de nettolading eruit als het volgende JSON-fragment:

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

Apparaatlocatie weergeven

U kunt locatiegegevens weergeven op meerdere plaatsen in uw IoT Central-toepassing. Bijvoorbeeld in weergaven die zijn gekoppeld aan een afzonderlijk apparaat of op dashboards.

Wanneer u een weergave voor een apparaat maakt, kunt u ervoor kiezen om de locatie op een kaart te tekenen of de afzonderlijke waarden weer te geven:

Schermopname van een voorbeeldweergave met locatiegegevens

U kunt kaarttegels toevoegen aan een dashboard om de locatie van een of meer apparaten te tekenen. Wanneer u een kaarttegel toevoegt om locatietelemetrie weer te geven, kunt u de locatie gedurende een bepaalde periode uitzetten, zoals wordt weergegeven in de vorige schermafbeelding.

Een geofencing-regel maken

U kunt locatietelemetrie gebruiken om een geofencingregel te maken waarmee een waarschuwing wordt gegenereerd wanneer een apparaat naar of uit een rechthoekig gebied wordt verplaatst. In de volgende schermopname ziet u een regel die vier voorwaarden gebruikt om een rechthoekig gebied te definiƫren met behulp van waarden voor breedtegraad en lengtegraad. Met de regel wordt een e-mailbericht gegenereerd wanneer het apparaat naar het rechthoekige gebied wordt verplaatst:

Schermopname van een definitie van een geofencing-regel

Volgende stappen

Nu u hebt geleerd hoe u eigenschappen gebruikt in uw Azure IoT Central-toepassing, raadpleegt u: