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à. # Localizzatori Amazon Location Service ![\[Questo diagramma mostra come creare e utilizzare le risorse del tracker.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/illustration-trackers.PNG) **Nota** L'archiviazione dei tracker viene crittografata automaticamente con chiavi AWS di proprietà. Puoi aggiungere un altro livello di crittografia utilizzando le chiavi KMS che gestisci, per garantire che solo tu possa accedere ai tuoi dati. Per ulteriori informazioni, consulta [Crittografia dei dati a riposo per Amazon Location Service](encryption-at-rest.md). Un tracker memorizza gli aggiornamenti di posizione per una raccolta di dispositivi. Il tracker può essere utilizzato per interrogare la posizione corrente o la cronologia delle posizioni dei dispositivi. Memorizza gli aggiornamenti, ma riduce lo spazio di archiviazione e il rumore visivo filtrando le posizioni prima di archiviarle. Ogni aggiornamento di posizione memorizzato nelle risorse del tracker può includere una misura della precisione della posizione e fino a 3 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. Il filtraggio e l'interrogazione della posizione dei tracker sono utili di per sé, ma i tracker sono particolarmente utili se abbinati a geofence. Puoi collegare i tracker a una o più delle tue risorse di raccolta di geofence e gli aggiornamenti di posizione vengono valutati automaticamente rispetto ai geofence di tali raccolte. Un uso corretto dei filtri può inoltre ridurre notevolmente i costi delle valutazioni dei geofence. 1. Innanzitutto, crei una risorsa di tracciamento nel tuo account. AWS 1. Quindi, decidi come inviare gli aggiornamenti sulla posizione alle risorse del tracker. [AWS SDKs](dev-sdks.md)Utilizzatelo per integrare le funzionalità di tracciamento nelle vostre applicazioni mobili. In alternativa, è possibile utilizzare MQTT seguendo le step-by-step istruzioni per il [tracciamento tramite](tracking-using-mqtt.md) MQTT. 1. Ora puoi utilizzare la tua risorsa tracker per registrare la cronologia delle posizioni e visualizzarla su una mappa. 1. Puoi anche collegare la tua risorsa di localizzazione a una o più raccolte di geofence in modo che ogni aggiornamento di posizione inviato alla risorsa tracker venga automaticamente valutato rispetto a tutti i geofence di tutte le raccolte di geofence collegate. Puoi collegare la risorsa nella pagina dei dettagli delle risorse tracker della console Amazon Location o utilizzando l'API Amazon Location Trackers. 1. È quindi possibile integrare il monitoraggio utilizzando servizi come Amazon CloudWatch e AWS CloudTrail. Per ulteriori informazioni, consulta [Monitora con Amazon CloudWatch](cloudwatch.md) e [Monitora e accedi con AWS CloudTrail](cloudtrail.md). ## Funzionalità + **Filtraggio della posizione**: i tracker possono filtrare automaticamente le posizioni che vengono loro inviate. Esistono diversi motivi per cui potresti voler filtrare alcuni aggiornamenti sulla posizione del tuo dispositivo. Se disponi di un sistema che invia report solo ogni minuto circa, potresti voler filtrare i dispositivi in base all'ora, archiviando e valutando le posizioni solo ogni 30 secondi. Anche se effettui il monitoraggio più frequentemente, potresti voler filtrare gli aggiornamenti di posizione per eliminare la rumorosità intrinseca associata all'hardware GPS e alla segnalazione della posizione. La loro precisione non è perfetta al 100%, quindi anche un dispositivo fermo sembra muoversi leggermente. A basse velocità, questo *jitter* causa confusione visiva e può causare falsi eventi di entrata e uscita se il dispositivo si trova vicino al bordo di un geofence. Il filtro di posizione funziona come se un tracker ricevesse gli aggiornamenti di posizione, riducendo il rumore visivo nei percorsi del dispositivo (jitter), il numero di falsi eventi di entrata e uscita dal geofence e aiutando a gestire i costi riducendo il numero di aggiornamenti di posizione archiviati e di valutazioni del geofence attivate. I tracker offrono tre opzioni di filtro della posizione per aiutare a gestire i costi e ridurre il jitter negli aggiornamenti della posizione. + **Basato sulla precisione: utilizzabile** *con qualsiasi dispositivo che fornisce una misurazione di precisione. La maggior parte dei dispositivi GPS e 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 WiFi dispositivi 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 il `AccuracyBased` filtraggio, Amazon Location ignora gli aggiornamenti sulla posizione se il dispositivo si è spostato con una precisione inferiore alla 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 viene considerata perfettamente accurata e non verrà applicato alcun filtro agli aggiornamenti. **Nota** È 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. Il filtro basato sulla distanza è utile se desideri filtrare, ma il tuo dispositivo non fornisce misurazioni di precisione o desideri filtrare un numero maggiore di aggiornamenti rispetto a quello basato sulla precisione. + **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 del geofence quasi in tempo reale senza archiviare* ogni aggiornamento. Nel `TimeBased` filtraggio, ogni aggiornamento di posizione viene valutato rispetto a 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. Il filtraggio basato sul tempo è particolarmente utile quando si desidera memorizzare meno posizioni, ma si desidera che ogni aggiornamento di posizione venga valutato rispetto alle raccolte di geofence associate. **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. ## Casi d'uso per i tracker di Amazon Location Service Di seguito sono riportati alcuni usi comuni dei tracker di Amazon Location Service. **Usa tracker con geofence** I tracker forniscono funzionalità aggiuntive se abbinati a geofence. Associate un tracker a una raccolta di geofence, tramite la console Amazon Location o l'API, per valutare automaticamente le posizioni dei tracker. Ogni volta che il tracker riceve una posizione aggiornata, tale posizione verrà valutata rispetto a ogni geofence della raccolta e gli `EXIT` eventi `ENTER` appropriati verranno generati in Amazon. EventBridge Puoi anche applicare filtri al tracker e, a seconda del filtro, ridurre i costi per le valutazioni del geofence valutando solo gli aggiornamenti significativi della posizione. Se si associa il tracker a una raccolta di geofence dopo che quest'ultima ha già ricevuto alcuni aggiornamenti di posizione, il primo aggiornamento di posizione dopo l'associazione viene considerato come un aggiornamento iniziale per le valutazioni del geofence. Se si trova all'interno di un geofence, riceverai un evento. `ENTER` Se non si trova all'interno di alcun geofence, non riceverai alcun `EXIT` evento, indipendentemente dallo stato precedente. **Migliora le operazioni di assistenza sul campo** Tieni sotto controllo la tua forza lavoro mobile con il monitoraggio in tempo reale. Imposta recinti geografici attorno alle sedi dei clienti e alle aree di assistenza per ricevere avvisi quando il personale arriva e parte. Utilizza i dati sulla posizione per ottimizzare la pianificazione, inviare il tecnico disponibile più vicino e ridurre i tempi di risposta. Consentite ai vostri team sul campo (ad esempio quelli che si occupano di riparazioni idrauliche o HVAC) di lavorare in modo più efficiente, migliorando al contempo l'esperienza del cliente. **Monitora e controlla le risorse critiche** Utilizza Amazon Location Service per monitorare la posizione e lo stato in tempo reale delle tue preziose apparecchiature, dell'inventario e di altre risorse mobili. Configura geofence per ricevere avvisi su spostamenti o traslochi non autorizzati, migliorando la sicurezza e la conformità. Utilizza questa visibilità sulla posizione per migliorare l'utilizzo delle risorse, ottimizzare i programmi di manutenzione e garantire che le risorse critiche siano sempre prese in considerazione. Monitora sempre con precisione i macchinari pesanti, l'hardware IT o l'inventario di vendita al dettaglio, riduci le perdite e prendi decisioni operative più informate. **Migliora la visibilità della catena di fornitura** Sfrutta Amazon Location Service per tracciare le spedizioni e le consegne lungo l'intera catena di fornitura. Definisci recinti geografici attorno ai centri di distribuzione, ai negozi e ad altre strutture chiave per monitorare il movimento dell'inventario e degli asset. Utilizza i dati sulla posizione in tempo reale per migliorare la gestione dell'inventario, ottimizzare la pianificazione logistica e offrire un'esperienza cliente di livello superiore. Ottieni end-to-end visibilità sulle operazioni della catena di fornitura, identifica gli ostacoli e prendi decisioni basate sui dati che promuovono l'efficienza e la reattività. **Marketing basato sulla posizione** Sfrutta la potenza dei dati sulla posizione per potenziare le tue attività di geomarketing. Usa Amazon Location Service per stabilire confini virtuali attorno alle sedi, agli eventi e alle aree ad alto traffico dei concorrenti. Attiva annunci, offerte e notifiche personalizzati quando i clienti entrano in queste zone geofrecintate. Analizza i modelli di traffico pedonale per ottimizzare il posizionamento degli annunci e scoprire i siti migliori per nuove sedi commerciali. Monitora i movimenti dei clienti all'interno dei tuoi spazi geofrecintati per ottenere informazioni più approfondite sui comportamenti di navigazione e. path-to-purchase Combina il tracciamento della posizione in tempo reale con il geofencing di precisione per offrire un coinvolgimento contestuale e ipermirato che stimoli le vendite e la fidelizzazione nel mondo fisico. # Concetti relativi al tracker Questa sezione descrive in dettaglio i concetti più comuni relativi ai tracker. ## Terminologia comune dei tracker di Amazon Location Service **Risorsa Tracker** Una AWS risorsa che riceve aggiornamenti sulla posizione dai dispositivi. La risorsa tracker fornisce supporto per le query sulla posizione, ad esempio la posizione attuale e storica del dispositivo. Il collegamento di una risorsa tracker a una raccolta di geofence valuta automaticamente gli aggiornamenti della posizione rispetto a tutti i geofence della raccolta di geofence collegata. **Dati di posizione tracciati** Una risorsa di tracciamento memorizza le informazioni sui tuoi dispositivi nel tempo. Le informazioni includono una serie di aggiornamenti di posizione, in cui ogni aggiornamento include posizione, ora e metadati opzionali. I metadati possono includere la precisione di una posizione e fino a tre coppie chiave-valore per aiutarti a tenere traccia delle informazioni chiave su ciascuna posizione, come velocità, direzione, pressione dei pneumatici, carburante residuo o temperatura del motore del veicolo che stai monitorando. I tracker conservano la cronologia delle posizioni del dispositivo per 30 giorni. **Filtraggio della posizione** Il filtro di posizione può aiutarvi a controllare i costi e migliorare la qualità dell'applicazione di tracciamento filtrando gli aggiornamenti di posizione che non forniscono informazioni preziose prima che gli aggiornamenti vengano archiviati o valutati rispetto ai geofence. Puoi scegliere `AccuracyBased` o filtrare. `DistanceBased` `TimeBased` Per impostazione predefinita, il filtro di posizione è impostato su. `TimeBased` È possibile configurare il filtro di posizione quando si creano o si aggiornano le risorse del tracker. **Formato timestamp RFC 3339 ** I tracker di Amazon Location Service utilizzano il formato [RFC 3339](https://tools.ietf.org/html/rfc3339), che segue il formato dell'[International Organization for Standardization (ISO) 8601](https://www.iso.org/iso-8601-date-and-time-format.html) per date e ora. Il formato è «YYYY-MM-:MM:SS.SSSZ\$1 00:00 «: DDThh + `YYYY-MM-DD`— Rappresenta il formato della data. + `T`— Indica che i valori temporali seguiranno. + `hh:mm:ss.sss`— Rappresenta l'ora in formato 24 ore. + `Z`— Indica che il fuso orario utilizzato è UTC, che può essere seguito da deviazioni dal fuso orario UTC. + `+00:00`— Indicare facoltativamente le deviazioni dal fuso orario UTC. Ad esempio, \$1 01:00 indica UTC \$1 1 ora. **Esempio** Per il 2 luglio 2020, alle 12:15:20 del pomeriggio, con un ulteriore adeguamento di 1 ora al fuso orario UTC. ``` 2020-07-02T12:15:20.000Z+01:00 ``` # 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 ``` ------ # Come lavorare con i tracker di Amazon Location Service Questa sezione fornisce istruzioni per lavorare con i localizzatori di localizzazione Amazon. Scopri come verificare le posizioni dei dispositivi, collegare i tracker alle raccolte di geofence e tracciare le posizioni utilizzando IoT AWS e MQTT. Inoltre, scopri come gestire i tracker in modo efficace per supportare le tue applicazioni basate sulla posizione e garantire un tracciamento accurato e in tempo reale. **Topics** + [Verifica le posizioni dei dispositivi](verify-device-positions.md) + [Collega un tracker a una raccolta di geofence](associate-consumer.md) + [Monitora l'utilizzo AWS IoT e l'MQTT con Amazon Location Service](tracking-using-mqtt.md) + [Gestisci il tuo localizzatore Amazon Location Service](managing-trackers.md) # Verifica le posizioni dei dispositivi Per verificare l'integrità della posizione di un dispositivo, utilizza l'[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API. Questa API restituisce informazioni sull'integrità della posizione del dispositivo, valutando proprietà come il segnale cellulare del dispositivo, il punto di accesso Wi-Fi, l'indirizzo Ipv4 e se è in uso un proxy. ## Prerequisiti Prima di poter utilizzare quanto elencato APIs per la verifica del dispositivo, assicurati di disporre dei seguenti prerequisiti: + Hai creato un tracker per il dispositivo o i dispositivi che desideri controllare. Per ulteriori informazioni, consulta [Inizia a usare i tracker di Amazon Location Service](start-tracking.md). L'esempio seguente mostra una richiesta per l'[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API Amazon Location. ------ #### [ API ] **Per verificare le posizioni dei dispositivi utilizzando Amazon Location APIs** Utilizza l'`[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)`operazione di Amazon Location Tracking APIs. L'esempio seguente mostra una richiesta API per valutare l'integrità della posizione di un dispositivo. Sostituisci questi valori con il tuo dispositivo IDs. ``` POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1 Content-type: application/json { "DeviceState": { "Accuracy": { "Horizontal": number }, "CellSignals": { "LteCellDetails": [ { "CellId": number, "LocalId": { "Earfcn": number, "Pci": number }, "Mcc": number, "Mnc": number, "NetworkMeasurements": [ { "CellId": number, "Earfcn": number, "Pci": number, "Rsrp": number, "Rsrq": number } ], "NrCapable": boolean, "Rsrp": number, "Rsrq": number, "Tac": number, "TimingAdvance": number } ] }, "DeviceId": "ExampleDevice", "Ipv4Address": "string", "Position": [ number ], "SampleTime": "string", "WiFiAccessPoints": [ { "MacAddress": "string", "Rss": number } ] }, "DistanceUnit": "string" } ``` ------ **Nota** L'**Integrity SDK** offre funzionalità avanzate relative alla verifica dei dispositivi ed è disponibile per l'uso su richiesta. Per accedere all'SDK, contatta il [Sales Support](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn). # Collega un tracker a una raccolta di geofence Ora che disponi di una raccolta di geofence e di un tracker, puoi collegarli tra loro in modo che gli aggiornamenti di posizione vengano valutati automaticamente rispetto a tutti i geofence. Se non desideri valutare tutti gli aggiornamenti di posizione o, in alternativa, se non stai archiviando alcune delle tue posizioni in una risorsa di localizzazione, puoi [valutare](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html) le posizioni dei dispositivi rispetto ai geofence su richiesta. Quando le posizioni dei dispositivi vengono valutate rispetto ai geofence, vengono generati degli eventi. È possibile impostare un'azione per questi eventi. Per ulteriori informazioni sulle azioni che puoi impostare per gli eventi di geofence, consulta [Reagire agli eventi di Amazon Location Service con](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html) Amazon. EventBridge Un evento Amazon Location include gli attributi dell'aggiornamento della posizione del dispositivo che lo genera e alcuni attributi del geofence che viene inserito o uscito. Per ulteriori informazioni sui dati inclusi in un evento di geofence, consulta. [Esempi di EventBridge eventi Amazon per Amazon Location Service](location-events.md#example-event) I seguenti esempi collegano una risorsa tracker a una raccolta di geofence utilizzando la console AWS CLI, la o Amazon Location. APIs ------ #### [ Console ] **Per collegare una risorsa tracker a una raccolta di geofence utilizzando la console Amazon Location Service** 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. In **Device tracker**, seleziona il link del nome del tracker di destinazione. 1. **In **Collezioni Geofence collegate, scegli Collega collezione Geofence**.** 1. Nella finestra **Linked Geofence Collection, seleziona una collezione** di geofence dal menu a discesa. 1. Scegliere **Link (Collegamento)**. **Dopo aver collegato la risorsa tracker, ad essa verrà assegnato uno stato Attivo.** ------ #### [ API ] **Per collegare una risorsa tracker a una raccolta di geofence utilizzando Amazon Location APIs** Usa l'`[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente utilizza una richiesta API associata *ExampleTracker* a una raccolta di geofence utilizzando il relativo [Amazon Resource Name (](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)ARN). ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" } ``` ------ #### [ AWS CLI ] **Per collegare una risorsa tracker a una raccolta di geofence utilizzando i comandi AWS CLI ** Utilizza il comando `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`. L'esempio seguente utilizza an AWS CLI per creare una raccolta di geofence chiamata. *ExampleGeofenceCollection* ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \ --tracker-name "ExampleTracker" ``` ------ # Monitora l'utilizzo AWS IoT e l'MQTT con Amazon Location Service [MQTT](http://mqtt.org/) è un protocollo di messaggistica leggero e ampiamente adottato progettato per dispositivi con limitazioni. AWS IoT Core supporta connessioni di dispositivi che utilizzano il protocollo MQTT e il protocollo MQTT over WebSocket Secure (WSS). [AWS IoT Core](https://aws.amazon.com/iot-core/)connette i dispositivi AWS e consente di inviare e ricevere messaggi tra di essi. Il motore AWS IoT Core delle regole memorizza le domande sugli argomenti dei messaggi dei tuoi dispositivi e ti consente di definire azioni per l'invio di messaggi ad altri AWS servizi, come Amazon Location Service. I dispositivi che conoscono la propria posizione come coordinate possono far sì che le proprie posizioni vengano inoltrate ad Amazon Location tramite il motore delle regole. **Nota** I dispositivi possono conoscere la propria posizione, ad esempio tramite il GPS integrato. AWS IoT supporta anche il tracciamento della posizione dei dispositivi di terze parti. Per ulteriori informazioni, consulta [AWS IoT Core Device Location](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html) nella *AWS IoT Core Developer Guide*. La procedura dettagliata seguente descrive il tracciamento utilizzando AWS IoT Core le regole. Puoi anche inviare le informazioni sul dispositivo alla tua AWS Lambda funzione, se devi elaborarle prima di inviarle ad Amazon Location. Per maggiori dettagli sull'utilizzo di Lambda per elaborare le posizioni dei dispositivi, consulta. [Uso AWS Lambda con MQTT](tracking-using-mqtt-with-lambda.md) **Topics** + [Prerequisito](#mqtt-prerequisite) + [Crea una regola AWS IoT Core](#mqtt-create-iot-rule) + [Verifica la tua AWS IoT Core regola nella console](#mqtt-test-iot-rule) + [Uso AWS Lambda con MQTT](tracking-using-mqtt-with-lambda.md) ## Prerequisito Prima di iniziare il tracciamento, devi completare i seguenti prerequisiti: + [Create una risorsa di tracciamento](start-create-tracker.md) a cui inviare i dati sulla posizione del dispositivo. + [Crea un ruolo IAM](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html) per concedere AWS IoT Core l'accesso al tuo tracker. Quando segui questi passaggi, utilizza la seguente politica per consentire l'accesso al tracker: ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` ## Crea una regola AWS IoT Core Quindi, crea una AWS IoT Core regola per inoltrare la telemetria posizionale dei tuoi dispositivi ad Amazon Location Service. *Per ulteriori informazioni sulla creazione di regole, consulta i seguenti argomenti nella Guida per gli sviluppatori:AWS IoT Core * + [Creazione di una AWS IoT regola](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) per informazioni sulla creazione di una nuova regola. + [Azione sulla posizione](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) per informazioni specifiche sulla creazione di una regola per la pubblicazione su Amazon Location ## Verifica la tua AWS IoT Core regola nella console Se al momento nessun dispositivo pubblica dati di telemetria che includono la posizione, puoi testare la regola utilizzando la console. AWS IoT Core La console dispone di un client di test in cui è possibile pubblicare un messaggio di esempio per verificare i risultati della soluzione. 1. Accedi alla AWS IoT Core console all'indirizzo [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. Nella barra di navigazione a sinistra, **espandi Test** e scegli **MQTT test client**. 1. In **Pubblica su un argomento**, imposta il **nome dell'argomento su** *iot/topic* (o il nome dell'argomento che hai impostato nella AWS IoT Core regola, se diverso) e fornisci quanto segue per il **payload del messaggio**. Sostituisci il timestamp *1604940328* con un timestamp valido degli ultimi 30 giorni (tutti i timestamp più vecchi di 30 giorni vengono ignorati dai tracker di Amazon Location Service). ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. **Scegli Pubblica su argomento per inviare il messaggio di prova.** 1. Per verificare che il messaggio sia stato ricevuto da Amazon Location Service, usa il seguente AWS CLI comando. Se lo hai modificato durante la configurazione, sostituisci il nome del tracker con quello che hai usato. ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # Uso AWS Lambda con MQTT Sebbene l'utilizzo non AWS Lambda sia più necessario per l'invio dei dati sulla posizione del dispositivo ad Amazon Location per il tracciamento, in alcuni casi potresti comunque voler utilizzare Lambda. Ad esempio, se desideri elaborare personalmente i dati sulla posizione del tuo dispositivo, prima di inviarli ad Amazon Location. I seguenti argomenti descrivono come utilizzare Lambda per elaborare i messaggi prima di inviarli al tracker. Per ulteriori informazioni su questo modello, consulta l'architettura [di riferimento.](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf) **Topics** + [Prerequisito](#mqtt-prerequisite-with-lambda) + [Creazione di una funzione Lambda](#mqtt-with-lambda-create-lambda) + [Crea una AWS IoT Core regola](#mqtt-create-iot-rule-with-lambda) + [Metti alla prova la tua AWS IoT Core regola nella console](#mqtt-test-iot-rule-with-lambda) ## Prerequisito Prima di iniziare il tracciamento, è necessario [creare una risorsa tracker](start-tracking.md). Per creare una risorsa di tracciamento, puoi utilizzare la console Amazon Location AWS CLI, o Amazon Location APIs. L'esempio seguente utilizza la console Amazon Location Service per creare la risorsa tracker: 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 le seguenti caselle: + **Nome**: inserisci un nome univoco che contenga un massimo di 100 caratteri. Le voci valide includono caratteri alfanumerici, trattini e caratteri di sottolineatura. Ad esempio, *MyTracker*. + **Descrizione: immettere una descrizione** facoltativa. Ad esempio, *Tracker for storing AWS IoT Core device positions*. + **Filtro di posizione**: seleziona il filtro che desideri utilizzare per gli aggiornamenti delle posizioni. Ad esempio, filtraggio basato sulla **precisione**. 1. **Scegli Crea tracker.** ## Creazione di una funzione Lambda Per creare una connessione tra AWS IoT Core e Amazon Location Service, è necessaria una AWS Lambda funzione per elaborare i messaggi inoltrati da. AWS IoT Core Questa funzione estrarrà tutti i dati di posizione, li formatterà per Amazon Location Service e li invierà tramite l'API Amazon Location Tracker. Puoi creare questa funzione tramite la AWS Lambda console oppure puoi usare AWS Command Line Interface (AWS CLI) o. AWS Lambda APIs Per creare una funzione Lambda che pubblichi aggiornamenti di posizione su Amazon Location utilizzando la console: 1. Apri la AWS Lambda console all'indirizzo. [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home) 1. Dalla barra di navigazione a sinistra, scegli **Funzioni**. 1. Scegli **Crea funzione** e assicurati che sia selezionato **Author from zero**. 1. Compila le seguenti caselle: + **Nome della funzione**: immettere un nome univoco per la funzione. Le voci valide includono caratteri alfanumerici, trattini e caratteri di sottolineatura senza spazi. Ad esempio, *MyLambda*. + **Runtime**: scegli. *Python 3.8* 1. Scegli **Crea funzione**. 1. Scegli la scheda **Codice** per aprire l'editor. 1. [Sovrascrivi il codice segnaposto `lambda_function.py` con quanto segue, sostituendo il valore assegnato `TRACKER_NAME` con il nome del tracker che hai creato come prerequisito.](#mqtt-prerequisite-with-lambda) ``` from datetime import datetime import json import os import boto3 # Update this to match the name of your Tracker resource TRACKER_NAME = "MyTracker" """ This Lambda function receives a payload from AWS IoT Core and publishes device updates to Amazon Location Service via the BatchUpdateDevicePosition API. Parameter 'event' is the payload delivered from AWS IoT Core. In this sample, we assume that the payload has a single top-level key 'payload' and a nested key 'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For example: >>> event { 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328, 'location': { 'lat': 49.2819, 'long': -123.1187 }, 'accuracy': {'Horizontal': 20.5 }, 'positionProperties': {'field1':'value1','field2':'value2'} } } If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to format the data before delivering it to this Lambda function, or you can modify the code below to match it. """ def lambda_handler(event, context): update = { "DeviceId": event["payload"]["deviceid"], "SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"), "Position": [ event["payload"]["location"]["long"], event["payload"]["location"]["lat"] ] } if "accuracy" in event["payload"]: update["Accuracy"] = event["payload"]['accuracy'] if "positionProperties" in event["payload"]: update["PositionProperties"] = event["payload"]['positionProperties'] client = boto3.client("location") response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update]) return { "statusCode": 200, "body": json.dumps(response) } ``` 1. Scegliete **Deploy per salvare** la funzione aggiornata. 1. Scegli la scheda **Configurazione**. 1. Nella sezione **Autorizzazioni**, scegli il nome del ruolo con collegamento ipertestuale per concedere ad Amazon Location Service le autorizzazioni per la tua funzione Lambda. 1. **Dalla pagina di **riepilogo** del tuo ruolo, scegli **Aggiungi autorizzazioni**, quindi dall'elenco a discesa seleziona Crea politica in linea.** 1. Scegli la scheda **JSON** e sovrascrivi la politica con il seguente documento. Ciò consente alla funzione Lambda di aggiornare le posizioni dei dispositivi gestite da tutte le risorse del tracker in tutte le regioni. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` 1. Scegliere **Esamina policy**. 1. Inserire un nome per la policy. Ad esempio, *AmazonLocationTrackerWriteOnly*. 1. Scegli **Crea policy**. È possibile modificare questo codice di funzione, se necessario, per adattarlo allo schema dei messaggi del dispositivo. ## Crea una AWS IoT Core regola Successivamente, crea una AWS IoT Core regola per inoltrare la telemetria posizionale dei tuoi dispositivi alla AWS Lambda funzione di trasformazione e pubblicazione su Amazon Location Service. La regola di esempio fornita presuppone che qualsiasi trasformazione necessaria dei payload del dispositivo venga gestita dalla funzione Lambda. È possibile creare questa regola tramite la AWS IoT Core console, il AWS Command Line Interface (AWS CLI) o il. AWS IoT Core APIs **Nota** Sebbene la AWS IoT console gestisca le autorizzazioni necessarie AWS IoT Core per consentire di richiamare la funzione Lambda, se stai creando la regola da o SDK, [devi configurare una policy a](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements) cui concedere AWS CLI l'autorizzazione. AWS IoT **Per creare un AWS IoT Core file utilizzando la console** 1. Accedi alla AWS IoT Core console all'indirizzo [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. Nella barra di navigazione a sinistra, espandi **Act** e scegli **Rules**. 1. Scegli **Crea una regola** per avviare la nuova procedura guidata per le regole. 1. Immettere un nome e una descrizione per la regola. 1. Per l'**istruzione Rule Query**, aggiorna l'`FROM`attributo in modo che faccia riferimento a un argomento in cui almeno un dispositivo pubblica dati di telemetria che include la posizione. Se state testando la soluzione, non è necessaria alcuna modifica. ``` SELECT * FROM 'iot/topic' ``` 1. In **Imposta una o più azioni**, scegli **Aggiungi azione**. 1. Seleziona **Invia un messaggio a una funzione lambda**. 1. Selezionare **Configure action (Configura operazione)**. 1. Trova e seleziona la tua funzione Lambda dall'elenco. 1. Selezionare **Add action** (Aggiungi operazione). 1. Scegli **Crea regola**. ## Metti alla prova la tua AWS IoT Core regola nella console Se al momento nessun dispositivo pubblica dati di telemetria che include la posizione, puoi testare la regola e questa soluzione utilizzando la console. AWS IoT Core La console dispone di un client di test in cui è possibile pubblicare un messaggio di esempio per verificare i risultati della soluzione. 1. Accedi alla AWS IoT Core console all'indirizzo [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. Nella barra di navigazione a sinistra, **espandi Test** e scegli **MQTT test client**. 1. In **Pubblica su un argomento**, imposta il **nome dell'argomento su** *iot/topic* (o il nome dell'argomento che hai impostato nella AWS IoT Core regola, se diverso) e fornisci quanto segue per il **payload del messaggio**. Sostituisci il timestamp *1604940328* con un timestamp valido degli ultimi 30 giorni (tutti i timestamp più vecchi di 30 giorni vengono ignorati). ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. Scegli **Pubblica su argomento per inviare il messaggio** di prova. 1. Per verificare che il messaggio sia stato ricevuto da Amazon Location Service, usa il seguente AWS CLI comando. Se li hai modificati durante la configurazione, sostituisci il nome del tracker e l'ID del dispositivo con quelli che hai usato. ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # Gestisci il tuo localizzatore Amazon Location Service Puoi gestire i tuoi tracker utilizzando la console Amazon Location AWS CLI, o Amazon Location. APIs ## Elenca i tuoi tracker Puoi visualizzare il tuo elenco di tracker utilizzando la console Amazon Location AWS CLI, o Amazon Location: APIs ------ #### [ Console ] **Per visualizzare un elenco di tracker esistenti utilizzando la console Amazon Location** 1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Scegli **Trackers dalla barra di** navigazione a sinistra. 1. **Visualizza un elenco delle risorse del tuo tracker in I miei tracker.** ------ #### [ API ] Usa l'`[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente è una richiesta API per ottenere un elenco di tracker presenti nel tuo account. AWS ``` POST /tracking/v0/list-trackers ``` Di seguito è riportato un esempio di risposta per: `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` ``` { "Entries": [ { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ], "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 tracker presenti nel tuo AWS account. ``` aws location list-trackers ``` ------ ## Disconnettere un tracker da una raccolta di geofence Puoi disconnettere un tracker da una raccolta di geofence utilizzando la console Amazon Location, AWS CLI o Amazon Location: APIs ------ #### [ Console ] **Per dissociare un tracker da una raccolta di geofence associata utilizzando la console Amazon Location** 1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Scegli **Trackers dal riquadro** di navigazione a sinistra. 1. In **I miei tracker**, seleziona il link del nome del tracker di destinazione. 1. **In **Collezioni di geofence collegate**, seleziona una raccolta di geofence con uno stato Collegato.** 1. Scegli **Unlink**. ------ #### [ API ] Usa l'`[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`operazione di Amazon Location Trackers APIs. L'esempio seguente è una richiesta API per dissociare un tracker da una raccolta di geofence associata. ``` DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection ``` Di seguito è riportato un esempio di risposta per: `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` ``` HTTP/1.1 200 ``` ------ #### [ CLI ] Utilizza il comando `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)`. L'esempio seguente è un AWS CLI comando per dissociare un tracker da una raccolta di geofence associata. ``` aws location disassociate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \ --tracker-name "ExampleTracker" ``` ------ ## Ottieni i dettagli del tracker Puoi ottenere dettagli su qualsiasi tracker presente nel tuo AWS account utilizzando la console Amazon Location AWS CLI, o Amazon Location APIs. ------ #### [ Console ] **Per visualizzare i dettagli del tracker utilizzando la console Amazon Location** 1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Scegli **Trackers dalla barra di** navigazione a sinistra. 1. In **I miei tracker**, seleziona il link del nome del tracker di destinazione. 1. **Visualizza i dettagli del tracker in Informazioni.** ------ #### [ API ] Usa l'`[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`operazione di Amazon Location Tracker APIs. L'esempio seguente è una richiesta API per cui ottenere i dettagli del tracker. *ExampleTracker* ``` GET /tracking/v0/trackers/ExampleTracker ``` Di seguito è riportato un esempio di risposta per`[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`: ``` { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "TimeBased", "Tags": { "Tag1" : "Value1" }, "TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ``` ------ #### [ CLI ] Utilizza il comando `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`. L'esempio seguente è un AWS CLI comando per cui ottenere i dettagli del tracker. *ExampleTracker* ``` aws location describe-tracker \ --tracker-name "ExampleTracker" ``` ------ ## Eliminare un tracker Puoi eliminare un tracker dal tuo AWS account utilizzando la console Amazon Location AWS CLI, o Amazon Location APIs: ------ #### [ Console ] **Per eliminare una risorsa cartografica esistente utilizzando la console Amazon Location** **avvertimento** Questa operazione elimina la risorsa in modo permanente. Se la risorsa tracker è in uso, è possibile che si verifichi un errore. Assicurati che la risorsa di destinazione non sia una dipendenza per le tue applicazioni. 1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Scegli **Trackers dal riquadro** di navigazione a sinistra. 1. In **I miei tracker, seleziona il tracker** di destinazione. 1. **Scegli Elimina tracker.** ------ #### [ API ] Usa l'`[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`operazione di Amazon Location Tracker APIs. L'esempio seguente è una richiesta API per eliminare il *ExampleTracker* tracker. ``` DELETE /tracking/v0/trackers/ExampleTracker ``` Di seguito è riportato un esempio di risposta per`[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`: ``` HTTP/1.1 200 ``` ------ #### [ CLI ] Utilizza il comando `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)`. L'esempio seguente è un AWS CLI comando per eliminare il tracker*ExampleTracker*. ``` aws location delete-tracker \ --tracker-name "ExampleTracker" ``` ------ # Gestione dei costi e dell'utilizzo Man mano che continui a conoscere i localizzatori di Amazon Location, è importante capire come gestire la capacità del servizio, assicurarti di rispettare i limiti di utilizzo e ottenere i migliori risultati attraverso l'ottimizzazione delle quote e delle API. Applicando le migliori pratiche in termini di prestazioni e precisione, puoi personalizzare la tua applicazione per gestire in modo efficiente le query relative al luogo e massimizzare le tue richieste API. **Topics** + [Prezzi dei tracker](trackers-pricing.md) + [Quota e utilizzo dei tracker](trackers-quotas.md) # Prezzi dei tracker Per informazioni sui prezzi per il tracciamento e il geofencing APIs, consulta la pagina [dei prezzi di Amazon Location Service](https://aws.amazon.com/location/pricing/). **Posizione scritta** È possibile utilizzarli `BatchUpdateDevicePosition` per caricare i dati di aggiornamento della posizione per uno o più dispositivi su una risorsa tracker (fino a dieci dispositivi per batch). Il prezzo si basa sul numero di posizioni dei dispositivi nella richiesta API. Il prezzo unitario per aggiornamento della posizione del dispositivo si basa sul volume di utilizzo mensile totale. Consulta la [pagina dei prezzi di Amazon Location Service](https://aws.amazon.com/location/pricing/) per dettagli sul prezzo unitario e sui livelli di volume. Puoi ottimizzare il costo di Position Written configurando la frequenza di aggiornamento della posizione del dispositivo (nota anche come frequenza di ping) dai tuoi dispositivi di tracciamento e, facoltativamente, utilizzare un filtro locale per caricare solo gli aggiornamenti pertinenti alla posizione del dispositivo su Amazon Location Service. **Posizione Letta** È possibile utilizzare `BatchGetDevicePosition` per elencare le posizioni più recenti dei dispositivi richiesti, fino a 100 dispositivi per richiesta. È inoltre possibile utilizzare `GetDevicePosition` per recuperare la posizione più recente di un dispositivo in base al tempo di campionamento. Il prezzo si basa sul numero di richieste API. **Eliminazione della posizione** È possibile utilizzare `BatchDeleteDevicePositionHistory` per eliminare la cronologia delle posizioni di uno o più dispositivi da una risorsa tracker, fino a 100 dispositivi per richiesta. Il prezzo si basa sul numero di dispositivi inclusi nella richiesta API. **Valutazione dell'integrità della posizione** È possibile utilizzarla `VerifyDevicePosition` per verificare l'integrità della posizione del dispositivo determinando se è stata segnalata tramite un proxy e confrontandola con una posizione dedotta stimata in base allo stato del dispositivo. Il prezzo si basa sul numero di richieste API. # Quota e utilizzo dei tracker Questo argomento fornisce un riepilogo dei limiti di tariffa e delle quote per i tracker di Amazon Location Service. **Nota** Se hai bisogno di una quota più alta, puoi utilizzare la console Service Quotas per [richiedere aumenti delle quote per le quote](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) regolabili. Quando richiedi un aumento della quota, seleziona la regione in cui desideri aumentare la quota, poiché la maggior parte delle quote è specifica della regione. AWS Puoi richiedere fino al doppio del limite predefinito per ciascuna API. Per le richieste che superano il doppio del limite predefinito, la richiesta invierà un ticket di assistenza. Puoi anche connetterti al tuo team di supporto premium. Non sono previsti costi diretti per le richieste di aumento delle quote, ma livelli di utilizzo più elevati possono comportare un aumento dei costi di servizio in base alle risorse aggiuntive consumate. Per ulteriori informazioni, consulta [Gestisci le quote con Service Quotas](manage-quotas.md). Le Service Quotas sono il numero massimo di risorse che puoi avere a disposizione per AWS account e AWS regione. Amazon Location Service rifiuta le richieste aggiuntive che superano la quota di servizio. ## Resources | Nome API | Predefinita | Limite massimo regolabile | | --- | --- | --- | | Risorse del tracker per account | 500 | 1000 Se hai bisogno di qualcosa di più, [richiedi un aumento della quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto. | | Consumatori tracker per tracker | 5 | Il limite massimo regolabile non è applicabile. Contatta il team di supporto. | ## CRUD API **Nota** Se hai bisogno di un limite più alto per uno di questi APIs, [richiedi un aumento della quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto. | Nome API | Predefinita | Limite massimo regolabile | | --- | --- | --- | | [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 | | [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 | | [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 | | [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 | | [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 | | [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 | | [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 | | [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) | 10 | 20 | ## Data API (API dati). **Nota** Se hai bisogno di un limite più alto per uno di questi APIs, [richiedi un aumento della quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto. | Nome API | Predefinita | Limite massimo regolabile | | --- | --- | --- | | [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 | | [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 | | [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 | | [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 | | [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 | | [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 | ## Altri limiti di utilizzo