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
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 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 as ações que você pode definir para 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 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 eventos do Amazon EventBridge para o Amazon Location Service.
Os exemplos a seguir vinculam um recurso de rastreador a uma coleção de geocercas usando o console, o AWS CLI ou as APIs do Amazon Location.
- Console
-
Vincular um recurso de rastreador a uma coleção de geocercas usando o console do Amazon Location Service
-
Abra o console do Amazon Location Service em https://console.aws.amazon.com/location/.
-
No painel de navegação à esquerda, selecione Rastreadores.
-
Em Rastreadores de dispositivos, selecione o link do nome do rastreador de destino.
-
Em Coleções de geocercas vinculadas, selecione Vincular coleção de geocercas.
-
Na janela Coleção de geocercas vinculadas, selecione uma coleção de geocercas no menu suspenso.
-
Escolha Vincular.
Depois de vincular o recurso de rastreador, ele receberá um status de Ativo.
- API
-
Para vincular um recurso de rastreador a uma coleção de geocercas usando as APIs do Amazon Location
Use a operação AsssociateTrackerConsumer das APIs de Rastreadores do Amazon Location.
O exemplo a seguir usa uma solicitação de API que associa o ExampleTracker a uma coleção de geocercas usando seu nome do recurso da Amazon (ARN).
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 de rastreador a uma coleção de geocercas usando comandos AWS CLI
Use o comando associate-tracker-consumer.
O exemplo a seguir usa um AWS CLI para criar uma coleção de geocercas chamada ExampleGeofenceCollection.
aws location \
associate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
--tracker-name "ExampleTracker"