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:
-
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)". -
Una stringa che rappresenta le coordinate
Una stringa con il formato
"latitude, longitude"o"longitude, latitude". Se si utilizza"longitude, latitude", è necessario specificare ancheorderingeoLocations. Un esempio può essere"41.12,-71.34". -
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}. -
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 orderanche in.geoLocationsUn 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.
-
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.
-
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.
-
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.
-
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" } ] } }
-
thingIndexingModeLa 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
thingIndexingModeimpostarlo su.REGISTRY_AND_SHADOWPer ulteriori informazioni, consulta Modalità di indicizzazione degli oggetti. -
filterIl filtro di indicizzazione fornisce selezioni aggiuntive per le ombre denominate e i dati di geolocalizzazione. Per ulteriori informazioni, consulta Filtro di indicizzazione.
-
geoLocationsL'elenco degli obiettivi di geolocalizzazione selezionati per l'indicizzazione. Il numero massimo predefinito di obiettivi di geolocalizzazione per l'indicizzazione è.
1Per aumentare il limite, vedi Quote. AWS IoT Device Management -
nameIl nome del campo di destinazione della geolocalizzazione. Un valore di esempio di
namepuò essere il percorso dei dati sulla posizione della tua ombra:.shadow.reported.coordinates -
orderL'ordine del campo di destinazione della geolocalizzazione. Valori validi:
LatLone.LonLatLatLonindica 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" } ] } }
-
thingIndexingModeLa 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
thingIndexingModeimpostare suREGISTRY(oREGISTRY_AND_SHADOW). Per ulteriori informazioni, consulta Modalità di indicizzazione degli oggetti. -
filterIl filtro di indicizzazione fornisce selezioni aggiuntive per le ombre denominate e i dati di geolocalizzazione. Per ulteriori informazioni, consulta Filtro di indicizzazione.
-
geoLocationsL'elenco degli obiettivi di geolocalizzazione selezionati per l'indicizzazione. Il numero massimo predefinito di obiettivi di geolocalizzazione per l'indicizzazione è.
1Per aumentare il limite, vedi Quote. AWS IoT Device Management -
nameIl nome del campo di destinazione della geolocalizzazione. Un valore di esempio di
namepuò essere il percorso dei dati sulla posizione della tua ombra:.shadow.name.namedShadow1.reported.coordinates -
orderL'ordine del campo di destinazione della geolocalizzazione. Valori validi:
LatLone.LonLatLatLonindica 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)"