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à. # Inizia a usare i tracker di Amazon Location Service Questa sezione fornisce una guida completa alla creazione e all'uso di tracker con Amazon Location. I tracker consentono di archiviare, elaborare e valutare le posizioni dei dispositivi filtrando al contempo gli aggiornamenti della posizione per ridurre il rumore e gestire i costi. Con opzioni avanzate di filtraggio della posizione, supporto per raccolte di geofence collegate e integrazione con AWS servizi come EventBridge IoT Core, i tracker consentono applicazioni di tracciamento e geofencing accurate in tempo reale su misura per le tue esigenze specifiche. **Topics** + [Crea un localizzatore](start-create-tracker.md) + [Autenticazione delle tue richieste](tracking-identity-pool.md) + [Aggiorna il tracker con la posizione del dispositivo](send-location-updates.md) + [Ottieni la cronologia delle posizioni di un dispositivo da un tracker](get-location-history.md) + [Elenca le posizioni dei tuoi dispositivi](list-device-positions.md) # Crea un localizzatore Crea una risorsa tracker per archiviare ed elaborare gli aggiornamenti di posizione dai tuoi dispositivi. Puoi utilizzare la console Amazon Location Service AWS CLI, o Amazon Location APIs. Ogni aggiornamento della posizione memorizzato nelle risorse del tracker può includere una misura della precisione della posizione e fino a tre campi di metadati sulla posizione o sul dispositivo che desideri memorizzare. I metadati vengono memorizzati come coppie chiave-valore e possono memorizzare informazioni come velocità, direzione, pressione dei pneumatici o temperatura del motore. I tracker filtrano gli aggiornamenti di posizione non appena vengono ricevuti. Ciò riduce il rumore visivo nei percorsi del dispositivo (chiamato *jitter*) e il numero di falsi eventi di ingresso e uscita da geofence. Ciò aiuta anche a gestire i costi riducendo il numero di valutazioni di geofence avviate. I tracker offrono tre opzioni di filtraggio della posizione per aiutare a gestire i costi e ridurre il jitter negli aggiornamenti delle posizioni. + **Basato sulla precisione: utilizzabile** *con qualsiasi dispositivo che fornisce una misurazione di precisione. La maggior parte dei dispositivi mobili fornisce queste informazioni.* La precisione di ogni misurazione della posizione è influenzata da molti fattori ambientali, tra cui la ricezione satellitare GPS, il paesaggio e la vicinanza dei dispositivi Wi-Fi e Bluetooth. La maggior parte dei dispositivi, inclusa la maggior parte dei dispositivi mobili, è in grado di fornire una stima dell'accuratezza della misurazione insieme alla misurazione. Con `AccuracyBased` il filtraggio, Amazon Location ignora gli aggiornamenti sulla posizione se il dispositivo si è spostato meno della precisione misurata. Ad esempio, se due aggiornamenti consecutivi da un dispositivo hanno un intervallo di precisione compreso tra 5 m e 10 m, Amazon Location ignora il secondo aggiornamento se il dispositivo si è spostato a meno di 15 m. Amazon Location non valuta gli aggiornamenti ignorati rispetto ai geofence, né li archivia. Se la precisione non viene fornita, viene considerata pari a zero e la misurazione è considerata perfettamente accurata. **Nota** È inoltre possibile utilizzare filtri basati sulla precisione per rimuovere tutti i filtri. Se selezioni il filtraggio basato sulla precisione, ma sostituisci tutti i dati di precisione a zero o ometti completamente la precisione, Amazon Location non filtrerà alcun aggiornamento. + Basato **sulla distanza**: *utilizzalo quando i tuoi dispositivi non forniscono una misurazione di precisione, ma desideri comunque sfruttare il filtraggio per* ridurre il jitter e gestire i costi. `DistanceBased`il filtraggio ignora gli aggiornamenti sulla posizione in cui i dispositivi si sono spostati a meno di 30 m (98,4 piedi). Quando utilizzi il filtro di `DistanceBased` posizione, Amazon Location non valuta questi aggiornamenti ignorati rispetto ai geofence né archivia gli aggiornamenti. La precisione della maggior parte dei dispositivi mobili, inclusa la precisione media dei dispositivi iOS e Android, è entro 15 m. Nella maggior parte delle applicazioni, il `DistanceBased` filtraggio può ridurre l'effetto delle imprecisioni di posizione quando si visualizza la traiettoria del dispositivo su una mappa e l'effetto di rimbalzo di più eventi consecutivi di entrata e uscita quando i dispositivi si trovano vicino al confine di un geofence. Può anche contribuire a ridurre il costo dell'applicazione, effettuando meno chiamate per effettuare valutazioni sulla base di geofence collegati o recuperare le posizioni dei dispositivi. + **Basato sul tempo**: (impostazione predefinita) *Utilizzalo quando i dispositivi inviano aggiornamenti di posizione molto frequentemente (più di una volta ogni 30 secondi) e desideri ottenere valutazioni dei geofence quasi in tempo reale senza archiviare* ogni aggiornamento.Nel `TimeBased` filtraggio, ogni aggiornamento di posizione viene valutato sulla base di raccolte di geofence collegate, ma non tutti gli aggiornamenti di posizione vengono archiviati. Se la frequenza di aggiornamento è superiore a 30 secondi, viene archiviato un solo aggiornamento ogni 30 secondi per ogni ID dispositivo univoco. **Nota** Fai attenzione ai costi della tua applicazione di tracciamento quando decidi il metodo di filtraggio e la frequenza degli aggiornamenti delle posizioni. Ti verrà addebitato ogni aggiornamento della posizione e una volta per la valutazione dell'aggiornamento della posizione rispetto a ciascuna raccolta di geofence collegata. Ad esempio, quando si utilizza il filtro basato sul tempo, se il tracker è collegato a due raccolte di geofence, ogni aggiornamento di posizione verrà conteggiato come una richiesta di aggiornamento della posizione e due valutazioni della raccolta di geofence. Se segnali aggiornamenti di posizione ogni 5 secondi per i tuoi dispositivi e utilizzi il filtro basato sul tempo, ti verranno fatturati 720 aggiornamenti della posizione e 1.440 valutazioni di geofence all'ora per ciascun dispositivo. La tua fattura non è influenzata dal numero di geofence presenti in ciascuna raccolta. Poiché ogni raccolta di geofence può contenere fino a 50.000 geofence, potresti voler combinare i geofence in un numero inferiore di raccolte, ove possibile, per ridurre i costi delle valutazioni dei geofence. Per impostazione predefinita, riceverai EventBridge eventi ogni volta che un dispositivo tracciato entra o esce da un geofence collegato. Per ulteriori informazioni, consulta [Collega un tracker a una raccolta di geofence](associate-consumer.md). Puoi abilitare gli eventi per tutti gli aggiornamenti di posizione filtrati per una risorsa tracker. Per ulteriori informazioni, consulta [Abilita gli eventi di aggiornamento per un tracker](location-events.md#enable-update-events). **Nota** Se desideri crittografare i tuoi dati utilizzando la tua chiave gestita AWS KMS dal cliente, la funzione Bounding Polygon Queries sarà disabilitata per impostazione predefinita. Questo perché utilizzando questa funzione Bounding Polygon Queries, una rappresentazione delle posizioni del dispositivo non verrà crittografata utilizzando la chiave gestita. AWS KMS Tuttavia, la posizione esatta del dispositivo viene comunque crittografata utilizzando la chiave gestita. Puoi scegliere di attivare la funzione Bounding Polygon Queries impostando il `KmsKeyEnableGeospatialQueries` parametro su true durante la creazione o l'aggiornamento di un Tracker. ------ #### [ Console ] **Per creare un tracker utilizzando la console Amazon Location** 1. Apri la console Amazon Location Service all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Nel riquadro di navigazione a sinistra, scegli **Trackers**. 1. Scegli **Crea tracker**. 1. Compila i seguenti campi: + ****Nome****: inserisci un nome univoco. Ad esempio, *ExampleTracker*. Massimo 100 caratteri. Le voci valide includono caratteri alfanumerici, trattini, punti e caratteri di sottolineatura. + ****Descrizione: inserisci una descrizione**** opzionale. 1. In **Filtro di posizione**, scegli l'opzione più adatta al modo in cui intendi utilizzare la risorsa del tracker. Se non imposti il **filtro di posizione, l'**impostazione predefinita è. `TimeBased` Per ulteriori informazioni, [Localizzatori Amazon Location Service](trackers.md) consulta questa guida e `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)` l'Amazon Location Service Trackers API Reference. 1. (Facoltativo) In **Tag**, immettere **Key (Chiave)** e **Value (Valore)** di un tag. Questo aggiunge un tag alla tua nuova collezione di geofence. Per ulteriori informazioni, consulta [Come usare i tag](manage-resources.md#manage-resources_how-to). 1. (Facoltativo) In **Crittografia a chiave gestita dal cliente**, puoi scegliere di **aggiungere una chiave gestita dal cliente**. Questo aggiunge una chiave simmetrica gestita dal cliente che puoi creare, possedere e gestire tramite la crittografia predefinita AWS di proprietà. Per ulteriori informazioni, consulta [Crittografia dei dati](encryption-at-rest.md) inattivi. 1. (Facoltativo) In **KmsKeyEnableGeospatialQueries**, puoi scegliere di abilitare le interrogazioni **geospaziali**. Ciò consente di utilizzare la funzione Bounding Polygon Queries, crittografando al contempo i dati utilizzando una chiave gestita dal KMS del cliente. AWS **Nota** Quando si utilizza la funzione Bounding Polygon Queries, una rappresentazione delle posizioni del dispositivo non viene crittografata utilizzando la chiave gestita. AWS KMS Tuttavia, la posizione esatta del dispositivo viene comunque crittografata utilizzando la chiave gestita. 1. (Facoltativo) In **EventBridge configurazione**, potete scegliere di abilitare EventBridge gli eventi per gli aggiornamenti delle posizioni filtrati. Questo invierà un evento ogni volta che un aggiornamento di posizione per un dispositivo in questo tracker soddisfa la valutazione del filtro di posizione. 1. Scegli **Crea tracker**. ------ #### [ API ] **Per creare un tracker utilizzando Amazon Location APIs** Usa l'`[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente utilizza una richiesta API per creare un tracker chiamato. *ExampleTracker* La risorsa tracker è associata a una [AWS KMS chiave gestita dal cliente per crittografare i dati dei clienti](encryption-at-rest.md) e non [consente l'aggiornamento delle posizioni. EventBridge](location-events.md#enable-update-events) ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": false, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` **Crea un tracker con abilitato `KmsKeyEnableGeospatialQueries`** L'esempio seguente ha il parametro `KmsKeyEnableGeospatialQueries` impostato su true. Ciò consente di utilizzare la funzionalità Bounding Polygon Queries, crittografando i dati utilizzando una chiave gestita dal cliente. AWS KMS Per informazioni sull'utilizzo della funzione Bounding Polygon Queries, vedi [Elenca le posizioni dei tuoi dispositivi](list-device-positions.md) **Nota** Quando utilizzate la funzione Bounding Polygon Queries, una rappresentazione delle posizioni del dispositivo non viene crittografata utilizzando la chiave gestita. AWS KMS Tuttavia, la posizione esatta del dispositivo viene comunque crittografata utilizzando la chiave gestita. ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": true, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` ------ #### [ AWS CLI ] **Per creare un tracker utilizzando i comandi AWS CLI ** Utilizza il comando `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)`. L'esempio seguente utilizza il AWS CLI per creare un tracker chiamato. *ExampleTracker* La risorsa tracker è associata a una [AWS KMS chiave gestita dal cliente per crittografare i dati dei clienti](encryption-at-rest.md) e non [consente l'aggiornamento delle posizioni. EventBridge](location-events.md#enable-update-events) ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries false \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` **Crea un tracker con abilitato `KmsKeyEnableGeospatialQueries`** L'esempio seguente ha il parametro `KmsKeyEnableGeospatialQueries` impostato su true. Ciò consente di utilizzare la funzionalità Bounding Polygon Queries, crittografando i dati utilizzando una chiave gestita dal cliente. AWS KMS Per informazioni sull'utilizzo della funzione Bounding Polygon Queries, vedi [Elenca le posizioni dei tuoi dispositivi](list-device-positions.md) **Nota** Quando utilizzate la funzione Bounding Polygon Queries, una rappresentazione delle posizioni del dispositivo non viene crittografata utilizzando la chiave gestita. AWS KMS Tuttavia, la posizione esatta del dispositivo viene comunque crittografata utilizzando la chiave gestita. ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries true \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` ------ **Nota** La fatturazione dipende dall'utilizzo. Potresti incorrere in commissioni per l'uso di altri servizi. AWS Per ulteriori informazioni, consulta i [prezzi di Amazon Location Service](https://aws.amazon.com/location/pricing/). Puoi modificare la **descrizione**, il **filtro della posizione e la EventBridge ** **configurazione** dopo aver creato il tracker scegliendo **Modifica** tracker. # Autenticazione delle tue richieste Una volta creata una risorsa di tracciamento e pronto per iniziare a valutare le posizioni dei dispositivi rispetto ai geofence, scegli come autenticare le tue richieste: + Per scoprire come accedere ai servizi, consulta. [Autenticazione con Amazon Location Service](access.md) + Se desideri pubblicare le posizioni dei dispositivi con richieste non autenticate, puoi utilizzare Amazon Cognito. **Esempio** L'esempio seguente mostra l'utilizzo di un pool di identità Amazon Cognito per l'autorizzazione, utilizzando [AWS JavaScript SDK v3](https://aws.amazon.com/sdk-for-javascript/) e Amazon Location. [App](how-to-auth-helper.md#loc-sdk-auth-web) ``` import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location"; import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper"; // Unauthenticated identity pool you created const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id"; // Create an authentication helper instance using credentials from Cognito const authHelper = await withIdentityPoolId(identityPoolId); const client = new LocationClient({ region: "us-east-1", // The region containing both the identity pool and tracker resource ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location }); const input = { TrackerName: "ExampleTracker", Updates: [ { DeviceId: "ExampleDevice-1", Position: [-123.4567, 45.6789], SampleTime: new Date("2020-10-02T19:09:07.327Z"), }, { DeviceId: "ExampleDevice-2", Position: [-123.123, 45.123], SampleTime: new Date("2020-10-02T19:10:32Z"), }, ], }; const command = new BatchUpdateDevicePositionCommand(input); // Send device position updates const response = await client.send(command); ``` # Aggiorna il tracker con la posizione del dispositivo Per tracciare i tuoi dispositivi, puoi pubblicare aggiornamenti sulla posizione del dispositivo sul tracker. Successivamente puoi recuperare queste posizioni del dispositivo o la cronologia delle posizioni del dispositivo dalla tua risorsa tracker. Ogni aggiornamento della posizione deve includere l'ID del dispositivo, un timestamp e una posizione. Facoltativamente, puoi includere altri metadati, tra cui la precisione e fino a 3 coppie chiave-valore per uso personale. Se il tracker è collegato a una o più raccolte di geofence, gli aggiornamenti verranno valutati rispetto a tali geofence (seguendo le regole di filtro che hai specificato per il tracker). Se un dispositivo viola un'area geofrecintata (spostandosi dall'interno all'esterno dell'area o viceversa), riceverai eventi al suo interno. EventBridge Questi `ENTER` o questi `EXIT` eventi includono i dettagli dell'aggiornamento della posizione, tra cui l'ID del dispositivo, il timestamp e tutti i metadati associati. **Nota** Per ulteriori informazioni sul filtraggio delle posizioni, vedere. [Crea un localizzatore](start-create-tracker.md) Per ulteriori informazioni sugli eventi di geofence, vedere. [Reagisci agli eventi di Amazon Location Service con Amazon EventBridge](location-events.md) Utilizza uno di questi metodi per inviare gli aggiornamenti del dispositivo: + [Invia aggiornamenti MQTT](tracking-using-mqtt.md) a una risorsa AWS IoT Core e collegala alla tua risorsa tracker. + Invia aggiornamenti sulla posizione utilizzando l'API Amazon Location Trackers, utilizzando o Amazon Location. AWS CLI APIs Puoi usare il [AWS SDKs](dev-sdks.md)per chiamarli APIs dalla tua applicazione iOS o Android. ------ #### [ API ] **Per inviare un aggiornamento della posizione utilizzando Amazon Location APIs** Usa l'`[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente utilizza una richiesta API per pubblicare un aggiornamento della posizione del dispositivo su un *ExampleDevice* tracker. *ExampleTracker* ``` POST /tracking/v0/trackers/ExampleTracker/positions Content-type: application/json { "Updates": [ { "DeviceId": "1", "Position": [ -123.12245146162303, 49.27521118043802 ], "SampleTime": "2022-10-24T19:09:07.327Z", "PositionProperties": { "name" : "device1" }, "Accuracy": { "Horizontal": 10 } }, { "DeviceId": "2", "Position": [ -123.1230104928471, 49.27752402723152 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "3", "Position": [ -123.12325592118916, 49.27340530543111 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "4", "Position": [ -123.11958813096311, 49.27774641063121 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "5", "Position": [ -123.1277418058896, 49.2765989015285 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "6", "Position": [ -123.11964267059481, 49.274188155916534 ], "SampleTime": "2022-10-02T19:09:07.327Z" } ] } ``` ------ #### [ AWS CLI ] **Per inviare un aggiornamento della posizione utilizzando i comandi AWS CLI ** Utilizza il comando `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`. L'esempio seguente utilizza an AWS CLI per pubblicare un aggiornamento della posizione del dispositivo *ExampleDevice-2* per *ExampleDevice-1* e su un tracker*ExampleTracker*. ``` aws location batch-update-device-position \ --tracker-name ExampleTracker \ --updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]' ``` ------ # Ottieni la cronologia delle posizioni di un dispositivo da un tracker La tua risorsa Amazon Location Tracker conserva la cronologia delle posizioni di tutti i tuoi dispositivi tracciati per un periodo di 30 giorni. Puoi recuperare la cronologia delle posizioni del dispositivo, inclusi tutti i metadati associati, dalla tua risorsa di localizzazione. I seguenti esempi utilizzano la AWS CLI, o la posizione Amazon APIs. ------ #### [ API ] **Per ottenere la cronologia delle posizioni del dispositivo da un tracker utilizzando Amazon Location APIs** Usa l'`[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente utilizza una richiesta URI API per ottenere la cronologia delle posizioni del dispositivo *ExampleDevice* da un tracker chiamato *ExampleTracker* starting from `19:05:07` (inclusive) e termina con `19:20:07` (exclusive) on. `2020–10–02` ``` POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions Content-type: application/json { "StartTimeInclusive": "2020-10-02T19:05:07.327Z", "EndTimeExclusive": "2020-10-02T19:20:07.327Z" } ``` ------ #### [ AWS CLI ] **Per ottenere la cronologia delle posizioni del dispositivo da un tracker utilizzando i comandi AWS CLI ** Utilizza il comando `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)`. L'esempio seguente utilizza an AWS CLI per ottenere la cronologia delle posizioni del dispositivo *ExampleDevice* da un tracker chiamato *ExampleTracker* starting from `19:05:07` (inclusive) e termina con `19:20:07` (exclusive) on. `2020–10–02` ``` aws location \ get-device-position-history \ --device-id "ExampleDevice" \ --start-time-inclusive "2020-10-02T19:05:07.327Z" \ --end-time-exclusive "2020-10-02T19:20:07.327Z" \ --tracker-name "ExampleTracker" ``` ------ # Elenca le posizioni dei tuoi dispositivi Puoi visualizzare un elenco delle posizioni dei dispositivi per un tracker utilizzando Amazon Location o Amazon Location APIs con l' ListDevicePositions API. AWS CLI Quando chiami l' ListDevicePositions API, viene restituito un elenco delle posizioni più recenti per tutti i dispositivi associati a un determinato tracker. Per impostazione predefinita, questa API restituisce 100 delle ultime posizioni del dispositivo per pagina di risultati per un determinato tracker. Per restituire solo i dispositivi all'interno di una regione specifica, utilizza il `FilterGeometry` parametro per creare una Bounding Polygon Query. In questo modo, quando si chiama ListDevicePositions, verranno restituiti solo i dispositivi all'interno del poligono. **Nota** Se desideri crittografare i tuoi dati utilizzando la tua chiave gestita AWS KMS dal cliente, la funzione Bounding Polygon Queries sarà disabilitata per impostazione predefinita. Questo perché utilizzando questa funzione, una rappresentazione delle posizioni del dispositivo non verrà crittografata utilizzando la chiave gestita. AWS KMS La posizione esatta del dispositivo, tuttavia, è ancora crittografata utilizzando la chiave gestita. Puoi scegliere di attivare la funzione Bounding Polygon Queries. Questo viene fatto impostando il `KmsKeyEnableGeospatialQueries` parametro su true durante la creazione o l'aggiornamento di un Tracker. ------ #### [ API ] Usa l'`[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente è una richiesta API per ottenere un elenco di posizioni dei dispositivi nell'area poligonale, utilizzando il parametro opzionale. `[FilterGeometry](https://docs.aws.amazon.com/)` L'esempio restituisce 3 posizioni dei dispositivi presenti nell'area definita dall'`Polygon`array. ``` POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1 Content-type: application/json { "FilterGeometry": { "Polygon": [ [ [ -123.12003339442259, 49.27425121147397 ], [ -123.1176984148229, 49.277063620879744 ], [ -123.12389509145294, 49.277954183760926 ], [ -123.12755921328647, 49.27554025235713 ], [ -123.12330236586217, 49.27211836076236 ], [ -123.12003339442259, 49.27425121147397 ] ] ] }, "MaxResults": 3, "NextToken": "1234-5678-9012" } ``` Di seguito è riportato un esempio di risposta per`[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`: ``` { "Entries": [ { "DeviceId": "1", "SampleTime": "2022-10-24T19:09:07.327Z", "Position": [ -123.12245146162303, 49.27521118043802 ], "Accuracy": { "Horizontal": 10 }, "PositionProperties": { "name": "device1" } }, { "DeviceId": "3", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.12325592118916, 49.27340530543111 ] }, { "DeviceId": "2", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.1230104928471, 49.27752402723152 ] } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] Utilizza il comando `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`. L'esempio seguente serve AWS CLI per ottenere un elenco di dispositivi in un'area poligonale. ``` aws location list-device-positions TODO: add arguments add props for filter geo ``` ------