Évaluez la position des appareils par rapport aux géofences - Amazon Location Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Évaluez la position des appareils par rapport aux géofences

Il existe deux méthodes pour évaluer les positions par rapport aux géofences afin de générer des événements de géofences :

En outre, vous pouvez prévoir les événements de géofence entrants pour un appareil entrant, sortant ou restant inactif à l'intérieur d'une géofence. Utilisez le ForecastGeofenceEventsAPIpour prévoir les événements.

Si vous souhaitez également suivre l'historique des positions de votre appareil ou afficher des positions sur une carte, associez le traceur à une collection de géofences. Il se peut également que vous ne souhaitiez pas évaluer toutes les mises à jour de localisation ou que vous n'ayez pas l'intention de stocker les données de localisation dans une ressource de suivi. Dans l'un ou l'autre cas, vous pouvez adresser une demande directe à la collection de géofences et évaluer la position d'un ou de plusieurs appareils par rapport à ses géofences.

L'évaluation de la position des appareils par rapport aux géofences génère des événements. Vous pouvez réagir à ces événements et les rediriger vers d'autres AWS services. Pour plus d'informations sur les mesures que vous pouvez prendre lors de la réception d'événements de géofence, consultez Réagir aux événements Amazon Location Service with Amazon. EventBridge

Un événement Amazon Location inclut les attributs de la mise à jour de la position de l'appareil qui le génère, notamment l'heure, la position, la précision et les métadonnées des valeurs clés, ainsi que certains attributs de la barrière géographique saisie 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 utilisent le AWS CLI, ou l'emplacement AmazonAPIs.

API

Pour évaluer la position des appareils par rapport à la position des barrières géographiques à l'aide d'Amazon Location APIs

Utilisez l'BatchEvaluateGeofencesopération depuis Amazon Location GeofencesAPIs.

L'exemple suivant utilise une API demande pour évaluer la position de l'appareil ExampleDevice à une collection de géofences associée ExampleGeofenceCollection. Remplacez ces valeurs par votre propre géofence et votre propre appareil. IDs

POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1 Content-type: application/json { "DevicePositionUpdates": [ { "DeviceId": "ExampleDevice", "Position": [-123.123, 47.123], "SampleTime": "2021-11-30T21:47:25.149Z", "Accuracy": { "Horizontal": 10.30 }, "PositionProperties": { "field1": "value1", "field2": "value2" } } ] }
AWS CLI

Pour évaluer la position des appareils par rapport à la position des barrières géographiques à l'aide de commandes AWS CLI

Utilisez la commande batch-evaluate-geofences.

L'exemple suivant utilise un AWS CLI pour évaluer la position de ExampleDevice contre une collection de géofences associée ExampleGeofenceCollection. Remplacez ces valeurs par votre propre géofence et votre propre appareil. IDs

aws location \ batch-evaluate-geofences \ --collection-name ExampleGeofenceCollection \ --device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'

L'évaluation de la position des appareils par rapport aux géofences génère des événements. Traditionnellement, vous pouvez réagir aux événements en utilisant Amazon EventBridge, mais ce processus ne vous permet de réagir aux événements qu'après qu'ils se soient produits. Si vous devez anticiper le moment où un appareil entre ou sort d'une barrière géographique, par exemple si un appareil franchit une frontière et sera soumis à une réglementation différente en conséquence, vous pouvez utiliser le pour ForecastGeofenceEventsAPIprévoir les futurs événements de géofence.

Il ForecastGeofenceEventsAPIutilise des critères tels que l'appareil time-to-breach, la proximité, la vitesse et la position pour prévoir les événements. Un API sera renvoyé ForecastedBreachTime, qui indique l'heure estimée à laquelle l'événement de géofence se produira.

L'exemple suivant utilise l'emplacement AmazonAPIs.

API

Pour prévoir les événements de géofence à l'aide d'Amazon Location APIs

Utilisez l' ForecastGeofenceEventsopération depuis Amazon Location GeofencesAPIs.

L'exemple suivant utilise une API demande pour prévoir les événements de géofence pour un ExampleDevice relatif à un ExampleGeofence. Remplacez ces valeurs par votre propre géofence et votre propre appareil. IDs

POST /geofencing/v0/collections/CollectionName/forecast-geofence-events HTTP/1.1 Content-type: application/json { "DeviceState": { "Position": [ number ], "Speed": number }, "DistanceUnit": "string", "MaxResults": number, "NextToken": "string", "SpeedUnit": "string", "TimeHorizonMinutes": number }