Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mettez à jour votre traceur avec la position de l'appareil
<a name="send-location-updates"></a>

Pour suivre vos appareils, vous pouvez publier des mises à jour de position des appareils sur votre traceur. Vous pouvez ensuite récupérer ces positions de l'appareil ou l'historique des positions de l'appareil à partir de votre ressource de suivi.

Chaque mise à jour de position doit inclure l'identifiant de l'appareil, un horodatage et une position. Vous pouvez éventuellement inclure d'autres métadonnées, notamment la précision et jusqu'à 3 paires clé-valeur pour votre propre usage.

Si votre traceur est lié à une ou plusieurs collections de géofences, les mises à jour seront évaluées par rapport à ces géofences (conformément aux règles de filtrage que vous avez spécifiées pour le traceur). Si un appareil franchit une zone géo-clôturée (en se déplaçant de l'intérieur vers l'extérieur de la zone, ou vice versa), vous recevrez des événements à l'intérieur. EventBridge Ces `EXIT` événements `ENTER` ou événements incluent les détails de mise à jour de la position, y compris l'identifiant de l'appareil, l'horodatage et toutes les métadonnées associées.

**Note**  
Pour plus d'informations sur le filtrage des positions, consultez[Créer un dispositif de suivi](start-create-tracker.md).  
Pour plus d'informations sur les événements de géofence, consultez. [Réagissez aux événements du service de location Amazon avec Amazon EventBridge](location-events.md)

Utilisez l'une des méthodes suivantes pour envoyer les mises à jour de l'appareil :
+ [Envoyez des mises à jour MQTT](tracking-using-mqtt.md) à une ressource AWS IoT Core et associez-la à votre ressource de suivi.
+ Envoyez des mises à jour de localisation à l'aide de l'API Amazon Location Trackers AWS CLI, en utilisant le ou l'Amazon Location APIs. Vous pouvez utiliser le [AWS SDKs](dev-sdks.md)pour appeler APIs depuis votre application iOS ou Android.

------
#### [ API ]

**Pour envoyer une mise à jour de position à l'aide de l'Amazon Location APIs**

Utilisez l'`[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)`opération des Amazon Location Trackers APIs. 

L'exemple suivant utilise une demande d'API pour publier une mise à jour de la position de l'appareil *ExampleDevice* sur un 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 ]

**Pour envoyer une mise à jour de position à l'aide de AWS CLI commandes**

Utilisez la commande `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`.

L'exemple suivant utilise un AWS CLI pour publier une mise à jour de la position de l'appareil pour *ExampleDevice-1* et *ExampleDevice-2* vers 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"}}]'
```

------