Locatiegegevens in een Azure IoT Central gebruiken

In dit artikel wordt beschreven hoe u locatiegegevens gebruikt in een IoT Central toepassing. Een apparaat dat is verbonden IoT Central locatiegegevens verzenden als telemetriestroom of een apparaat-eigenschap gebruiken om locatiegegevens te rapporteren.

U kunt de locatiegegevens gebruiken voor het volgende:

  • De gerapporteerde locatie op een kaart plotten.
  • Plot de geschiedenis van de telemetrielocatie om een kaart.
  • Maak geofencingregels om een operator op de hoogte te stellen wanneer een apparaat een bepaald gebied binnenkomt of verlaat.

Locatiemogelijkheden toevoegen aan een apparaatsjabloon

In de volgende schermopname ziet u een apparaatsjabloon met voorbeelden van een apparaat-eigenschap en telemetrietype die gebruikmaken van locatiegegevens. De definities gebruiken het semantische type locatie en het schematype geolocatie:

Schermopname van de definitie van de locatie-eigenschap in de apparaatsjabloon

Ter referentie zien de definities Digital Twins Definition Language (DTDL) voor deze mogelijkheden er als volgt uit:

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

Notitie

Het geopuntschematype maakt geen deel uit van de DTDL-specificatie. IoT Central ondersteunt momenteel het geopuntschematype en het semantische locatietype voor achterwaartse compatibiliteit.

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 tracering 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 op meerdere plaatsen in uw IoT Central weergeven. Bijvoorbeeld over 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 plotten 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 uit te zetten. Wanneer u een kaarttegel toevoegt om locatie-telemetrie weer te geven, kunt u de locatie gedurende een bepaalde periode plotten. In de volgende schermopname ziet u de locatie die door een gesimuleerd apparaat in de afgelopen 30 minuten is gerapporteerd:

Schermopname van voorbeelddashboard met locatiegegevens

Een geofencingregel maken

U kunt locatie-telemetrie gebruiken om een geofencingregel te maken die een waarschuwing genereert wanneer een apparaat naar of buiten 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 de definitie van een geofencingregel

Volgende stappen

Nu u hebt geleerd hoe u eigenschappen gebruikt in uw Azure IoT Central toepassing, gaat u naar: