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 :
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:
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:
Volgende stappen
Nu u hebt geleerd hoe u eigenschappen gebruikt in uw Azure IoT Central-toepassing, raadpleegt u: