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.
# Geofences mit Amazon Location hinzufügen
Geofences enthalten Punkte und Scheitelpunkte, die eine geschlossene Grenze bilden, die ein Interessengebiet definiert. Geofence-Sammlungen speichern und verwalten einen oder mehrere Geofences.
Geofence-Sammlungen von Amazon Location speichern Geofences, die mithilfe eines standardmäßigen Geodatenformats namens [GeoJSON](https://geojson.org/) (RFC 7946) definiert wurden. Sie können Tools wie [geojson.io](http://geojson.io/) kostenlos verwenden, um Ihre Geofences grafisch zu zeichnen und die ausgegebene GeoJSON-Datei zu speichern.
**Anmerkung**
Amazon Location unterstützt keine Polygone im Uhrzeigersinn (verwenden Sie die Windungsreihenfolge gegen den Uhrzeigersinn, wie in [RFC 7946 §3.1.6](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.6) vorgeschrieben) und Geofences, die den Antimeridian (die 180°-Längengradlinie) kreuzen.
**Topics**
+ [Erstellen einer Geofence-Sammlung](#create-geofence-collection)
+ [Zeichne Geofences](#draw-geofences)
+ [Polygon-Geofences hinzufügen](#draw-polygon-geofences)
+ [Fügen Sie kreisförmige Geofences hinzu](#draw-circle-geofences)
## Erstellen einer Geofence-Sammlung
Erstellen Sie eine Geofence-Sammlung, um Geofences zu speichern und zu verwalten, indem Sie die Amazon Location Console AWS CLI, die oder die Amazon Location APIs verwenden.
------
#### [ Console ]
1. Öffnen Sie die Amazon Location Service Service-Konsole unter [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Wählen Sie im linken Navigationsbereich **Geofence-Sammlungen** aus.
1. Wählen Sie **Geofence-Sammlung erstellen**.
1. Füllen Sie die folgenden Felder aus:
+ ****Name**** — Geben Sie einen eindeutigen Namen ein. Beispiel, {{ExampleGeofenceCollection}}. Maximal 100 Zeichen. Zulässige Einträge umfassen alphanumerische Zeichen, Bindestriche, Punkte und Unterstriche.
+ ****Beschreibung**** — Geben Sie optional eine Beschreibung ein, um Ihre Ressourcen zu differenzieren.
1. Unter **EventBridge CloudWatch Regel mit Ziel können Sie eine** optionale EventBridge Regel erstellen, mit der Sie sofort auf [Geofence-Ereignisse reagieren](location-events.md) können. Dadurch kann Amazon Location Ereignisse in Amazon CloudWatch Logs veröffentlichen.
1. (Optional) Geben Sie unter **Markierungen** einen Tag **Key (Schlüssel)** und einen **Value (Wert) ** ein. Dadurch wird Ihrer neuen Geofence-Sammlung ein Tag hinzugefügt. Weitere Informationen finden Sie unter [Ressourcen mit Tags verwalten](manage-resources.md).
1. (Optional) Unter **Verschlüsselung mit vom Kunden verwaltetem Schlüssel** können Sie wählen, ob Sie **einen vom Kunden verwalteten Schlüssel hinzufügen** möchten. Dadurch wird ein symmetrischer, vom Kunden verwalteter Schlüssel hinzugefügt, den Sie erstellen, besitzen und verwalten, und den Sie anstelle der standardmäßigen AWS Verschlüsselung verwalten. Weitere Informationen finden Sie unter [Daten im Ruhezustand verschlüsseln](encryption-at-rest.md).
1. Wählen Sie „**Geofence-Sammlung erstellen**“.
------
#### [ API ]
Verwenden Sie den `[CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html)` Vorgang über die Amazon Location Geofences-APIs.
Im folgenden Beispiel wird eine API-Anfrage verwendet, um eine Geofence-Sammlung namens zu erstellen. {{ExampleGeofenceCollection}} Die Geofence-Erfassung ist mit einem vom [Kunden verwalteten AWS KMS Schlüssel verknüpft, um Kundendaten zu verschlüsseln](encryption-at-rest.md).
```
POST /geofencing/v0/collections
Content-type: application/json
{
"CollectionName": "{{ExampleGeofenceCollection}}",
"Description": "Geofence collection 1 for shopping center",
"KmsKeyId": "{{1234abcd-12ab-34cd-56ef-1234567890ab}}",
"Tags": {
"Tag1" : "Value1"
}
}
```
------
#### [ AWS CLI ]
Verwenden Sie den Befehl `[create-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/create-geofence-collection.html)`.
Das folgende Beispiel verwendet die, AWS CLI um eine Geofence-Sammlung namens zu erstellen. {{ExampleGeofenceCollection}} Die Geofence-Erfassung ist mit einem vom [Kunden verwalteten AWS KMS Schlüssel verknüpft, um Kundendaten zu verschlüsseln](encryption-at-rest.md).
```
aws location \
create-geofence-collection \
--collection-name "{{ExampleGeofenceCollection}}" \
--description "Shopping center geofence collection" \
--kms-key-id "{{1234abcd-12ab-34cd-56ef-1234567890ab}}" \
--tags Tag1=Value1
```
------
**Anmerkung**
Die Abrechnung hängt von Ihrer Nutzung ab. Für die Nutzung anderer AWS Dienste können Gebühren anfallen. Weitere Informationen finden Sie unter [Amazon Location Service — Preise](https://aws.amazon.com/location/pricing/).
## Zeichne Geofences
Nachdem Sie Ihre Geofence-Sammlung erstellt haben, können Sie Ihre Geofences definieren. Geofences werden entweder als Polygon oder als Kreis definiert. [Um einen Polygon-Geofence zu zeichnen, können Sie ein GeoJSON-Bearbeitungswerkzeug wie geojson.io verwenden.](http://geojson.io/)
Um einen kreisförmigen Geofence zu erstellen, definieren Sie den Mittelpunkt anhand des Breiten- und Längengrads der Position und legen Sie den Radius in Metern fest. Weitere Informationen finden Sie unter [Fügen Sie kreisförmige Geofences hinzu](#draw-circle-geofences).
Mithilfe der Amazon Location Service APIs können Sie Ihrem Geofence auch Metadaten in Form von Schlüssel-Wert-Paaren hinzufügen. Diese können nützlich sein, um Informationen über den Geofence, wie z. B. seinen Typ, oder andere für Ihre Anwendung spezifische Informationen zu speichern. Sie können diese Metadaten verwenden, wenn. [Reagieren Sie mit Amazon auf Amazon Location Service Service-Ereignisse EventBridge](location-events.md)
## Polygon-Geofences hinzufügen
Polygon-Geofences verwenden GeoJSON-Koordinatenarrays, um ein Gebiet zu definieren. Verwenden Sie dieses Format, wenn Sie Eingänge in oder Austritte aus einer unregelmäßig geformten geographischen Grenze verfolgen müssen.
### Zeichnen Sie Geofences mit einem GeoJSON-Tool
1. Öffnen Sie ein GeoJSON-Bearbeitungswerkzeug wie [geojson.io](http://geojson.io/).
1. Wählen Sie das Symbol „**Polygon zeichnen**“ und zeichnen Sie Ihren Interessenbereich.
1. Wählen Sie **Speichern** und anschließend **GeoJSON** aus dem Drop-down-Menü aus.
### Fügen Sie GeoJSON-Geofences in eine Geofence-Sammlung ein
Sie können die resultierende GeoJSON-Datei verwenden, um Ihre Geofences mithilfe der Amazon Location Service Service-Konsole AWS CLI, der oder der Amazon Location APIs hochzuladen.
------
#### [ Console ]
1. Öffnen Sie die Amazon Location Service Service-Konsole unter [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Wählen Sie im linken Navigationsbereich **Geofence-Sammlungen** aus.
1. Wählen Sie in der Liste **der Geofence-Sammlungen** den Namenslink für die Geofence-Zielsammlung aus.
1. **Wählen Sie unter **Geofences die Option Geofences erstellen aus**.**
1. Ziehen **Sie im Fenster Geofences hinzufügen** Ihre GeoJSON-Datei per Drag & Drop in das Fenster.
1. **Wählen Sie Geofences hinzufügen aus.**
------
#### [ API ]
Verwenden Sie den `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` Vorgang über die Amazon Location Geofences-APIs.
Das folgende Beispiel verwendet eine API-Anfrage, um einer Geofence-Sammlung namens einen Geofence mit der ID {{GEOFENCE-EXAMPLE1}} hinzuzufügen. {{ExampleGeofenceCollection}} Es spezifiziert auch eine Geofence-Metadateneigenschaft mit dem Schlüssel und dem Wert. `Type` `loadingArea`
```
PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE1}}
Content-type: application/json
{
"GeofenceProperties": {
"Type" : "loadingArea"
},
"Geometry": {
"Polygon": [
[
[-5.716667, -15.933333],
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
]
}
}
```
Alternativ können Sie mithilfe der Operation mehr als einen Geofence hinzufügen. `[BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html)`
```
POST /geofencing/v0/collections/{{ExampleGeofenceCollection}}/put-geofences
Content-type: application/json
{
"Entries": [
{
"GeofenceProperties": {
"Type" : "loadingArea"
},
"GeofenceId": "{{GEOFENCE-EXAMPLE1}}",
"Geometry": {
"Polygon": [
[
[-5.716667, -15.933333],
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
]
}
}
]
}
```
------
#### [ AWS CLI ]
Verwenden Sie den Befehl `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
Im folgenden Beispiel wird der verwendet, AWS CLI um einer Geofence-Sammlung einen Geofence hinzuzufügen, der aufgerufen wird. {{ExampleGeofenceCollection}}
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceTriangle}} \
--geofence-properties '{"Type": "loadingArea"}' \
--geometry 'Polygon=[[[-5.716667, -15.933333],[-14.416667, -7.933333],[-12.316667, -37.066667],[-5.716667, -15.933333]]]'
```
------
## Fügen Sie kreisförmige Geofences hinzu
Um einen kreisförmigen Geofence zu erstellen, müssen Sie den Breiten- und Längengrad des Mittelpunkts sowie den Radius in Metern kennen. Verwenden Sie kreisförmige Geofences, wenn Sie Ereignisse auslösen müssen, die auf der Nähe zu einem bestimmten Punkt basieren, z. B. einem Geschäft, einem Lagerhaus oder einer Sehenswürdigkeit. Sie können kreisförmige Geofences mit der Amazon Location-Konsole, den Amazon Location APIs oder dem erstellen. AWS CLI
------
#### [ Console ]
1. Öffnen Sie die Amazon Location Service Service-Konsole unter [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Wählen Sie im linken Navigationsbereich **Geofence-Sammlungen** aus.
1. Wählen Sie in der Liste **der Geofence-Sammlungen** den Namenslink für die Geofence-Zielsammlung aus.
1. **Wählen Sie unter **Geofences die Option Geofences erstellen aus**.**
1. **Wählen **Sie im Fenster Geofences hinzufügen** die Option **Kreis** aus und geben Sie dann den **Breitengrad**, **Längengrad** und Radius der Mitte in Metern ein.**
1. Wählen Sie „Geofences **hinzufügen**“.
------
#### [ API ]
Verwenden Sie den `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` Vorgang über die Amazon Location Geofences-APIs.
Das folgende Beispiel verwendet eine API-Anfrage, um einer Geofence-Sammlung namens einen Geofence mit der ID {{GEOFENCE-EXAMPLE2}} hinzuzufügen. {{ExampleGeofenceCollection}}
```
PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE2}}
Content-type: application/json
{
"Geometry": {
"Circle": {
"Center": [-5.716667, -15.933333],
"Radius": 50
}
}
}
```
------
#### [ AWS CLI ]
Verwenden Sie den Befehl `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
Im folgenden Beispiel wird der verwendet, AWS CLI um einer Geofence-Sammlung mit dem Namen einen kreisförmigen Geofence hinzuzufügen. {{ExampleGeofenceCollection}}
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
```
**Anmerkung**
Sie können JSON für komplexe Geometrie auch in einer eigenen Datei ablegen, wie im folgenden Beispiel.
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry file://circle.json
```
Wo befindet `circle.json` sich die Kreisgeometrie.
```
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
```
------