Tutoriel : associer un traceur à une collection de géofences dans Amazon Location

Maintenant que vous disposez d'une collection de géofences et d'un traceur, vous pouvez les relier afin que les mises à jour de localisation soient automatiquement évaluées par rapport à toutes vos géofences. Si vous ne souhaitez pas évaluer toutes les mises à jour de localisation, ou si vous ne stockez pas certaines de vos positions dans une ressource de suivi, vous pouvez évaluer les positions des appareils par rapport aux géofences à la demande.

Lorsque les positions des appareils sont évaluées par rapport aux géofences, des événements sont générés. Vous pouvez définir une action pour ces événements. Pour plus d'informations sur les actions que vous pouvez définir pour les événements de géofence, consultez Réagir aux événements Amazon Location Service avec Amazon. EventBridge

Un événement Amazon Location inclut les attributs de la mise à jour de position de l'appareil qui le génère et certains attributs de la barrière géographique entrée ou sortie. Pour plus d'informations sur les données incluses dans un événement de géofence, consultez. Exemples EventBridge d'événements Amazon pour Amazon Location Service

Les exemples suivants relient une ressource de suivi à une collection de géofences à l'aide de la console AWS CLI, du ou de l'Amazon Location. APIs

Console

Pour associer une ressource de suivi à une collection de géofences à l'aide de la console Amazon Location Service

1. Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/.

2. Dans le volet de navigation de gauche, choisissez Trackers.

3. Sous Device trackers, sélectionnez le lien du nom du tracker cible.

4. Sous Collections Geofence liées, choisissez Link Geofence Collection.

5. Dans la fenêtre Linked Geofence Collection, sélectionnez une collection de géofences dans le menu déroulant.

6. Choisissez Lier.

Une fois que vous aurez lié la ressource de suivi, le statut Actif lui sera attribué.

API

Pour associer une ressource de suivi à une collection de géofences à l'aide d'Amazon Location APIs

Utilisez l'AsssociateTrackerConsumeropération des Amazon Location TrackersAPIs.

L'exemple suivant utilise une API demande qui associe ExampleTracker avec une collection de géofences utilisant son 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

Pour lier une ressource de suivi à une collection de géofences à l'aide de commandes AWS CLI

Utilisez la commande associate-tracker-consumer.

L'exemple suivant utilise un AWS CLI pour créer une collection de géofences appelée ExampleGeofenceCollection.

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