Tutorial: vincular um rastreador a uma coleção de cercas geográficas na Amazon Location

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 ações que você pode definir para 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 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.

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

Para 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/.

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

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

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

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

6. 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 operação dos Amazon Location TrackersAPIs.

O exemplo a seguir usa uma API solicitação que associa ExampleTracker com uma coleção de cercas geográficas usando seu Amazon Resource Name ()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 rastreador a uma coleção de cercas geográficas usando comandos AWS CLI

Use o comando associate-tracker-consumer.

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"