View a markdown version of this page

Ajoutez des géofences avec Amazon Location - Amazon Location Service
Création d’une collection de périmètres virtuelsDessiner 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 des géofences définies à l'aide d'un format de données géospatiales standard appelé GeoJSON (RFC 7946). Vous pouvez utiliser gratuitement des outils tels que geojson.io pour dessiner graphiquement vos géofences et enregistrer le fichier GeoJSON de sortie.

Note

Amazon Location ne prend pas en charge les polygones dans le sens des aiguilles d'une montre (utilisez l'ordre d'enroulement dans le sens inverse des aiguilles d'une montre, comme l'exige la RFC 7946 §3.1.6) ni les géofences qui traversent l'antiméridien (la ligne de longitude à 180°).

Création d’une collection de périmètres virtuels

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

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 plus d'informations, voir Gérer les ressources à l'aide de balises.

  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 des API Amazon Location

Utilisez l'CreateGeofenceCollectionopération depuis les API Amazon Location Geofences.

L'exemple suivant utilise une demande d'API 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 le 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'édition GeoJSON, tel que geojson.io.

Pour créer une géofence circulaire, définissez le point central à l'aide de la latitude et de la longitude de l'emplacement et définissez le rayon en mètres. Pour de plus amples informations, veuillez consulter Ajouter des géofences circulaires.

À l'aide des API Amazon Location Service, vous pouvez également ajouter des métadonnées à votre géofence sous 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éagissez aux événements du service de location Amazon avec Amazon EventBridge.

Ajouter des géofences polygonales

Les géofences polygonales utilisent des tableaux de coordonnées GeoJSON pour définir une zone. Utilisez ce format lorsque vous devez suivre les entrées ou les sorties d'une limite géographique de forme irrégulière.

Dessinez des géofences à l'aide d'un outil GeoJSON

Pour créer un fichier GeoJSON

  1. Ouvrez un outil d'édition GeoJSON, tel que geojson.io.

  2. Choisissez l'icône Dessiner un polygone et dessinez la zone qui vous intéresse.

  3. Choisissez Enregistrer, puis GeoJSON dans le menu déroulant.

Placer des géofences GeoJSON dans une collection de géofences

Vous pouvez utiliser le fichier GeoJSON obtenu pour charger vos géofences à l'aide de la console Amazon Location Service, des API Amazon Location AWS CLI ou des API Amazon Location.

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 votre fichier GeoJSON dans la fenêtre.

  6. Choisissez Ajouter des géofences.

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

Utilisez l'PutGeofenceopération depuis les API Amazon Location Geofences.

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

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 le 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]]]'

Ajouter des géofences circulaires

Pour créer une géofence circulaire, vous devez connaître la latitude et la longitude du point central ainsi que le rayon en mètres. Utilisez des géofences circulaires lorsque vous devez déclencher des événements en fonction de la proximité d'un point spécifique, tel qu'un magasin, un entrepôt ou un point de repère. Vous pouvez créer des barrières géographiques circulaires avec la console Amazon Location, les API Amazon Location ou le. AWS CLI

Console
Pour ajouter une géofence circulaire à 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, choisissez Cercle, puis entrez la latitude, la longitude et le rayon du centre en mètres.

  6. Choisissez Ajouter des géofences.

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

Utilisez l'PutGeofenceopération depuis les API Amazon Location Geofences.

L'exemple suivant utilise une demande d'API pour ajouter une clôture géographique avec l'ID GEOFENCE-EXAMPLE2 à une collection de géofences appelée. ExampleGeofenceCollection

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/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 le AWS CLI pour ajouter une géofence circulaire à 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 le JSON pour les géométries complexes dans son propre fichier, comme dans l'exemple suivant.

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

Où circle.json contient la géométrie du cercle.

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