

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à.

# Crea un localizzatore
<a name="start-create-tracker"></a>

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.