As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualize seu rastreador com a posição de um dispositivo
<a name="send-location-updates"></a>

Para rastrear seus dispositivos, você pode publicar atualizações das posições dos dispositivos em seu rastreador. Posteriormente, você pode recuperar essas posições dos dispositivos ou o histórico das posições do dispositivo a partir do seu recurso de rastreador.

Cada atualização de posição deve incluir a ID do dispositivo, um carimbo de data e hora e uma posição. Opcionalmente, você pode incluir outros metadados, incluindo a precisão e até três pares chave-valor para seu próprio uso.

Se o seu rastreador estiver vinculado a uma ou mais coleções de geocercas, as atualizações serão avaliadas em relação a essas geocercas (seguindo as regras de filtragem que você especificou para o rastreador). Se um dispositivo violar uma área cercada geograficamente (movendo-se de dentro para fora da área ou vice-versa), você receberá eventos em. EventBridge Esses `ENTER` ou `EXIT` eventos incluem os detalhes da atualização da posição, incluindo a ID do dispositivo, o timestamp e quaisquer metadados associados.

**nota**  
Para obter mais informações sobre a filtragem de posições, consulte [Criar um rastreador](start-create-tracker.md).  
Para obter mais informações sobre os eventos das geocercas, consulte [Reaja aos eventos do Amazon Location Service com a Amazon EventBridge](location-events.md).

Use um desses métodos para enviar atualizações do dispositivo:
+ [Envie atualizações do MQTT](tracking-using-mqtt.md) para um recurso do AWS IoT Core e vincule-o ao seu recurso rastreador.
+ Envie atualizações de localização usando a API Amazon Location Trackers, usando o AWS CLI, ou o Amazon Location. APIs Você pode usar o [AWS SDKs](dev-sdks.md)para ligar para o a APIs partir do seu aplicativo iOS ou Android.

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

**Para enviar uma atualização de posição usando a localização da Amazon APIs**

Use a `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` operação dos Amazon Location Trackers APIs. 

O exemplo a seguir usa uma solicitação de API para publicar uma atualização da posição do dispositivo *ExampleDevice* em um rastreador*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 ]

**Para enviar uma atualização de posição usando comandos AWS CLI **

Use o comando `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`.

O exemplo a seguir usa um AWS CLI para publicar uma atualização da posição do dispositivo para *ExampleDevice-1* e *ExampleDevice-2* para um rastreador*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"}}]'
```

------