View a markdown version of this page

Geofences mit Amazon Location hinzufügen - Amazon Location Service
Erstellen einer Geofence-SammlungZeichne GeofencesPolygon-Geofences hinzufügenFügen Sie kreisförmige Geofences hinzu

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 (RFC 7946) definiert wurden. Sie können Tools wie 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 vorgeschrieben) und Geofences, die den Antimeridian (die 180°-Längengradlinie) kreuzen.

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
So erstellen Sie eine Geofence-Sammlung mit der Amazon Location-Konsole

  1. Öffnen Sie die Amazon Location Service Service-Konsole unter https://console.aws.amazon.com/location/.

  2. Wählen Sie im linken Navigationsbereich Geofence-Sammlungen aus.

  3. Wählen Sie Geofence-Sammlung erstellen.

  4. 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.

  5. Unter EventBridge CloudWatch Regel mit Ziel können Sie eine optionale EventBridge Regel erstellen, mit der Sie sofort auf Geofence-Ereignisse reagieren können. Dadurch kann Amazon Location Ereignisse in Amazon CloudWatch Logs veröffentlichen.

  6. (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.

  7. (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.

  8. Wählen Sie „Geofence-Sammlung erstellen“.

API
So erstellen Sie eine Geofence-Sammlung mithilfe der Amazon Location APIs

Verwenden Sie den CreateGeofenceCollection 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.

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
Um eine Geofence-Sammlung mithilfe von Befehlen zu erstellen AWS CLI

Verwenden Sie den Befehl create-geofence-collection.

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.

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.

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.

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.

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

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

Um eine GeoJSON-Datei zu erstellen

  1. Öffnen Sie ein GeoJSON-Bearbeitungswerkzeug wie geojson.io.

  2. Wählen Sie das Symbol „Polygon zeichnen“ und zeichnen Sie Ihren Interessenbereich.

  3. 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
So fügen Sie mithilfe der Amazon Location Service Service-Konsole einen Geofence zu einer Geofence-Sammlung hinzu

  1. Öffnen Sie die Amazon Location Service Service-Konsole unter https://console.aws.amazon.com/location/.

  2. Wählen Sie im linken Navigationsbereich Geofence-Sammlungen aus.

  3. Wählen Sie in der Liste der Geofence-Sammlungen den Namenslink für die Geofence-Zielsammlung aus.

  4. Wählen Sie unter Geofences die Option Geofences erstellen aus.

  5. Ziehen Sie im Fenster Geofences hinzufügen Ihre GeoJSON-Datei per Drag & Drop in das Fenster.

  6. Wählen Sie Geofences hinzufügen aus.

API
So fügen Sie Geofences mithilfe der Amazon Location APIs hinzu

Verwenden Sie den PutGeofence 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

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
So fügen Sie einer Geofence-Sammlung mithilfe von Befehlen einen Geofence hinzu AWS CLI

Verwenden Sie den Befehl put-geofence.

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
So fügen Sie mithilfe der Amazon Location Service Service-Konsole einen kreisförmigen Geofence zu einer Geofence-Sammlung hinzu

  1. Öffnen Sie die Amazon Location Service Service-Konsole unter https://console.aws.amazon.com/location/.

  2. Wählen Sie im linken Navigationsbereich Geofence-Sammlungen aus.

  3. Wählen Sie in der Liste der Geofence-Sammlungen den Namenslink für die Geofence-Zielsammlung aus.

  4. Wählen Sie unter Geofences die Option Geofences erstellen aus.

  5. 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.

  6. Wählen Sie „Geofences hinzufügen“.

API
Um kreisförmige Geofences mithilfe der Amazon Location APIs hinzuzufügen

Verwenden Sie den PutGeofence 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
Um einer Geofence-Sammlung mithilfe von Befehlen einen kreisförmigen Geofence hinzuzufügen AWS CLI

Verwenden Sie den Befehl put-geofence.

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
    }
}