Tutorial: Vincular un rastreador a una colección de geovallas en Amazon Location - Amazon Location Service

Tutorial: 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 a 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 eventos de Amazon EventBridge para Amazon Location Service.

Los siguientes ejemplos vinculan un recurso de rastreo a una colección de geocercas mediante la consola, la AWS CLI o las API de Amazon Location.

Console

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

  1. Abra 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 geocercas mediante las API de Amazon Location

Use la operación AsssociateTrackerConsumer de las API de Amazon Location Trackers.

En el siguiente ejemplo, se utiliza una solicitud de API que asocia ExampleTracker a una colección de geocercas mediante 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 geocercas mediante comandos de 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"