Ajoutez des géofences avec Amazon Location - Amazon Location Service
Création d'une collection de géofencesDessiner des géofencesAjouter des géofences polygonalesAjouter des géofences circulaires

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ajoutez des géofences avec Amazon Location

Les géofences contiennent des points et des sommets qui forment une limite fermée, qui définit une zone d'intérêt. Les collections Geofence stockent et gèrent une ou plusieurs géofences.

Les collections de géofences Amazon Location stockent les géofences définies à l'aide d'un format de données géospatiales standard appelé Geo (7946). JSON RFC Vous pouvez utiliser gratuitement des outils tels que geojson.io pour dessiner graphiquement vos géofences et enregistrer le fichier géographique de sortie. JSON

Note

Amazon Location ne prend pas en charge les polygones comportant des trous, les polygones multipolygones, les polygones dans le sens des aiguilles d'une montre et les géofences qui traversent l'antiméridien.

Création d'une collection de géofences

Créez une collection de géofences pour stocker et gérer les géofences à l'aide de la console Amazon Location, du AWS CLI ou de l'Amazon Location. APIs

Console

Pour créer une collection de géofences à l'aide de la console Amazon Location

  1. Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/.

  2. Dans le volet de navigation de gauche, choisissez Geofence collections.

  3. Choisissez Créer une collection de géofences.

  4. Remplissez les cases suivantes :

    • Nom — Entrez un nom unique. Par exemple, ExampleGeofenceCollection. 100 caractères maximum. Les entrées valides incluent les caractères alphanumériques, les traits d'union, les points et les traits de soulignement.

    • Description — Entrez une description facultative pour différencier vos ressources.

  5. Dans le cadre d'une EventBridge règle avec CloudWatch comme cible, vous pouvez créer une EventBridge règle facultative pour commencer à réagir aux événements de géofence. Cela permet à Amazon Location de publier des événements sur Amazon CloudWatch Logs.

  6. (Facultatif) Sous Tags (Balises), entrez des paramètres Key (Clé) et Value (Valeur) de balise. Cela ajoute un tag à votre nouvelle collection de géofences. Pour de plus amples informations, veuillez consulter Marquez vos ressources Amazon Location Service.

  7. (Facultatif) Sous Chiffrement de clé géré par le client, vous pouvez choisir d'ajouter une clé gérée par le client. Cela ajoute une clé symétrique gérée par le client que vous créez, détenez et gérez par rapport au chiffrement AWS détenu par défaut. Pour plus d'informations, consultez la section Chiffrement des données au repos.

  8. Choisissez Créer une collection de géofences.

API

Pour créer une collection de géofences à l'aide d'Amazon Location APIs

Utilisez l'CreateGeofenceCollectionopération depuis Amazon Location GeofencesAPIs.

L'exemple suivant utilise une API demande pour créer une collection de géofences appelée ExampleGeofenceCollection. La collection Geofence est associée à une AWS KMS clé gérée par le client pour chiffrer les données du client.

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

Pour créer une collection de géofences à l'aide de commandes AWS CLI

Utilisez la commande create-geofence-collection.

L'exemple suivant utilise un AWS CLI pour créer une collection de géofences appelée ExampleGeofenceCollection. La collection Geofence est associée à une AWS KMS clé gérée par le client pour chiffrer les données du client.

aws location \
  create-geofence-collection \
  --collection-name "ExampleGeofenceCollection" \
  --description "Shopping center geofence collection" \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" \
  --tags Tag1=Value1
Note

La facturation dépend de votre utilisation. L'utilisation d'autres AWS services peut entraîner des frais. Pour plus d'informations, consultez la tarification d'Amazon Location Service.

Dessiner des géofences

Maintenant que vous avez créé votre collection de géofences, vous pouvez définir vos géofences. Les géofences sont définies sous la forme d'un polygone ou d'un cercle. Pour dessiner une géofence polygonale, vous pouvez utiliser un outil d'JSONédition géographique, tel que geojson.io.

