Fügen Sie Geofences hinzu - Amazon Location Service
Erstellen Sie eine Geofence-SammlungZeichne GeofencesPolygon-Geofences hinzufügenHinzufügen von kreisförmigen Geofences

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.

Fügen Sie Geofences hinzu

Geofences enthalten Punkte und Scheitelpunkte, die eine geschlossene Grenze bilden, die ein Interessengebiet definiert. Geofence-Sammlungen speichern und verwalten einen oder mehrere Geofences.

Amazon Location Geofence Collections speichert 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 mit Löchern, Multipolygonen, Polygonen im Uhrzeigersinn und Geofences, die den Antimeridian durchqueren.

Erstellen Sie eine Geofence-Sammlung

Erstellen Sie eine Geofence-Sammlung zum Speichern und Verwalten von Geofences mithilfe der Amazon Location-Konsole AWS CLI, der oder der Amazon Location APIs.

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

  4. Füllen Sie die folgenden Felder aus:

    • Name — Geben Sie einen eindeutigen Namen ein. Zum Beispiel ExampleGeofenceCollection. Maximal 100 Zeichen. Gültige 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 Markieren Ihrer Amazon Location Service-Ressourcen.

  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, statt der standardmäßigen AWS Verschlüsselung. Weitere Informationen finden Sie unter Daten im Ruhezustand verschlüsseln.

  8. Wählen Sie Geofence-Sammlung erstellen aus.

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 create-geofence-collection-Befehl.

Im folgenden Beispiel wird eine verwendet AWS CLI , um eine Geofence-Sammlung namens zu erstellen. ExampleGeofenceCollection Die Geofence-Erfassung ist mit einem vom Kunden verwalteten AWS KMS Schlüssel zur Verschlüsselung von Kundendaten verknüpft.

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 Geofence als Kreis zu erstellen, müssen Sie den Mittelpunkt des Kreises und den Radius definieren. Wenn Sie beispielsweise einen Geofence erstellen möchten, um benachrichtigt zu werden, wenn sich ein Gerät in einem Umkreis von 50 Metern um einen bestimmten Standort befindet, würden Sie den Breiten- und Längengrad dieses Standorts verwenden und den Radius als 50 Meter angeben.

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 seinen Typ, oder andere für Ihre Anwendung spezifische Informationen zu speichern. Sie können diese Metadaten verwenden, wenn. Reagieren auf Amazon Location Service-Ereignisse mit Amazon EventBridge

Polygon-Geofences hinzufügen

In diesem Abschnitt wird die Erstellung von Polygon-Geofences beschrieben

Zeichnen Sie Geofences mit einem GeoJSON-Tool

Nachdem Sie Ihre Geofence-Sammlung erstellt haben, können Sie Ihre Geofences mithilfe eines GeoJSON-Bearbeitungswerkzeugs wie geojson.io definieren.

Um eine GeoJSON-Datei zu erstellen

  1. Öffnen Sie ein GeoJSON-Bearbeitungswerkzeug. Zum Beispiel 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.

Im folgenden Beispiel wird eine API-Anfrage verwendet, um einer aufgerufenen Geofence-Sammlung einen Geofence mit der ID GEOFENCE-EXAMPLE1 hinzuzufügen. ExampleGeofenceCollection Es gibt auch eine einzelne Geofence-Metadateneigenschaft mit dem Schlüssel und dem Wert an. Type loadingArea

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/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

Um einer Geofence-Sammlung mithilfe von Befehlen einen Geofence hinzuzufügen AWS CLI

Verwenden Sie den put-geofence-Befehl.

Im folgenden Beispiel wird ein 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]]]'
    {
        "CreateTime": "2020-11-11T00:16:14.487000+00:00",
        "GeofenceId": "ExampleGeofenceTriangle",
        "UpdateTime": "2020-11-11T00:19:59.894000+00:00"
    }

Hinzufügen von kreisförmigen Geofences

In diesem Abschnitt wird die Erstellung kreisförmiger Geofences beschrieben. Sie müssen den Breiten- und Längengrad des Punkts, der den Mittelpunkt des Kreises bilden soll, sowie den Radius des Kreises in Metern kennen. Sie können kreisförmige Geofences mit den Amazon Location APIs oder den erstellen. AWS CLI

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 einen Geofence mit der ID GEOFENCE-EXAMPLE2 zu einer Geofence-Sammlung mit dem Namen hinzuzufügen: ExampleGeofenceCollection

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/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 put-geofence-Befehl.

Im folgenden Beispiel wird ein verwendet, AWS CLI um einer Geofence-Sammlung einen Geofence hinzuzufügen, der aufgerufen wird. 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 gezeigt.

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceCircle \
            --geometry file:circle.json

Im Beispiel enthält die Datei circle.json JSON für die Kreisgeometrie.

{
    "Circle": {
        "Center": [-74.006975, 40.717127],
        "Radius": 287.7897969218057
    }
}