Gestion de vos ressources de collecte de géofences

Gérez vos collections de géofences à l'aide de la console Amazon LocationAWS CLI, ou des API Amazon Location.

Répertoriez vos ressources de collecte de géofences

Vous pouvez consulter la liste de vos collections de géofences à l'aide de la console Amazon LocationAWS CLI, ou des API Amazon Location :

Console

Pour consulter la liste des collections de géofences à l'aide de la console Amazon Location

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

2. Choisissez Geofence collections dans le volet de navigation de gauche.

3. Consultez la liste de vos collections de géofences sous Mes collections de géofences.

API

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

L'exemple suivant est une demande d'API pour obtenir une liste des collections de géofences dans le AWS compte.

POST /geofencing/v0/list-collections

Voici un exemple de réponse pour ListGeofenceCollections :

{
    "Entries": [ 
    { 
        "CollectionName": "ExampleCollection",
        "CreateTime": 2020-09-30T22:59:34.142Z,
        "Description": "string",
        "UpdateTime": 2020-09-30T23:59:34.142Z
    },
    "NextToken": "1234-5678-9012"
}

CLI

Utilisez la commande list-geofence-collections.

L'exemple suivant permet d'AWS CLIobtenir une liste des collections de géofences présentes dans le AWS compte.

aws location list-geofence-collections

Obtenez les détails de la collection Geofence

Vous pouvez obtenir des informations sur n'importe quelle ressource de collecte de géofences de votre AWS compte à l'aide de la console Amazon LocationAWS CLI, ou des API Amazon Location :

Console

Pour consulter les détails d'une collection de géofences à l'aide de la console Amazon Location

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

2. Choisissez Geofence collections dans le volet de navigation de gauche.

3. Sous Mes collections de géofences, sélectionnez le lien du nom de la collection de géofences cible.

API

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

L'exemple suivant est une demande d'API pour obtenir les détails de la collection Geofence pour. ExampleCollection

GET /geofencing/v0/collections/ExampleCollection

Voici un exemple de réponse pour DescribeGeofenceCollection :

{
    "CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
    "CollectionName": "ExampleCollection",
    "CreateTime": 2020-09-30T22:59:34.142Z,
    "Description": "string",
    "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "Tags": { 
        "Tag1" : "Value1"
    },
    "UpdateTime": 2020-09-30T23:59:34.142Z
}

CLI

Utilisez la commande describe-geofence-collection.

L'exemple suivant permet d'AWS CLIobtenir les détails de la collecte de géofences pour. ExampleCollection

aws location describe-geofence-collection \
    --collection-name "ExampleCollection"

Supprimer une collection de géofences

Vous pouvez supprimer une collection de géofences de votre AWS compte à l'aide de la console Amazon LocationAWS CLI, ou des API Amazon Location.

Console

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

Avertissement

Cette opération supprime définitivement la ressource.

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

2. Choisissez Geofence collections dans le volet de navigation de gauche.

3. Sous Ma collection de géofences, sélectionnez la collection de géofences cible.

4. Choisissez Supprimer la collection de géofences.

API

Utilisez l'DeleteGeofenceCollectionopération depuis les API Amazon Location.

L'exemple suivant est une demande d'API pour supprimer la collection Geofence. ExampleCollection

DELETE /geofencing/v0/collections/ExampleCollection

Voici un exemple de réponse pour DeleteGeofenceCollection :

HTTP/1.1 200

CLI

Utilisez la commande delete-geofence-collection.

L'exemple suivant est une AWS CLI commande permettant de supprimer la collection Geofence. ExampleCollection

aws location delete-geofence-collection \
    --collection-name "ExampleCollection"

Répertorier les géofences stockées

Vous pouvez répertorier les géofences stockées dans une collection de géofences spécifiée à l'aide de la console Amazon Location, AWS CLI ou des API Amazon Location.

Console

Pour consulter la liste des géofences à l'aide de la console Amazon Location

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

