Geofences hinzufügen - Amazon Location Service
Erstellen einer Geofence-SammlungGeofences entwerfenHinzufügen von Polygon-GeofencesHinzufügen von Zirkelgeofences

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 hinzufügen

Geofences enthalten Punkte und Scheitelpunkte, die eine geschlossene Grenze bilden, die einen Interessenbereich 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 GeoJSON-Ausgabedatei zu speichern.

Anmerkung

Amazon Location unterstützt keine Polygone mit Lücken, Multipolygonen, Uhrzeigersinn-Polygonen und Geofences, die den Antimeridian durchqueren.

Erstellen einer Geofence-Sammlung

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

Console

So erstellen Sie eine Geofence-Sammlung mit der Amazon Location-Konsole

  1. Öffnen Sie die Amazon Location 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 eine optionale Beschreibung ein, um Ihre Ressourcen zu unterscheiden.

  5. Unter EventBridge Regel mit CloudWatch als Ziel können Sie eine optionale EventBridge Regel erstellen, um auf Geofence-Ereignisse zu reagieren. Auf diese Weise 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 Kundenverwaltete Schlüsselverschlüsselung können Sie wählen, ob Sie einen vom Kunden verwalteten Schlüssel hinzufügen möchten. Dadurch wird ein symmetrischer kundenverwalteter Schlüssel hinzugefügt, den Sie über die standardmäßige AWS-eigene Verschlüsselung erstellen, besitzen und verwalten. Weitere Informationen finden Sie unter Verschlüsseln von Daten im Ruhezustand.

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

API

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

Verwenden Sie die -CreateGeofenceCollectionOperation aus den Amazon Location Geofences APIs .

Im folgenden Beispiel wird eine API-Anfrage verwendet, um eine Geofence-Sammlung namens zu erstellenExampleGeofenceCollection. Die Geofence-Sammlung ist einem vom Kunden verwalteten AWS KMS Schlüssel zugeordnet, 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

So erstellen Sie eine Geofence-Sammlung mit -AWS CLIBefehlen

Verwenden Sie den create-geofence-collection-Befehl.

Im folgenden Beispiel wird ein verwendetAWS CLI, um eine Geofence-Sammlung namens zu erstellenExampleGeofenceCollection. Die Geofence-Sammlung ist einem vom Kunden verwalteten AWS KMS Schlüssel zugeordnet, 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 Fakturierung hängt von Ihrer Nutzung ab. Möglicherweise fallen Gebühren für die Nutzung anderer -AWSServices an. Weitere Informationen finden Sie unter Amazon Location Service – Preise.

Geofences entwerfen

Nachdem Sie Ihre Geofence-Sammlung erstellt haben, können Sie Ihre Geofences definieren. Geofences sind entweder als Polygon oder als Kreis definiert. Um ein Polygon-Geofence zu zeichnen, können Sie ein GeoJSON-bearbeitungstool 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 ein Geofence erstellen möchten, das benachrichtigt wird, wenn ein Gerät innerhalb von 50 Metern von einem bestimmten Standort kommt, würden Sie den Breiten- und Längengrad dieses Standorts verwenden und den Radius als 50 Meter angeben.

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

Hinzufügen von Polygon-Geofences

In diesem Abschnitt wird das Erstellen von Polygon-Geofences beschrieben

Zeichnen von Geofences mit einem GeoJSON-Tool

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

So erstellen Sie eine GeoJSON-Datei

  1. Öffnen Sie ein GeoJSON-bearbeitungstool. Zum Beispiel geojson.io.

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

  3. Wählen Sie Speichern und dann GeoJSON aus dem Dropdown-Menü aus.

GeoJSON-Geofences in eine Geofence-Sammlung einfügen

Sie können die resultierende GeoJSON-Datei verwenden, um Ihre Geofences über die Amazon Location Service-Konsole, die AWS CLIoder die Amazon Location APIs hochzuladen:

Console

So fügen Sie einer Geofence-Sammlung mithilfe der Amazon Location Service-Konsole ein Geofence hinzu

  1. Öffnen Sie die Amazon Location 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 Geofence-Sammlungen den Namenslink für die Ziel-Geofence-Sammlung aus.

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

  5. Ziehen Sie im Fenster Geofences hinzufügen Ihre GeoJSON 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 die -PutGeofenceOperation aus den Amazon Location Geofences APIs .

Im folgenden Beispiel wird eine API-Anfrage verwendet, um ein Geofence mit der ID GEOFENCE-EXAMPLE1 zu einer Geofence-Sammlung namens hinzuzufügenExampleGeofenceCollection. Sie gibt auch eine einzelne Geofence-Metadateneigenschaft mit dem Schlüssel Type und dem Wert anloadingArea.

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 -BatchPutGeofenceOperation mehr als einen Geofence hinzufügen. 

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 AWS CLI Befehlen einen Geofence hinzu

Verwenden Sie den put-geofence-Befehl.

Im folgenden Beispiel wird ein verwendetAWS CLI, um einen Geofence zu einer Geofence-Sammlung namens hinzuzufügenExampleGeofenceCollection.

$ 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 Zirkelgeofences

In diesem Abschnitt wird das Erstellen von Zirkelgeofences beschrieben. Sie müssen den Breiten- und Längengrad des Punktes kennen, der das Zentrum des Kreises sein soll, sowie den Radius in Metern des Kreises. Sie können Zirkelgeofences mit den Amazon Location APIs oder erstellenAWS CLI.

API

So fügen Sie Zirkelgeofences mithilfe der Amazon Location APIs hinzu

Verwenden Sie die -PutGeofenceOperation aus den Amazon Location Geofences APIs .

Im folgenden Beispiel wird eine API-Anfrage verwendet, um ein Geofence mit der ID GEOFENCE-EXAMPLE2 zu einer Geofence-Sammlung namens hinzuzufügenExampleGeofenceCollection:

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE2
    Content-type: application/json
    
    {
       "Geometry": { 
          "Circle": {   
            "Center": [-5.716667, -15.933333],
            "Radius": 50
          }
       }
    }
AWS CLI

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

Verwenden Sie den put-geofence-Befehl.

Im folgenden Beispiel wird ein verwendetAWS CLI, um einen Geofence zu einer Geofence-Sammlung namens hinzuzufügenExampleGeofenceCollection.

$ 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 Geometrien auch in eine eigene Datei einfügen, wie im folgenden Beispiel.

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

In dem Beispiel enthält die Datei „circ.json“ JSON für die Kreisgeometrie.

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