Actualizar el rastreador con la posición del dispositivo - Amazon Location Service

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

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 un área geocercada (moviéndose del interior del área al exterior o viceversa), recibirá eventos en 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.

Para obtener más información sobre los eventos de geocercas, consulte Reacción a los eventos de Amazon Location Service con Amazon EventBridge.

Use uno de estos métodos para enviar las actualizaciones del dispositivo:

  • Envíe actualizaciones de MQTT a un recurso IoT Core de AWS y vincúlelo a su recurso de rastreo.

  • Envíe actualizaciones de ubicación mediante la API de Amazon Location Trackers, mediante la AWS CLI o las API de Amazon Location. Puede usar los SDK de AWS para llamar a las API desde su aplicación iOS o Android.

API

Para enviar una actualización de posición mediante las API de Amazon Location

Use la operación BatchUpdateDevicePosition de las API de Amazon Location Trackers.

En el siguiente ejemplo, se utiliza una solicitud de API para publicar una actualización de la posición del dispositivo para ExampleDevice en un 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 una actualización de posición mediante comandos de AWS CLI

Utilice el comando batch-update-device-position.

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