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

# Aggiorna il tracker con la posizione del dispositivo
<a name="send-location-updates"></a>

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"}}]'
```

------