Pour créer une clôture géographique sous forme de cercle, vous devez définir le point central du cercle et le rayon. Par exemple, si vous souhaitez créer une clôture géographique pour être averti chaque fois qu'un appareil se trouve à moins de 50 mètres d'un emplacement spécifique, vous devez utiliser la latitude et la longitude de cet emplacement et spécifier un rayon de 50 mètres.

À l'aide d'Amazon Location ServiceAPIs, vous pouvez également ajouter des métadonnées à votre géofence, sous la forme de paires clé-valeur. Ils peuvent être utiles pour stocker des informations sur la géofence, telles que son type, ou d'autres informations spécifiques à votre application. Vous pouvez utiliser ces métadonnées lorsqueRéagir aux événements d'Amazon Location Service avec Amazon EventBridge.

Ajouter des géofences polygonales

Cette section décrit la création de géofences polygonales

Dessinez des géofences à l'aide d'un outil de géolocalisation JSON

Maintenant que vous avez créé votre collection de géofences, vous pouvez définir vos géofences à l'aide d'un outil d'JSONédition géographique, tel que geojson.io.

Pour créer un fichier géographique JSON

  1. Ouvrez un outil de JSON géo-édition. Par exemple, geojson.io.

  2. Choisissez l'icône Dessiner un polygone et dessinez votre zone d'intérêt.

  3. Choisissez Enregistrer, puis sélectionnez Geo dans le JSON menu déroulant.

Placer les géofences dans JSON une collection de géofences

Vous pouvez utiliser le JSON fichier géographique obtenu pour charger vos géofences à l'aide de la console Amazon Location Service AWS CLI, du ou de l'Amazon Location : APIs

Console

Pour ajouter une clôture géographique à une collection de géofences à l'aide de la console Amazon Location Service

  1. Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/.

  2. Dans le volet de navigation de gauche, choisissez Geofence collections.

  3. Dans la liste des collections Geofence, sélectionnez le lien du nom de la collection Geofence cible.

  4. Sous Geofences, choisissez Create Geofences.

  5. Dans la fenêtre Ajouter des géofences, faites glisser et déposez votre zone géographique JSON dans la fenêtre.

  6. Choisissez Ajouter des géofences.

API

Pour ajouter des barrières géographiques à l'aide d'Amazon Location APIs

Utilisez l'PutGeofenceopération depuis Amazon Location GeofencesAPIs.

L'exemple suivant utilise une API demande pour ajouter une clôture géographique en fonction de l'ID GEOFENCE-EXAMPLE1 vers une collection de géofences appelée ExampleGeofenceCollection. Il spécifie également une propriété de métadonnées de géofence unique avec la clé Type et la valeur. 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]
            ]
          ]
       }
    }

Vous pouvez également ajouter plusieurs barrières géographiques à l'aide de cette opération. 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

Pour ajouter une clôture géographique à une collection de barrières géographiques à l'aide de commandes AWS CLI

Utilisez la commande put-geofence.

L'exemple suivant utilise un AWS CLI pour ajouter une clôture géographique à une collection de géofences appelée 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"
    }

Ajouter des géofences circulaires

Cette section décrit la création de géofences circulaires. Vous devez connaître la latitude et la longitude du point que vous souhaitez placer au centre du cercle, ainsi que le rayon en mètres du cercle. Vous pouvez créer des géofences circulaires avec l'Amazon Location APIs ou le. AWS CLI

API

Pour ajouter des géofences circulaires à l'aide d'Amazon Location APIs

Utilisez l'PutGeofenceopération depuis Amazon Location GeofencesAPIs.

L'exemple suivant utilise une API demande pour ajouter une clôture géographique en fonction de l'ID GEOFENCE-EXAMPLE2 vers une collection de géofences appelée ExampleGeofenceCollection:

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

Pour ajouter une géofence circulaire à une collection de géofences à l'aide de commandes AWS CLI

Utilisez la commande put-geofence.

L'exemple suivant utilise un AWS CLI pour ajouter une clôture géographique à une collection de géofences appelée ExampleGeofenceCollection.

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

Vous pouvez également placer JSON une géométrie complexe dans son propre fichier, comme dans l'exemple suivant.

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

Dans l'exemple, le fichier circle.json inclut JSON la géométrie du cercle.

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