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
<a name="evaluate-geofences"></a>

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](associate-consumer.md).
+ 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 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](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html) 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](location-events.md#example-event).

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

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

**Para avaliar as posições do dispositivo em relação à posição das cercas geográficas usando a localização da Amazon APIs**

Use a `[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` operação da Amazon Location Geofences APIs. 

O exemplo a seguir usa uma solicitação de API para avaliar a posição do dispositivo em uma *ExampleDevice* coleção de cercas geográficas associada. *ExampleGeofenceCollection* Substitua esses valores por sua própria cerca geográfica e dispositivo. IDs

```
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](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`. 

O exemplo a seguir usa um AWS CLI para avaliar a posição de em *ExampleDevice* relação a uma coleção de cerca geográfica associada. *ExampleGeofenceCollection* Substitua esses valores por sua própria cerca geográfica e dispositivo. IDs

```
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"}}]'
```

------