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á.

# Vincule um rastreador a uma coleção de geocercas
<a name="associate-consumer"></a>

Agora que você tem uma coleção de geocercas e um rastreador, você pode vinculá-los para que as atualizações de localização sejam avaliadas automaticamente em relação a todas as suas geocercas. Se você não quiser avaliar todas as atualizações de localização ou se você não estiver armazenando algumas de suas localizações em um recurso de rastreador, você pode [avaliar as posições dos dispositivos em relação às geocercas](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html) quando precisar.

Quando as posições dos dispositivos são avaliadas em relação às geocercas, os eventos são gerados. Você pode definir uma ação para esses eventos. Para obter mais informações sobre ações que você pode definir para 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 e 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 vinculam um recurso de rastreamento a uma coleção de cercas geográficas usando o console, o ou o Amazon AWS CLI Location. APIs

------
#### [ Console ]

**Vincular um recurso de rastreador a uma coleção de geocercas usando o console do Amazon Location Service**

1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. No painel de navegação à esquerda, selecione **Rastreadores**.

1. Em **Rastreadores de dispositivos**, selecione o link do nome do rastreador de destino.

1. Em **Coleções de geocercas vinculadas**, selecione **Vincular coleção de geocercas**.

1. Na janela **Coleção de geocercas vinculadas**, selecione uma coleção de geocercas no menu suspenso.

1. Escolha **Vincular**.

Depois de vincular o recurso de rastreador, ele receberá um status de **Ativo**.

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

**Para vincular um recurso rastreador a uma coleção de cercas geográficas usando a localização da Amazon APIs**

Use a `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` operação dos Amazon Location Trackers APIs. 

O exemplo a seguir usa uma solicitação de API *ExampleTracker* associada a uma coleção de cercas geográficas usando seu [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html).

```
POST /tracking/v0/trackers/ExampleTracker/consumers
Content-type: application/json

{
   "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection"
}
```

------
#### [ AWS CLI ]

**Para vincular um recurso rastreador a uma coleção de cercas geográficas usando comandos AWS CLI **

Use o comando `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`. 

O exemplo a seguir usa um AWS CLI para criar uma coleção de geofence chamada. *ExampleGeofenceCollection*

```
aws location \
    associate-tracker-consumer \
        --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
        --tracker-name "ExampleTracker"
```

------