Tutorial: Cómo vincular un rastreador a una colección de geovallas en Amazon Location

Ahora que tiene un conjunto de geocercas y un rastreador, puede vincularlos entre sí para que las actualizaciones de ubicación se evalúen automáticamente comparándolas con todas sus geocercas. Si no quiere evaluar todas las actualizaciones de ubicación o, si no va a almacenar algunas de sus ubicaciones en un recurso de rastreo, puede comparar las posiciones de los dispositivos con respecto a las geocercas cuando lo desee.

Cuando las posiciones de los dispositivos se comparan con las geocercas, se generan eventos. Puede establecer una acción para estos eventos. Para obtener más información sobre las acciones que puede configurar para los eventos de geocerca, consulte Reaccionar ante los eventos de Amazon Location Service con Amazon. EventBridge

Un evento de Amazon Location incluye los atributos de la actualización de posición del dispositivo que lo genera y algunos atributos de la geocerca por la que se entra o se sale. Para obtener más información sobre los datos incluidos en un evento de geocercas, consulte Ejemplos de EventBridge eventos de Amazon para Amazon Location Service.

Los siguientes ejemplos vinculan un recurso de rastreo a una colección de geovallas mediante la consola AWS CLI, la ubicación de Amazon o Amazon. APIs

Console

Para vincular un recurso de rastreo a una colección de geocercas mediante la consola de Amazon Location Service

1. Abre la consola de Amazon Location Service en https://console.aws.amazon.com/location/.

2. En el panel de navegación izquierdo, elija Rastreadores.

3. En Rastreadores de dispositivos, seleccione el enlace con el nombre del rastreador objetivo.

4. En Colecciones de geocercas vinculadas, elija Vincular colección de geocercas.

5. En la ventana Colección de geocercas vinculadas, seleccione una colección de geocercas en el menú desplegable.

6. Elija Vincular.

Tras vincular el recurso de rastreador, se le asignará el estado Activo.

API

Para vincular un recurso de rastreo a una colección de geovallas mediante la ubicación de Amazon APIs

Usa la AsssociateTrackerConsumer operación de Amazon Location Trackers. APIs

En el siguiente ejemplo, se utiliza una API solicitud que se asocia ExampleTracker con una colección de geovallas que utiliza su nombre de recurso de 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 un recurso de rastreo a una colección de geovallas mediante comandos AWS CLI

Utilice el comando associate-tracker-consumer.

En el siguiente ejemplo, se utiliza una AWS CLI para crear una colección de geocercas llamada ExampleGeofenceCollection.

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