Gerätepositionen anhand von Geofences in Amazon Location auswerten

Es gibt zwei Möglichkeiten, Positionen anhand von Geofences abzugleichen, um Geofence-Ereignisse zu generieren:

• Sie können Tracker und Geofence-Sammlungen verknüpfen. Weitere Informationen finden Sie im Abschnitt:. Tutorial: Einen Tracker mit einer Geofence-Sammlung in Amazon Location verknüpfen

• Sie können eine direkte Anfrage an die Geofence-Sammlungsressource stellen, um eine oder mehrere Positionen zu bewerten, indem Sie die verwenden. BatchEvaluateGeofencesAPI

Darüber hinaus können Sie eingehende Geofence-Ereignisse für ein Gerät vorhersagen, das ein Geofence betritt, verlässt oder innerhalb eines Geofences inaktiv bleibt. Verwenden Sie das, um Ereignisse vorherzusagen. ForecastGeofenceEventsAPI

Wenn Sie auch den Standortverlauf Ihres Geräts verfolgen oder Standorte auf einer Karte anzeigen möchten, verknüpfen Sie den Tracker mit einer Geofence-Sammlung. Alternativ möchten Sie möglicherweise nicht alle Standortaktualisierungen auswerten, oder Sie beabsichtigen nicht, Standortdaten in einer Tracker-Ressource zu speichern. Wenn einer der beiden Fälle zutrifft, können Sie eine direkte Anfrage an die Geofence-Erfassung richten und eine oder mehrere Gerätepositionen anhand der zugehörigen Geofences auswerten.

Wenn Gerätepositionen anhand von Geofences bewertet werden, werden Ereignisse generiert. Sie können auf diese Ereignisse reagieren und sie an andere AWS Dienste weiterleiten. Weitere Informationen zu Aktionen, die Sie beim Empfang von Geofence-Ereignissen ergreifen können, finden Sie unter Reagieren auf Amazon Location Service Service-Ereignisse mit Amazon. EventBridge

Ein Amazon-Standortereignis umfasst die Attribute der Gerätepositions-Aktualisierung, mit der es generiert wird, einschließlich Uhrzeit, Position, Genauigkeit und Schlüsselwertmetadaten sowie einige Attribute des Geofence, der eingegeben oder verlassen wird. Weitere Informationen zu den in einem Geofence-Ereignis enthaltenen Daten finden Sie unter. Amazon- EventBridge Ereignisbeispiele für Amazon Location Service

In den folgenden Beispielen wird der AWS CLI oder der Amazon-Standort verwendetAPIs.

API

Um Gerätepositionen anhand des Amazon-Standorts mit der Position von Geofences zu vergleichen APIs

Verwenden Sie den BatchEvaluateGeofences Vorgang von Amazon Location Geofences APIs aus.

Im folgenden Beispiel wird eine API Anfrage verwendet, um die Position des Geräts auszuwerten ExampleDevice zu einer zugehörigen Geofence-Sammlung ExampleGeofenceCollection. Ersetzen Sie diese Werte durch Ihren eigenen Geofence und Ihr eigenes Gerät. 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

Um Gerätepositionen mithilfe von Befehlen mit der Position von Geofences abzugleichen AWS CLI

Verwenden Sie den batch-evaluate-geofences-Befehl.

Im folgenden Beispiel wird ein verwendet AWS CLI , um die Position von auszuwerten ExampleDevice gegen eine zugehörige Geofence-Sammlung ExampleGeofenceCollection. Ersetzen Sie diese Werte durch Ihren eigenen Geofence und Ihr eigenes Gerät. 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"}}]'

Wenn Gerätepositionen anhand von Geofences bewertet werden, werden Ereignisse generiert. Traditionell können Sie auf Ereignisse reagieren Amazon EventBridge, indem Sie Wenn Sie voraussehen müssen, wann ein Gerät einen Geofence betritt oder verlässt, z. B. wenn ein Gerät eine Grenze überquert und infolgedessen anderen Vorschriften unterliegt, können Sie das ForecastGeofenceEventsAPIverwenden, um future Geofence-Ereignisse vorherzusagen.

Der ForecastGeofenceEventsAPIverwendet Kriterien wie die Nähe time-to-breach, Geschwindigkeit und Position des Geräts, um Ereignisse vorherzusagen. Es API wird ein zurückgegeben ForecastedBreachTime, das die geschätzte Zeit angibt, zu der das Geofence-Ereignis eintreten wird.

Im folgenden Beispiel wird der Amazon-Standort verwendetAPIs.

API

So prognostizieren Sie Geofence-Ereignisse mithilfe des Amazon-Standorts APIs

Verwenden Sie den ForecastGeofenceEvents Vorgang von Amazon Location Geofences APIs aus.

Das folgende Beispiel verwendet eine API Anfrage zur Prognose von Geofence-Ereignissen für ein ExampleDevice relativ zu einem ExampleGeofence. Ersetzen Sie diese Werte durch Ihren eigenen Geofence und Ihr eigenes Gerät. 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
}