Avalie as posições dos dispositivos em relação às geocercas - 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á.

Avalie as posições dos dispositivos em relação às geocercas

Há duas maneiras de avaliar as posições em relação às geocercas para gerar os eventos das geocercas:

  • Você pode vincular os rastreadores e coleções de geocercas. Para obter mais informações, consulte a seção: Vincule um rastreador a uma coleção de geocercas.

  • Você pode fazer uma solicitação direta ao recurso de coleção de geocercas para avaliar uma ou mais posições.

Se você também quiser rastrear seu histórico de localização do dispositivo ou exibir as localizações em um mapa, vincule o rastreador a uma coleção de geocercas. Por outro lado, talvez você não queira avaliar todas as atualizações de localização ou não pretenda armazenar dados de localização em um recurso de rastreador. Se algum desses for o caso, você pode fazer uma solicitação direta à coleção de geocercas e avaliar uma ou mais posições dos dispositivos em relação às suas geocercas.

A avaliação das posições dos dispositivos em relação às geocercas gera eventos. Você pode reagir a esses eventos e encaminhá-los para outros serviços AWS. Para obter mais informações sobre as ações que você pode realizar ao receber os eventos das geocercas, consulte Reagindo aos eventos do Amazon Location Service com o Amazon EventBridge.

Um evento do Amazon Location inclui os atributos da atualização das posições dos dispositivos que o geram, incluindo o horário, a posição, a precisão e os metadados de chave-valor, além de alguns atributos da geocerca onde se entrou ou saiu. Para obter mais informações sobre os dados incluídos em um evento de geocercas, consulte Exemplos de eventos do Amazon EventBridge para o Amazon Location Service.

Os exemplos a seguir usam a AWS CLI ou as APIs do Amazon Location.

API

Para avaliar as posições dos dispositivos em relação à posição das geocercas usando as APIs do Amazon Location

Use a operação BatchEvaluateGeofences das APIs de geocercas do Amazon Location.

O exemplo a seguir usa uma solicitação de API para avaliar a posição do dispositivo ExampleDevice em relação a uma coleção de geocercas associada ExampleGeofenceCollection. Substitua esses valores pelos de sua própria geocerca e as IDs do dispositivo.

POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json

{
   "DevicePositionUpdates": [ 
      { 
         "DeviceId": "ExampleDevice",
         "Position": [-123.123, 47.123],
         "SampleTime": "2021-11-30T21:47:25.149Z",
         "Accuracy": {
            "Horizontal": 10.30
         },
         "PositionProperties": {
            "field1": "value1",
            "field2": "value2"
         }
      }
   ]
}
AWS CLI

Para avaliar as posições dos dispositivos em relação à posição das geocercas usando comandos AWS CLI

Use o comando batch-evaluate-geofences.

O exemplo a seguir usa um AWS CLI para avaliar a posição de ExampleDevice em relação a uma coleção de geocercas associada ExampleGeofenceCollection. Substitua esses valores pelos de sua própria geocerca e as IDs do dispositivo.

aws location \
    batch-evaluate-geofences \
        --collection-name ExampleGeofenceCollection \
        --device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'