Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Actualizar el rastreador con la posición del dispositivo
<a name="send-location-updates"></a>

Para rastrear sus dispositivos, puede publicar actualizaciones de la posición del dispositivo en su rastreador. Más adelante, puede recuperar estas posiciones de los dispositivos o el historial de posiciones del dispositivo desde su recurso de rastreador.

Cada actualización de posición debe incluir el ID del dispositivo, una marca de tiempo y una posición. Si lo desea, puede incluir otros metadatos, como la precisión y hasta 3 pares clave-valor para su propio uso.

Si su rastreador está asociado a una o más colecciones de geocercas, las actualizaciones se evaluarán en función de esas geocercas (siguiendo las reglas de filtrado que especificó para el rastreador). Si un dispositivo entra en una zona geovallada (moviéndose desde el interior de la zona hacia el exterior o viceversa), recibirás eventos en su interior. EventBridge Estos eventos `ENTER` o `EXIT` incluyen los detalles de la actualización de la posición, como el ID del dispositivo, la marca de tiempo y cualquier metadato asociado.

**nota**  
Para obtener más información sobre cómo filtrar posiciones, consulte [Crear un rastreador](start-create-tracker.md).  
Para obtener más información sobre los eventos de geocercas, consulte [Reaccione a los eventos de Amazon Location Service con Amazon EventBridge](location-events.md).

Use uno de estos métodos para enviar las actualizaciones del dispositivo:
+ [Envía actualizaciones de MQTT](tracking-using-mqtt.md) a un recurso de AWS IoT Core y vincúlalo a tu recurso de seguimiento.
+ Envía actualizaciones de ubicación mediante la API de Amazon Location Trackers, mediante la AWS CLI ubicación APIs de Amazon o Amazon. Puedes usar el [AWS SDKs](dev-sdks.md)para llamar APIs desde tu aplicación iOS o Android.

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

**Para enviar una actualización de posición a través de la sucursal de Amazon APIs**

Usa la `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` operación de Amazon Location Trackers. APIs 

En el siguiente ejemplo, se utiliza una solicitud de API para publicar una actualización de la posición del dispositivo en un rastreador*ExampleTracker*. *ExampleDevice*

```
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 una actualización de posición mediante comandos de AWS CLI **

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

En el siguiente ejemplo, se utiliza una AWS CLI para publicar una actualización de la posición del dispositivo *ExampleDevice-2* para *ExampleDevice-1* y en un 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"}}]'
```

------