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 coleta de cercas geográficas para avaliar uma ou mais posições usando a BatchEvaluateGeofencesAPI.

Além disso, você pode prever eventos de entrada de uma cerca geográfica para um dispositivo entrando, saindo ou permanecendo ocioso dentro de uma cerca geográfica. Use a ForecastGeofenceEventsAPI para prever eventos.

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 AWS serviços. Para obter mais informações sobre as ações que você pode realizar ao receber eventos de delimitação geográfica, consulte Reagir aos eventos do Amazon Location Service com a 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 EventBridge eventos da Amazon para o Amazon Location Service.

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

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 em uma ExampleDevicecoleção de cercas geográficas 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 do dispositivo em relação à posição das cercas geográficas usando comandos AWS CLI

Use o comando batch-evaluate-geofences.

O exemplo a seguir usa um AWS CLI para avaliar a posição de em ExampleDevicerelação a uma coleção de cerca geográfica 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"}}]'

A avaliação das posições dos dispositivos em relação às geocercas gera eventos. Tradicionalmente, você pode reagir aos eventos usando Amazon EventBridge, mas esse processo só permite que você reaja aos eventos depois que eles acontecerem. Se você precisar prever quando um dispositivo entra ou sai de uma cerca geográfica, por exemplo, se um dispositivo está cruzando uma fronteira e, consequentemente, estará sujeito a uma regulamentação diferente, você poderá usar a API ForecastGeofenceEventspara prever eventos futuros de delimitação geográfica.

A ForecastGeofenceEventsAPI usa critérios como o dispositivo, a proximidade time-to-breach, a velocidade e a posição para prever eventos. A API retornará um ForecastedBreachTime, que sinaliza o tempo estimado em que o evento de geofence ocorrerá.

O exemplo a seguir usa as APIs de localização da Amazon.

API

Para prever eventos de delimitação geográfica usando as APIs de localização da Amazon

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

O exemplo a seguir usa uma solicitação de API para prever eventos de delimitação geográfica para um ExampleDeviceparente de um. ExampleGeofence Substitua esses valores pelos de sua própria geocerca e as IDs do dispositivo.

POST /geofencing/v0/collections/CollectionName/forecast-geofence-events HTTP/1.1
Content-type: application/json

{
   "DeviceState": { 
      "Position": [ number ],
      "Speed": number
   },
   "DistanceUnit": "string",
   "MaxResults": number,
   "NextToken": "string",
   "SpeedUnit": "string",
   "TimeHorizonMinutes": number
}