Geofences mit Amazon Location hinzufügen - 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.

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.

Amazon Location Geofence Collections speichert Geofences, die mithilfe eines standardmäßigen Geodatenformats namens Geo (7946) definiert wurden. JSON RFC Sie können Tools wie geojson.io kostenlos verwenden, um Ihre Geofences grafisch zu zeichnen und die ausgegebene Geodatei zu speichern. JSON

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, um Geofences zu speichern und zu verwalten, indem Sie die Amazon Location-Konsole, den oder den AWS CLI Amazon-Standort verwenden. 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. 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 Kennzeichnen Sie Ihre Amazon Location Service 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“.

API

So erstellen Sie eine Geofence-Sammlung mithilfe des Amazon-Standorts APIs

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

Im folgenden Beispiel wird eine API Anfrage zur Erstellung einer Geofence-Sammlung mit dem Namen verwendet ExampleGeofenceCollection. Die Geofence-Erfassung ist mit einem vom Kunden verwalteten AWS KMS Schlüssel zur Verschlüsselung von Kundendaten verknüpft.

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 JSON Geobearbeitungswerkzeug 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.

Mit dem 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 Geozäune mit einem Geo-Werkzeug JSON

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

Um eine Geodatei zu JSON erstellen

  1. Öffnen Sie ein JSON Geo-Bearbeitungswerkzeug. Zum Beispiel geojson.io.

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

  3. Wähle „Speichern“ und dann „Geo“ JSON aus dem Drop-down-Menü.

Fügen Sie JSON Geo-Geofences einer Geofence-Sammlung hinzu

Sie können die resultierende JSON Geodatei verwenden, um Ihre Geofences über die Amazon Location Service Service-Konsole AWS CLI, den oder den Amazon-Standort hochzuladen: APIs

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 Geodaten per Drag & Drop in das Fenster. JSON

  6. Wählen Sie Geofences hinzufügen.

API

So fügen Sie Geofences mithilfe des Amazon-Standorts hinzu APIs

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

Im folgenden Beispiel wird anhand der ID eine API Anfrage zum Hinzufügen eines Geofences verwendet GEOFENCE-EXAMPLE1 zu einer Geofence-Sammlung namens ExampleGeofenceCollection. Es spezifiziert auch eine einzelne Geofence-Metadateneigenschaft mit dem Schlüssel Type und dem Wert. 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

So fügen Sie einer Geofence-Sammlung mithilfe von Befehlen einen Geofence hinzu AWS CLI

Verwenden Sie den put-geofence-Befehl.

Im folgenden Beispiel wird ein verwendet AWS CLI , um einer Geofence-Sammlung einen Geofence hinzuzufügen 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 dem Amazon-Standort APIs oder dem erstellen. AWS CLI

API

So fügen Sie kreisförmige Geofences mithilfe des Amazon-Standorts hinzu APIs

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

Im folgenden Beispiel wird anhand der ID eine API Anfrage zum Hinzufügen eines Geofences verwendet GEOFENCE-EXAMPLE2 zu einer Geofence-Sammlung namens 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 ExampleGeofenceCollection.

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceCircle \
            --geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
Anmerkung

Sie können komplexe Geometrie auch in einer eigenen Datei ablegenJSON, wie im folgenden Beispiel gezeigt.

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

Im Beispiel beinhaltet die Datei circle.json die JSON Kreisgeometrie.

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