Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Gerätepositionen anhand von Geofences auswerten
<a name="evaluate-geofences"></a>

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:. [Einen Tracker mit einer Geofence-Sammlung verknüpfen](associate-consumer.md)
+ Sie können eine direkte Anfrage an die Geofence-Sammlungsressource stellen, um eine oder mehrere Positionen zu bewerten. 

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-Erfassung. 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](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html). 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. [Beispiele für EventBridge Amazon-Veranstaltungen für Amazon Location Service](location-events.md#example-event)

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

------
#### [ API ]

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

Verwenden Sie den `[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` Vorgang von Amazon Location Geofences APIs aus. 

Das folgende Beispiel verwendet eine API-Anfrage, um die Position des Geräts anhand einer zugehörigen *ExampleDevice* Geofence-Erfassung auszuwerten. *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 Befehl `[batch-evaluate-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`. 

Im folgenden Beispiel wird ein verwendet AWS CLI , um die Position von *ExampleDevice* anhand einer zugehörigen Geofence-Sammlung auszuwerten. *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"}}]'
```

------