2. Choisissez Geofence collections dans le volet de navigation de gauche.

3. Sous Ma collection de géofences, sélectionnez le lien du nom de la collection de géofences cible.

4. Afficher les géofences dans la collection Geofences sous Geofences

API

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

L'exemple suivant est une demande d'API pour obtenir une liste des géofences stockées dans la collection de géofences. ExampleCollection

POST /geofencing/v0/collections/ExampleCollection/list-geofences

Voici un exemple de réponse pour ListGeofences :

{
   "Entries": [ 
      { 
         "CreateTime": 2020-09-30T22:59:34.142Z,
         "GeofenceId": "geofence-1",
         "Geometry": { 
             "Polygon": [            
                 [-5.716667, -15.933333,
                 [-14.416667, -7.933333],
                 [-12.316667, -37.066667],
                 [-5.716667, -15.933333]
             ]
         },
         "Status": "ACTIVE",
         "UpdateTime": 2020-09-30T23:59:34.142Z
      }
   ],
   "NextToken": "1234-5678-9012"
}

CLI

Utilisez la commande list-geofences.

L'exemple suivant permet d'AWS CLIobtenir une liste des géofences stockées dans la collection de géofences. ExampleCollection

aws location list-geofences \
    --collection-name "ExampleCollection"

Obtenez des informations sur les géofences

Vous pouvez obtenir les détails d'une géofence spécifique, tels que l'heure de création, l'heure de mise à jour, la géométrie et le statut, à partir d'une collection de géofences à l'aide de la console Amazon Location AWS CLI ou des API Amazon Location.

Console

Pour consulter l'état d'une clôture géographique à l'aide de la console Amazon Location

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

2. Choisissez Geofence collections dans le volet de navigation de gauche.

3. Sous Ma collection de géofences, sélectionnez le lien du nom de la collection de géofences cible.

4. Sous Geofences, vous pourrez consulter l'état de vos géofences.

API

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

L'exemple suivant est une demande d'API pour obtenir les détails de la géofence à partir d'une collection de géofences. ExampleCollection

GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1

Voici un exemple de réponse pour GetGeofence :

{
   "CreateTime": 2020-09-30T22:59:34.142Z,
   "GeofenceId": "ExampleGeofence1",
   "Geometry": { 
      "Polygon": [            
          [-1,-1],
          [1,-1],
          [0,1],
          [-1,-1] 
      ]
   },
   "Status": "ACTIVE",
   "UpdateTime": 2020-09-30T23:59:34.142Z
}

CLI

Utilisez la commande get-geofence.

L'exemple suivant permet d'AWS CLIobtenir les détails de la collecte de géofences pour. ExampleCollection

aws location get-geofence \
    --collection-name "ExampleCollection" \
    --geofence-id "ExampleGeofence1"

Supprimer les géofences

Vous pouvez supprimer des géofences d'une collection de géofences à l'aide de la console Amazon Location, AWS CLI ou des API Amazon Location.

Console

Pour supprimer une barrière géographique à l'aide de la console Amazon Location

Avertissement

Cette opération supprime définitivement la ressource.

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

2. Choisissez Geofence collections dans le volet de navigation de gauche.

3. Sous Ma collection de géofences, sélectionnez le lien du nom de la collection de géofences cible.

4. Sous Geofences, sélectionnez la géofence cible.

5. Choisissez Supprimer la géofence.

API

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

L'exemple suivant est une demande d'API pour supprimer les géofences de la collection de géofences. ExampleCollection

POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json

{
   "GeofenceIds": [ "ExampleGeofence11" ]
}

Voici un exemple de réponse positive pourBatchDeleteGeofence.

HTTP/1.1 200

CLI

Utilisez la commande batch-delete-geofence.

L'exemple suivant est une AWS CLI commande permettant de supprimer les géofences de la collection de géofences. ExampleCollection

aws location batch-delete-geofence \
    --collection-name "ExampleCollection" \
    --geofence-ids "ExampleGeofence11"