Atualize seu rastreador com a posição de um dispositivo - Amazon Location Service

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

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 geocercada (movendo-se de dentro para fora da área ou vice-versa), você receberá eventos no 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.

Para obter mais informações sobre os eventos das geocercas, consulte Reagir aos eventos do Amazon Location Service com o Amazon EventBridge.

Use um desses métodos para enviar atualizações do dispositivo:

  • Envie atualizações do MQTT para um recurso do AWS IoT Core e vincule-o ao seu recurso de rastreador.

  • Envie atualizações de localização usando a API do Amazon Location Trackers, usando a AWS CLI, ou as APIs do Amazon Location. Você pode usar os SDKs AWS para chamar as APIs do seu aplicativo iOS ou Android.

API

Para enviar uma atualização de posição usando as APIs do Amazon Location

Use a operação BatchUpdateDevicePosition das APIs do Amazon Location Trackers.

O exemplo a seguir usa uma solicitação de API para publicar a atualização da posição de um dispositivo para 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.

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