Condividi tramite


Usare i dati sulla posizione in una soluzione Azure IoT Central

Questo articolo illustra come usare i dati sulla posizione in un'applicazione IoT Central. Un dispositivo connesso a IoT Central può inviare dati sulla posizione come flusso di telemetria o usare una proprietà del dispositivo per segnalare i dati sulla posizione.

È possibile usare i dati sulla posizione per:

  • Tracciare la posizione segnalata su una mappa.
  • Tracciare la cronologia della posizione dei dati di telemetria su una mappa.
  • Creare regole di geofencing per notificare a un operatore quando un dispositivo entra o lascia un'area specifica.

Aggiungere funzionalità di posizione a un modello di dispositivo

Lo screenshot seguente mostra un modello di dispositivo con esempi di una proprietà del dispositivo e un tipo di telemetria che usano i dati di posizione. Le definizioni usano il tipo semantico di posizione e il tipo di schema di georilevazione :

Screenshot che mostra la definizione della proprietà della posizione nel modello di dispositivo

Per riferimento, le definizioni DTDL (Digital Twins Definition Language) v2 per queste funzionalità sono simili al frammento di codice seguente:

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

Nota

Il tipo di schema del punto geografico non fa parte della specifica DTDL. IoT Central supporta attualmente il tipo di schema geopoint e il tipo semantico di posizione per la compatibilità con le versioni precedenti, vedere Estensione IoT Central.

Inviare dati sulla posizione da un dispositivo

Quando un dispositivo invia dati per la proprietà DeviceLocation illustrata nella sezione precedente, il payload è simile al frammento JSON seguente:

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

Quando un dispositivo invia dati per i dati di telemetria di rilevamento mostrati nella sezione precedente, il payload è simile al frammento JSON seguente:

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

Visualizzare la posizione del dispositivo

È possibile visualizzare i dati sulla posizione in più posizioni nell'applicazione IoT Central. Ad esempio, nelle visualizzazioni associate a un singolo dispositivo o nei dashboard.

Quando si crea una visualizzazione per un dispositivo, è possibile scegliere di tracciare la posizione in una mappa o visualizzare i singoli valori:

Screenshot che mostra la visualizzazione di esempio con i dati sulla posizione

È possibile aggiungere riquadri mappa a un dashboard per tracciare la posizione di uno o più dispositivi. Quando si aggiunge un riquadro della mappa per visualizzare i dati di telemetria della posizione, è possibile tracciare la posizione in un periodo di tempo, come illustrato nello screenshot precedente.

Creare una regola di geofencing

È possibile usare i dati di telemetria della posizione per creare una regola di geofencing che genera un avviso quando un dispositivo si sposta in o fuori da un'area rettangolare. Lo screenshot seguente mostra una regola che usa quattro condizioni per definire un'area rettangolare usando valori di latitudine e longitudine. La regola genera un messaggio di posta elettronica quando il dispositivo si sposta nell'area rettangolare:

Screenshot che mostra una definizione di regola di geofencing

Passaggi successivi

Dopo aver appreso come usare le proprietà nell'applicazione Azure IoT Central, vedere: