View a markdown version of this page

Indicizzazione dei dati sulla posizione - AWS IoT Core

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Indicizzazione dei dati sulla posizione

Puoi utilizzare l'indicizzazione del AWS IoT parco veicoli per indicizzare gli ultimi dati sulla posizione inviati dai tuoi dispositivi e cercare i dispositivi utilizzando le geoquery. Questa funzione risolve i casi d'uso del monitoraggio e della gestione dei dispositivi, come il rilevamento della posizione e la ricerca di prossimità. L'indicizzazione della posizione funziona in modo simile ad altre funzionalità di indicizzazione del parco veicoli e con configurazioni aggiuntive da specificare nell'indicizzazione degli oggetti. Gestione dell'indicizzazione del parco istanze

I casi d'uso più comuni includono: ricerca e aggregazione di dispositivi situati entro i confini geografici desiderati, ottenere informazioni specifiche sulla posizione utilizzando termini di query relativi ai metadati e allo stato dei dispositivi da fonti di dati indicizzate, fornire una visualizzazione granulare come il filtraggio dei risultati in un'area geografica specifica per ridurre i ritardi di rendering nelle mappe di monitoraggio della flotta e tracciare l'ultima posizione del dispositivo segnalata e identificare i dispositivi che si trovano al di fuori dei limiti di confine desiderati e generare allarmi utilizzando le metriche della flotta. Per iniziare con l'indicizzazione della posizione e le geoquery, consultaTutorial sulle nozioni di base.

Formati di dati supportati

AWS IoT l'indicizzazione del parco veicoli supporta i seguenti formati di dati sulla posizione:

  1. Well-known rappresentazione testuale dei sistemi di riferimento di coordinate

    Una stringa che segue il formato Informazioni geografiche - rappresentazione Well-known testuale dei sistemi di riferimento di coordinate. Un esempio può essere"POINT(long lat)".

  2. Una stringa che rappresenta le coordinate

    Una stringa con il formato "latitude, longitude" o"longitude, latitude". Se si utilizza"longitude, latitude", è necessario specificare anche order ingeoLocations. Un esempio può essere"41.12,-71.34".

  3. Un oggetto con i tasti lat (latitudine), lon (longitudine)

    Questo formato è applicabile alle ombre classiche e alle ombre denominate. Chiavi supportate: latlatitude,lon,,long,longitude. Un esempio può essere{"lat": 41.12, "lon": -71.34}.

  4. Una matrice che rappresenta le coordinate

    Un array con il formato [lat,lon] o[lon,lat]. Se usi il formato[lon,lat], che è lo stesso delle coordinate in GeoJSON (applicabile a shadow classico e named shadow), devi specificare order anche in. geoLocations

    Un esempio può essere:

    { "location": { "coordinates": [ **Longitude**, **Latitude** ], "type": "Point", "properties": { "country": "United States", "city": "New York", "postalCode": "*****", "horizontalAccuracy": 20, "horizontalConfidenceLevel": 0.67, "state": "New York", "timestamp": "2023-01-04T20:59:13.024Z" } } }

Come indicizzare i dati sulla posizione

I passaggi seguenti mostrano come aggiornare la configurazione di indicizzazione per i dati sulla posizione e utilizzare le geoquery per cercare i dispositivi.

  1. Scopri dove sono archiviati i dati sulla tua posizione

    L'indicizzazione del parco veicoli attualmente supporta l'indicizzazione dei dati sulla posizione archiviati nelle ombre classiche o nelle ombre denominate.

  2. Utilizza i formati di dati sulla posizione supportati

    Assicurati che il formato dei dati sulla posizione sia conforme a uno dei formati di dati supportati.

  3. Aggiorna la configurazione di indicizzazione

    Come minimo necessario, abilita la configurazione di indicizzazione degli oggetti (registro). È inoltre necessario abilitare l'indicizzazione su shadow classici o named shadow che contengono i dati sulla posizione. Quando aggiorni l'indicizzazione degli oggetti, dovresti includere i dati sulla posizione nella configurazione di indicizzazione.

  4. Crea ed esegui geoquery

    A seconda dei casi d'uso, crea delle geoquery ed eseguile per cercare i dispositivi. La geoquery che componi deve seguire la sintassi Query. https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html Alcuni esempi sono disponibili in Geointerrogazioni di esempio.

Aggiorna la configurazione di indicizzazione degli oggetti

Per indicizzare i dati sulla posizione, è necessario aggiornare la configurazione di indicizzazione e includere i dati sulla posizione. A seconda di dove sono archiviati i dati sulla posizione, segui i passaggi per aggiornare la configurazione di indicizzazione:

Se i dati sulla posizione sono archiviati in un'ombra classica, è thingIndexingMode necessario impostarli REGISTRY_AND_SHADOW e specificarli nei geoLocations campi (nameeorder) in filter.

Nel seguente esempio di configurazione dell'indicizzazione degli oggetti, si specifica il percorso dei dati sulla posizione shadow.reported.coordinates as name e LonLat as. order

{ "thingIndexingMode": "REGISTRY_AND_SHADOW", "filter": { "geoLocations": [ { "name": "shadow.reported.coordinates", "order": "LonLat" } ] } }
  • thingIndexingMode

    La modalità di indicizzazione controlla se il registro o lo shadow sono indicizzati. Quando thingIndexingMode è impostata suOFF, l'indicizzazione degli oggetti è disabilitata.

    Per indicizzare i dati sulla posizione archiviati in un'ombra classica, è necessario thingIndexingMode impostarlo su. REGISTRY_AND_SHADOW Per ulteriori informazioni, consulta Modalità di indicizzazione degli oggetti.

  • filter

    Il filtro di indicizzazione fornisce selezioni aggiuntive per le ombre denominate e i dati di geolocalizzazione. Per ulteriori informazioni, consulta Filtro di indicizzazione.

  • geoLocations

    L'elenco degli obiettivi di geolocalizzazione selezionati per l'indicizzazione. Il numero massimo predefinito di obiettivi di geolocalizzazione per l'indicizzazione è. 1 Per aumentare il limite, vedi Quote. AWS IoT Device Management

  • name

    Il nome del campo di destinazione della geolocalizzazione. Un valore di esempio di name può essere il percorso dei dati sulla posizione della tua ombra:. shadow.reported.coordinates

  • order

    L'ordine del campo di destinazione della geolocalizzazione. Valori validi: LatLon e. LonLat LatLonindica latitudine e longitudine. LonLatsignifica longitudine e latitudine. Questo campo è facoltativo. Il valore predefinito è LatLon.

Se i dati sulla posizione sono memorizzati in un'ombra denominata, namedShadowIndexingMode impostata su beON, aggiungi i nomi delle ombre denominate nel namedShadowNames campo in filter e specifica il percorso dei dati di posizione nel geoLocations campo in filter.

Nel seguente esempio di configurazione dell'indicizzazione, specifichi il percorso dei dati sulla posizione shadow.name.namedShadow1.reported.coordinates as name e LonLat as. order

{ "thingIndexingMode": "REGISTRY", "namedShadowIndexingMode": "ON", "filter": { "namedShadowNames": [ "namedShadow1" ], "geoLocations": [ { "name": "shadow.name.namedShadow1.reported.coordinates", "order": "LonLat" } ] } }
  • thingIndexingMode

    La modalità di indicizzazione controlla se il registro o lo shadow sono indicizzati. Quando thingIndexingMode è impostata suOFF, l'indicizzazione degli oggetti è disabilitata.

    Per indicizzare i dati sulla posizione memorizzati in un'ombra denominata, è necessario thingIndexingMode impostare su REGISTRY (oREGISTRY_AND_SHADOW). Per ulteriori informazioni, consulta Modalità di indicizzazione degli oggetti.

  • filter

    Il filtro di indicizzazione fornisce selezioni aggiuntive per le ombre denominate e i dati di geolocalizzazione. Per ulteriori informazioni, consulta Filtro di indicizzazione.

  • geoLocations

    L'elenco degli obiettivi di geolocalizzazione selezionati per l'indicizzazione. Il numero massimo predefinito di obiettivi di geolocalizzazione per l'indicizzazione è. 1 Per aumentare il limite, vedi Quote. AWS IoT Device Management

  • name

    Il nome del campo di destinazione della geolocalizzazione. Un valore di esempio di name può essere il percorso dei dati sulla posizione della tua ombra:. shadow.name.namedShadow1.reported.coordinates

  • order

    L'ordine del campo di destinazione della geolocalizzazione. Valori validi: LatLon e. LonLat LatLonindica latitudine e longitudine. LonLatsignifica longitudine e latitudine. Questo campo è facoltativo. Il valore predefinito è LatLon.

Geointerrogazioni di esempio

Dopo aver completato la configurazione di indicizzazione dei dati sulla posizione, esegui delle geoquery per cercare i dispositivi. Puoi anche combinare le tue geoquery con altre stringhe di query. Per ulteriori informazioni, consulta Sintassi delle query e Esempio di query per oggetti.

Esempio di interrogazione 1

Questo esempio presuppone che i dati sulla posizione siano memorizzati in un'ombra gps-tracker denominata. L'output di questo comando è l'elenco dei dispositivi che si trovano entro una distanza radiale di 15,5 km dal punto centrale con coordinate (47.6204, -122.3491).

aws iot search-index --query-string \ "shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km"

Esempio di interrogazione 2

Questo esempio presuppone che i dati sulla posizione siano archiviati in un'ombra classica. L'output di questo comando è l'elenco dei dispositivi che si trovano entro una distanza radiale di 15,5 km dal punto centrale con coordinate (47.6204, -122.3491).

aws iot search-index --query-string \ "shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km"

Esempio di interrogazione 3

Questo esempio presuppone che i dati sulla posizione siano archiviati in un'ombra classica. L'output di questo comando è l'elenco dei dispositivi che non sono collegati e che si trovano al di fuori della distanza radiale di 15,5 km dal punto centrale con coordinate (47.6204, -122.3491).

aws iot search-index --query-string \ "connectivity.connected:false AND (NOT shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km)"