Utiliser des données d’emplacement dans une solution Azure IoT Central

  • Article

Cet article explique comment utiliser des données d’emplacement dans une application IoT Central. Un appareil connecté à IoT Central peut envoyer des données d’emplacement sous forme de flux de télémétrie ou utiliser une propriété d’appareil pour signaler des données d’emplacement.

Vous pouvez utiliser les données de localisation pour :

  • Tracer l’emplacement signalé sur une carte.
  • Tracer l’historique des emplacements de télémétrie sur une carte.
  • Créer des règles de geofencing pour notifier un opérateur lorsqu’un appareil entre dans une zone spécifique ou en sort.

Ajouter des fonctionnalités d’emplacement à un modèle d’appareil

La capture d’écran suivante montre un modèle d’appareil avec des exemples de propriété d’appareil et de type de télémétrie utilisant des données d’emplacement. Les définitions utilisent le type sémantique location et le type de schéma geolocation :

Screenshot showing location property definition in device template

Pour référence, les définitions Digital Twins Definition Language (DTDL) V2 de ces fonctionnalités ressemblent à l’extrait de code suivant :

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

Remarque

Le type de schéma geopoint ne fait pas partie de la spécification DTDL. IoT Central prend actuellement en charge le type de schéma geopoint et le type sémantique d’emplacement pour la compatibilité descendante, consultez l’extension IoT Central.

Envoyer des données d’emplacement à partir d’un appareil

Lorsqu’un appareil envoie des données pour la propriété DeviceLocation présentée dans la section précédente, la charge utile ressemble à l’extrait de code JSON suivant :

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

Lorsqu’un appareil envoie des données pour la télémétrie de suivi présentée dans la section précédente, la charge utile ressemble à l’extrait de code JSON suivant :

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

Afficher l'emplacement de l’appareil

Vous pouvez afficher des données d’emplacement à plusieurs endroits de votre application IoT Central. Par exemple, sur des vues associées à un appareil individuel ou sur des tableaux de bord.

Lorsque vous créez une vue pour un appareil, vous pouvez choisir de tracer l’emplacement sur une carte ou d’afficher les valeurs individuelles :

Screenshot showing example view with location data

Vous pouvez ajouter des mosaïques cartographiques à un tableau de bord pour tracer l’emplacement d’un ou plusieurs appareils. Lorsque vous ajoutez une vignette cartographique pour afficher la télémétrie de l’emplacement, vous pouvez tracer l’emplacement sur une période de temps donnée, comme le montre la capture d’écran précédente.

Créer une règle de geofencing

Vous pouvez utiliser la télémétrie d’emplacement pour créer une règle de geofencing générant une alerte lorsqu’un appareil se déplace dans une zone rectangulaire ou en sort. La capture d’écran suivante montre une règle utilisant quatre conditions pour définir une zone rectangulaire à l’aide des valeurs de latitude et de longitude. La règle génère un e-mail lorsque l’appareil se déplace dans la zone rectangulaire :

Screenshot that shows a geofencing rule definition

Étapes suivantes

Maintenant que vous avez appris à utiliser les propriétés dans votre application Azure IoT Central, consultez :