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.
# Géofences du service de localisation Amazon
![\[Présentation des géofences d'Amazon Location Service.\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/images/geofences-overview.png)
Les ressources de collecte de géofences vous permettent de stocker et de gérer des géofences, c'est-à-dire des limites virtuelles sur une carte. Vous pouvez évaluer les emplacements par rapport à une ressource de collecte de géofences et recevoir des notifications lorsque la mise à jour de localisation franchit les limites de l'une des géofences de la collection.
**Geofences et collecte de géofences**
Une clôture géographique est une géométrie circulaire, polygonale ou multipolygonale qui définit une limite virtuelle sur une carte. Une collection de géofences contient zéro ou plusieurs géofences. Il est capable de surveiller les géofences en émettant `ENTER` des `EXIT` événements, sur demande, pour évaluer la position d'un appareil par rapport à ses géofences.
**Événements Geofence**
Les emplacements des positions que vous surveillez sont référencés par un identifiant appelé `DeviceId` a. Les positions sont appelées positions de l'appareil. Vous pouvez envoyer une liste des positions des appareils à évaluer directement à la ressource de collecte de géofences, ou vous pouvez utiliser un traceur. Pour plus d'informations sur l'utilisation des traceurs, consultez[Appareils de suivi Amazon Location Service](trackers.md).
Vous recevez des événements (via Amazon EventBridge) uniquement lorsqu'un appareil entre ou sort d'une géofence, et non pour chaque changement de position. Cela signifie que vous recevrez généralement des événements et que vous devrez y répondre beaucoup moins fréquemment qu'à chaque mise à jour de la position de l'appareil.
**Note**
Pour la première évaluation de l'emplacement d'un appareil spécifique`DeviceID`, il est supposé que l'appareil ne se trouvait auparavant dans aucune zone géographique. Ainsi, la première mise à jour générera un `ENTER` événement, s'il se trouve à l'intérieur d'une barrière géographique de la collection, et aucun événement dans le cas contraire.
Afin de calculer si un appareil est entré dans une barrière géographique ou en est sorti, Amazon Location Service doit conserver l'état de position précédent de l'appareil. Cet état de position est conservé pendant 30 jours. Après 30 jours sans mise à jour pour un appareil, une nouvelle mise à jour de localisation sera traitée comme la première mise à jour de position.
## Cas d'utilisation des géofences d'Amazon Location Service
Voici quelques utilisations courantes des géofences d'Amazon Location Service.
**Améliorez les opérations de service sur le terrain**
Gardez le pouls de votre personnel mobile grâce au suivi en temps réel. Définissez des barrières géographiques autour des sites clients et des zones de service pour recevoir des alertes à l'arrivée et au départ du personnel. Utilisez les données de localisation pour optimiser la planification, envoyer le technicien disponible le plus proche et réduire les temps de réponse. Donnez à vos équipes de terrain (comme votre entreprise de plomberie ou de réparation de systèmes CVC) les moyens de travailler plus efficacement, tout en améliorant l'expérience client.
**Surveillez et contrôlez les actifs critiques**
Utilisez Amazon Location Service pour suivre l'emplacement et l'état en temps réel de vos précieux équipements, stocks et autres actifs mobiles. Configurez des barrières géographiques pour recevoir des alertes en cas de mouvements ou de suppressions non autorisés, renforçant ainsi la sécurité et la conformité. Utilisez cette visibilité de localisation pour améliorer l'utilisation des actifs, optimiser les calendriers de maintenance et vous assurer que vos ressources critiques sont prises en compte à tout moment. Surveillez toujours votre machinerie lourde, votre matériel informatique ou vos stocks de détail avec précision, réduisez les pertes et prenez des décisions opérationnelles plus éclairées.
**Améliorez la visibilité de la chaîne d'approvisionnement**
Tirez parti d'Amazon Location Service pour suivre les expéditions et les livraisons sur l'ensemble de votre chaîne d'approvisionnement. Définissez des barrières géographiques autour des centres de distribution, des magasins et d'autres installations clés pour surveiller le mouvement des stocks et des actifs. Utilisez les données de localisation en temps réel pour améliorer la gestion des stocks, optimiser la planification logistique et offrir une expérience client supérieure. Gagnez en end-to-end visibilité sur les opérations de votre chaîne d'approvisionnement, identifiez les goulets d'étranglement et prenez des décisions basées sur les données qui favorisent l'efficacité et la réactivité.
**Renforcer la sûreté et la sécurité**
Le géofencing vous permet de définir des limites virtuelles autour de zones sécurisées, de zones restreintes et d'autres emplacements critiques. Recevez des alertes instantanées lorsque du personnel ou des actifs non autorisés entrent ou sortent de ces géofences prédéfinies. Tirez parti de cette surveillance de localisation en temps réel pour améliorer la sécurité sur le lieu de travail, prévenir les intrusions et garantir le respect des réglementations. Que vous gériez une usine de fabrication, un chantier de construction ou un campus d'entreprise, le géofencing vous permet de contrôler plus étroitement l'accès, d'améliorer la réponse aux incidents et de protéger votre personnel, vos biens et vos actifs.
**Marketing basé sur la localisation**
Exploitez le potentiel des données de localisation pour dynamiser vos efforts de géomarketing. Utilisez Amazon Location Service pour définir des limites virtuelles autour des sites concurrents, des événements et des zones à fort trafic. Déclenchez des publicités, des offres et des notifications personnalisées lorsque les clients entrent dans ces zones géo-clôturées. Analysez les modèles de trafic piétonnier afin d'optimiser les emplacements publicitaires et de découvrir des sites de premier choix pour les nouveaux sites commerciaux. Surveillez les mouvements des clients dans vos propres espaces géofencés pour obtenir des informations plus approfondies sur les comportements de navigation et. path-to-purchase Combinez le suivi de localisation en temps réel avec le géofencing de précision pour proposer un engagement contextuel hyperciblé qui stimule les ventes et la fidélité dans le monde physique.
# Concepts de géofence
Cette section décrit certains concepts courants de géofences, notamment la terminologie courante et la façon de gérer les géofences.
## Terminologie de géofence d'Amazon Location Service
Geofence
Limite virtuelle d'une zone géographique sur une carte.
Collection Geofence
Groupe de géofences capable d'émettre `Entry` des `Exit` événements, sur demande, pour évaluer la position d'un appareil par rapport aux géofences qui le composent.
Géométrie Geofence
Forme géométrique ou ensemble de formes qui définissent les zones à inclure ou à exclure d'une géofence. La géométrie d'une géofence peut être représentée par un `Circle``Polygon`, ou. `MultiPolygon`
A `Circle` est un point entouré d'une distance. Utilisez un cercle lorsque vous souhaitez être averti si un appareil se trouve à une certaine distance d'une position.
A `Polygon` est une liste d'anneaux linéaires qui représentent la forme d'une clôture géographique. Cette liste *doit* inclure un anneau extérieur représentant le périmètre extérieur de la géofence, et peut éventuellement inclure plusieurs anneaux intérieurs représentant des espaces polygonaux à l'intérieur du périmètre, qui sont exclus de la zone de géofence.
A `MultiPolygon` est une liste d'`Polygon`éléments représentant la forme d'une clôture géographique. Les `Polygon` composants d'une `MultiPolygon` géométrie peuvent définir des zones géographiques distinctes considérées comme faisant partie de la même géofence, des périmètres de zones extérieures plus grandes avec des espaces intérieurs plus petits qui sont exclus de la géofence, ou une combinaison de ces cas d'utilisation pour former des limites de géofence complexes.
Pour plus d'informations sur la définition des géométries de géofence, notamment les exigences syntaxiques, les limites et les exemples, consultez [GeofenceGeometry](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html)le manuel Amazon *Location Service API Reference*.
# Commencez avec Amazon Location Service Geofences
Les géofences sont de puissants outils permettant de définir des limites géographiques et de déclencher des actions en fonction des mises à jour de localisation. Ce guide explique le processus de création et d'utilisation des ressources de collecte de géofences dans Amazon Location. En configurant des barrières géographiques et en évaluant les emplacements par rapport à celles-ci, vous pouvez surveiller les mouvements et générer des événements automatisés, tels que des notifications lorsqu'un appareil entre ou sort d'une zone définie. Ces fonctionnalités sont idéales pour les applications telles que le suivi de flotte, les notifications basées sur la localisation, etc.
1. Créez une ressource de collecte de géofences dans votre AWS compte.
1. Ajoutez des géofences à la collection. Vous pouvez utiliser l'outil de téléchargement de géofences sur la console Amazon Location ou l'API Amazon Location Geofences. Pour plus d'informations sur les options disponibles, consultez [Authentifiez-vous auprès d'Amazon Location Service](access.md). Une géofence peut être définie comme un `Circle``Polygon`, ou. `MultiPolygon` Utilisez un `Polygon` ou `MultiPolygon` pour déterminer à quel moment un appareil entre dans une zone spécifique. Utilisez a `Circle` pour déterminer à quel moment un appareil se trouve à une certaine distance (rayon) d'un point. Pour plus d'informations, consultez la terminologie [relative aux géofences d'Amazon Location Service](https://docs.aws.amazon.com/location/latest/developerguide/geofence-components.html#geofence-terminology).
1. Vous pouvez commencer à évaluer les emplacements par rapport à toutes vos barrières géographiques. Lorsqu'une mise à jour de localisation franchit les limites d'une ou de plusieurs géofences, votre ressource de collecte de géofences émet l'un des types d'événements de géofences suivants sur Amazon : EventBridge
+ **ENTER** — Un événement est généré pour chaque géofence lorsque la mise à jour de localisation franchit ses limites en la saisissant.
+ **SORTIE** — Un événement est généré pour chaque géofence lorsque la mise à jour de localisation franchit ses limites en la quittant.
Pour de plus amples informations, veuillez consulter [Réagissez aux événements du service de location Amazon avec Amazon EventBridge](location-events.md). Vous pouvez également intégrer la surveillance à l'aide de services tels qu'Amazon CloudWatch et AWS CloudTrail. Pour plus d'informations, voir [Surveillez avec Amazon CloudWatch](cloudwatch.md) et[Surveillez et connectez-vous avec AWS CloudTrail](cloudtrail.md).
Par exemple, vous suivez une flotte de camions et souhaitez être averti lorsqu'un camion arrive dans une certaine zone de l'un de vos entrepôts. Créez une géofence pour la zone autour de chaque entrepôt. Lorsque les camions vous envoient des positions mises à jour, utilisez Amazon Location Service pour évaluer ces positions et voir si un camion est entré (ou sorti) de l'une des zones de géolocalisation.
**Note**
Vous êtes facturé en fonction du nombre de collections de géofences par rapport auxquelles vous évaluez. Votre facture n'est pas affectée par le nombre de géofences dans chaque collection. Étant donné que chaque collection de géofences peut contenir jusqu'à 50 000 géofences, vous souhaiterez peut-être combiner vos géofences en un moins grand nombre de collections, dans la mesure du possible, afin de réduire le coût des évaluations de géofences. Les événements générés incluront l'ID de la géofence individuelle de la collection, ainsi que l'ID de la collection.
# Comment utiliser les géofences d'Amazon Location Service
Cette section fournit des step-by-step conseils pour travailler avec des tâches liées à la géolocalisation dans Amazon Location. Découvrez comment évaluer la position des appareils par rapport aux géofences, répondre aux événements liés aux géofences à l'aide d'Amazon et gérer efficacement vos EventBridge ressources de géofences. Ces didacticiels sont conçus pour vous aider à implémenter des fonctionnalités clés permettant de suivre et de gérer facilement les événements géolocalisés.
**Topics**
+ [Évaluez la position des appareils par rapport aux géofences](evaluate-geofences.md)
+ [Réagissez aux événements du service de location Amazon avec Amazon EventBridge](location-events.md)
+ [Gérez vos ressources de collecte de géofences](managing-geofence-collections.md)
# Évaluez la position des appareils par rapport aux géofences
Il existe deux méthodes pour évaluer les positions par rapport aux géofences afin de générer des événements de géofences :
+ Vous pouvez lier les trackers aux collections Geofence. Pour plus d'informations, consultez la section :[Associer un traceur à une collection de géofences](associate-consumer.md).
+ Vous pouvez faire une demande directe à la ressource de collecte de géofences pour évaluer une ou plusieurs positions.
Si vous souhaitez également suivre l'historique des positions de votre appareil ou afficher des positions sur une carte, associez le traceur à une collection de géofences. Il se peut également que vous ne souhaitiez pas évaluer toutes les mises à jour de localisation ou que vous n'ayez pas l'intention de stocker les données de localisation dans une ressource de suivi. Dans l'un ou l'autre cas, vous pouvez adresser une demande directe à la collection de géofences et évaluer la position d'un ou de plusieurs appareils par rapport à ses géofences.
L'évaluation de la position des appareils par rapport aux géofences génère des événements. Vous pouvez réagir à ces événements et les rediriger vers d'autres AWS services. Pour plus d'informations sur les mesures que vous pouvez prendre lorsque vous recevez des événements de géofence, consultez [Réagir aux événements Amazon Location Service with Amazon](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html). EventBridge
Un événement Amazon Location inclut les attributs de la mise à jour de position de l'appareil qui le génère, notamment l'heure, la position, la précision et les métadonnées des valeurs clés, ainsi que certains attributs de la barrière géographique saisie ou sortie. Pour plus d'informations sur les données incluses dans un événement de géofence, consultez. [Exemples EventBridge d'événements Amazon pour Amazon Location Service](location-events.md#example-event)
Les exemples suivants utilisent le AWS CLI, ou l'emplacement Amazon APIs.
------
#### [ API ]
**Pour évaluer la position des appareils par rapport à la position des barrières géographiques à l'aide d'Amazon Location APIs**
Utilisez l'`[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)`opération depuis Amazon Location Geofences APIs.
L'exemple suivant utilise une demande d'API pour évaluer la position de l'appareil dans une *ExampleDevice* collection de géofences associée. *ExampleGeofenceCollection* Remplacez ces valeurs par votre propre géofence et votre propre appareil. IDs
```
POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json
{
"DevicePositionUpdates": [
{
"DeviceId": "ExampleDevice",
"Position": [-123.123, 47.123],
"SampleTime": "2021-11-30T21:47:25.149Z",
"Accuracy": {
"Horizontal": 10.30
},
"PositionProperties": {
"field1": "value1",
"field2": "value2"
}
}
]
}
```
------
#### [ AWS CLI ]
**Pour évaluer la position des appareils par rapport à la position des barrières géographiques à l'aide de commandes AWS CLI **
Utilisez la commande `[batch-evaluate-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`.
L'exemple suivant utilise un AWS CLI pour évaluer la position de par *ExampleDevice* rapport à une collection de géofences associée. *ExampleGeofenceCollection* Remplacez ces valeurs par votre propre géofence et votre propre appareil. IDs
```
aws location \
batch-evaluate-geofences \
--collection-name ExampleGeofenceCollection \
--device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```
------
# Réagissez aux événements du service de location Amazon avec Amazon EventBridge
Amazon EventBridge est un bus d'événements sans serveur qui connecte efficacement les applications entre elles à l'aide de données provenant de AWS services tels qu'Amazon Location. EventBridge reçoit les événements d'Amazon Location et achemine ces données vers des cibles telles que AWS Lambda. Vous pouvez configurer des règles de routage pour déterminer où envoyer vos données afin de créer des architectures d'applications qui réagissent en temps réel.
Seuls les événements de géofence (`ENTER`et les `EXIT` événements lorsque les appareils entrent ou sortent des zones géo-clôturées) sont envoyés par défaut. EventBridge Vous pouvez également activer tous les événements de mise à jour de position filtrés pour une ressource de suivi. Pour de plus amples informations, veuillez consulter [Activer les événements de mise à jour pour un tracker](#enable-update-events).
Pour plus d'informations, consultez [les événements et les modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) *du guide de EventBridge l'utilisateur Amazon*.
**Topics**
+ [Activer les événements de mise à jour pour un tracker](#enable-update-events)
+ [Création de règles d'événement pour Amazon Location](#create-event-rule)
+ [Exemples EventBridge d'événements Amazon pour Amazon Location Service](#example-event)
## Activer les événements de mise à jour pour un tracker
Par défaut, Amazon Location envoie uniquement des événements `ENTER` et `EXIT` géofence à. EventBridge Vous pouvez activer tous les `UPDATE` événements de position filtrés auxquels un tracker doit être envoyé EventBridge. Vous pouvez le faire lorsque vous [créez](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) ou [mettez à jour](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) un tracker.
Par exemple, pour mettre à jour un outil de suivi existant à l'aide de AWS CLI, vous pouvez utiliser la commande suivante (utilisez le nom de votre ressource de suivi à la place de*MyTracker*).
```
aws location update-tracker --tracker-name MyTracker --event-bridge-enabled
```
Pour désactiver les événements de position pour un tracker, vous devez utiliser l'API ou la console Amazon Location Service.
## Création de règles d'événement pour Amazon Location
Vous pouvez créer [jusqu'à 300 règles par événement dans le bus](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-quota.html) EventBridge pour configurer les actions entreprises en réponse à un événement Amazon Location.
Par exemple, vous pouvez créer une règle pour les événements de géolocalisation selon laquelle une notification push sera envoyée lorsqu'un téléphone est détecté à l'intérieur d'une limite de géolocalisation.
**Pour créer une règle pour les événements Amazon Location**
À l'aide des valeurs suivantes, [créez une EventBridge règle](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-visual.html) basée sur les événements Amazon Location :
+ Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.
+ Dans la zone **Modèle d'événement**, ajoutez le modèle suivant :
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"]
}
```
Pour créer une règle pour les mises à jour de la position du tracker, vous pouvez plutôt utiliser le modèle suivant :
```
{
"source": ["aws.geo"],
"detail-type": ["Location Device Position Event"]
}
```
Vous pouvez éventuellement spécifier uniquement `ENTER` `EXIT` des événements en ajoutant un `detail` tag (si votre règle concerne les mises à jour de la position du tracker, il n'y en a qu'un seul`EventType`, il n'est donc pas nécessaire de filtrer sur celui-ci) :
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"]
}
}
```
Vous pouvez également éventuellement filtrer sur les propriétés de la position ou de la géofence :
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"],
"GeofenceProperties": {
"Type": "LoadingDock"
},
"PositionProperties": {
"VehicleType": "Truck"
}
}
}
```
+ Pour **Select targets**, choisissez l'action cible à effectuer lorsqu'un événement est reçu d'Amazon Location Service.
Par exemple, utilisez une rubrique Amazon Simple Notification Service (SNS) pour envoyer un e-mail ou un SMS lorsqu'un événement se produit. Vous devez d’abord créer une rubrique Amazon SNS à l’aide de la console Amazon SNS. Pour plus d'informations, consultez la section [Utilisation d'Amazon SNS pour les notifications aux utilisateurs](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html).
**Avertissement**
Il est recommandé de vérifier que la règle de l'événement a été correctement appliquée, faute de quoi votre action automatisée risque de ne pas démarrer comme prévu. Pour vérifier votre règle d'événement, initiez les conditions de la règle d'événement. Par exemple, simulez l'entrée d'un appareil dans une zone géo-clôturée.
Vous pouvez également capturer tous les événements depuis Amazon Location, en excluant simplement la `detail-type` section. Par exemple :
```
{
"source": [
"aws.geo"
]
}
```
**Note**
Le même événement peut être organisé plusieurs fois. Vous pouvez utiliser l'identifiant d'événement pour dédupliquer les événements que vous recevez.
## Exemples EventBridge d'événements Amazon pour Amazon Location Service
Voici un exemple d'événement permettant de saisir une géofence initiée par un appel. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "636103698109",
"time": "2020-11-10T23:43:37Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "ENTER",
"GeofenceId": "polygon_14",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:43:37.531Z",
"Position": [
-123.12390073297821,
49.23433613216247
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
Voici un exemple d'événement de sortie d'une géofence initié par un appel. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "EXIT",
"GeofenceId": "polygon_10",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
Voici un exemple d'événement pour une mise à jour de position, initiée par un appel`BatchUpdateDevicePosition`.
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Device Position Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "UPDATE",
"TrackerName": "tracker_2",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"ReceivedTime": "2020-11-10T23:41:39.235Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
# Gérez vos ressources de collecte de géofences
Gérez vos collections de géofences à l'aide de la console Amazon Location AWS CLI, du ou de l'Amazon Location. APIs
## Répertoriez vos ressources de collecte de géofences
Vous pouvez consulter la liste de vos collections Geofence à l'aide de la console Amazon Location AWS CLI, du ou de l'Amazon Location : APIs
------
#### [ 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/](https://console.aws.amazon.com/location/home).
1. Choisissez **Geofence collections dans** le volet de navigation de gauche.
1. Consultez la liste de vos collections de géofences sous **Mes collections de géofences**.
------
#### [ API ]
Utilisez l'`[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)`opération depuis Amazon Location Geofences APIs.
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](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)`.
L'exemple suivant permet d' AWS CLI obtenir 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 Location AWS CLI, du ou de l'Amazon Location : APIs
------
#### [ 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/](https://console.aws.amazon.com/location/home).
1. Choisissez **Geofence collections dans** le volet de navigation de gauche.
1. Sous **Mes collections de géofences**, sélectionnez le lien du nom de la collection de géofences cible.
------
#### [ API ]
Utilisez l'`[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)`opération depuis Amazon Location Geofences APIs.
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](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)`.
L'exemple suivant permet d' AWS CLI obtenir 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 Location AWS CLI, du ou de l'Amazon Location. APIs
------
#### [ 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/](https://console.aws.amazon.com/location/home).
1. Choisissez **Geofence collections dans** le volet de navigation de gauche.
1. Sous **Ma collection de géofences, sélectionnez la collection** de géofences cible.
1. Choisissez **Supprimer la collection de géofences.**
------
#### [ API ]
Utilisez l'`[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)`opération depuis l'emplacement Amazon APIs.
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](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)`.
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, du AWS CLI ou de l'Amazon Location. APIs
------
#### [ 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/](https://console.aws.amazon.com/location/home).
1. Choisissez **Geofence collections dans** le volet de navigation de gauche.
1. Sous **Ma collection de géofences**, sélectionnez le lien du nom de la collection de géofences cible.
1. **Afficher les géofences dans la collection Geofences sous Geofences**
------
#### [ API ]
Utilisez l'`[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)`opération depuis Amazon Location Geofences APIs.
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](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)`.
L'exemple suivant permet d' AWS CLI obtenir 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 de l'Amazon Location. APIs
------
#### [ 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/](https://console.aws.amazon.com/location/home).
1. Choisissez **Geofence collections dans** le volet de navigation de gauche.
1. Sous **Ma collection de géofences**, sélectionnez le lien du nom de la collection de géofences cible.
1. Sous **Geofences**, vous pourrez consulter l'état de vos géofences.
------
#### [ API ]
Utilisez l'`[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)`opération depuis Amazon Location Geofences APIs.
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](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)`.
L'exemple suivant permet d' AWS CLI obtenir 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, du AWS CLI ou de l'Amazon Location. APIs
------
#### [ 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/](https://console.aws.amazon.com/location/home).
1. Choisissez **Geofence collections dans** le volet de navigation de gauche.
1. Sous **Ma collection de géofences**, sélectionnez le lien du nom de la collection de géofences cible.
1. Sous **Geofences**, sélectionnez la géofence cible.
1. Choisissez **Supprimer la géofence.**
------
#### [ API ]
Utilisez l'`[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`opération depuis Amazon Location Geofences APIs.
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 pour`[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`.
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilisez la commande `[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)`.
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"
```
------
# Gérez les coûts et l'utilisation
Alors que vous continuez à découvrir Amazon Location Geofences, il est important de comprendre comment gérer la capacité des services, vous assurer de respecter les limites d'utilisation et obtenir les meilleurs résultats grâce à l'optimisation des quotas et des API. En appliquant les meilleures pratiques en matière de performances et de précision, vous pouvez adapter votre application pour gérer efficacement les requêtes liées au lieu et optimiser vos demandes d'API.
**Topics**
+ [Tarification de Geofences](geofence-price.md)
+ [Quotas et utilisation de Geofences](geofence-quotas.md)
# Tarification de Geofences
Pour obtenir des informations sur les tarifs relatifs au suivi et au géofencing APIs, consultez la page de [tarification d'Amazon Location Service](https://aws.amazon.com/location/pricing/).
**Évaluation du poste**
Vous pouvez l'utiliser `BatchEvaluateGeofences` pour évaluer les positions des appareils par rapport aux géométries de géofences d'une collection de géofences donnée. Une demande évaluera jusqu'à dix positions d'appareils par rapport à toutes les géofences d'une seule collection de géofences. Le prix est basé sur le nombre de positions des appareils dans vos demandes d'API. Le prix unitaire par position d'appareil évaluée est basé sur le volume d'utilisation mensuel total. Consultez la [page de tarification d'Amazon Location Service](https://aws.amazon.com/location/pricing/) pour plus de détails sur le prix unitaire et les niveaux de volume.
Vous pouvez optimiser le coût de votre évaluation de position en configurant la fréquence de mise à jour de la position de l'appareil (également appelée taux de ping) à partir de vos appareils de suivi et en tirant parti de la fonction de filtrage des trackers pour évaluer uniquement les mises à jour de position pertinentes.
**Gestion et stockage des géofences**
Vous pouvez utiliser`GetGeofence`, `PutGeofence``BatchPutGeofence`, et `BatchDeleteGeofence` pour gérer vos géofences dans une collection de géofences. Le prix de celles-ci APIs est basé sur le nombre de géofences dans vos demandes d'API.
Le stockage des géofences sera facturé mensuellement (uniquement pour les géofences que vous stockez pendant plus d'un mois). Vous pouvez également gérer votre collection Geofence à l'aide des éléments suivants APIs :`CreateGeofenceCollection`,`DeleteGeofenceCollection`,`DescribeGeofenceCollection`, `ListGeofenceCollections``UpdateGeofenceCollection`, et. `ListGeofences` Le prix de ces applications APIs est basé sur le nombre de demandes d'API.
**Geofence Event Forecast**
Vous pouvez l'utiliser `ForecastGeofenceEvents` pour prévoir les futurs événements de géofence susceptibles de se produire dans un horizon temporel spécifié si un appareil continue de se déplacer à sa vitesse actuelle. Le prix est basé sur le nombre de demandes d'API.
# Quotas et utilisation de Geofences
Cette rubrique fournit un résumé des limites de débit et des quotas pour Amazon Location Service Geofences.
**Note**
Si vous avez besoin d'un quota plus élevé, vous pouvez utiliser la console Service Quotas pour [demander des augmentations de quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) pour des quotas ajustables. Lorsque vous demandez une augmentation de quota, sélectionnez la région dans laquelle vous souhaitez augmenter le quota, car la plupart des quotas sont spécifiques à la AWS région. Vous pouvez demander jusqu'à deux fois la limite par défaut pour chaque API.
Pour les demandes qui dépassent le double de la limite par défaut, votre demande sera soumise à un ticket d'assistance. Vous pouvez également vous connecter à votre équipe d'assistance premium. Les demandes d'augmentation de quota ne sont pas facturées directement, mais des niveaux d'utilisation plus élevés peuvent entraîner une augmentation des coûts de service en fonction des ressources supplémentaires consommées. Pour plus d’informations, consultez [Gérez les quotas avec Service Quotas](manage-quotas.md).
Les Quotas de Service sont le nombre maximum de ressources que vous pouvez avoir par AWS compte et par AWS région. Amazon Location Service refuse les demandes supplémentaires qui dépassent le quota de service.
## Ressources
| Nom de l’API | Par défaut | Limite maximale ajustable |
| --- | --- | --- |
| Ressources de collecte par compte | 1 500 | 3000 Si vous avez besoin de plus que cela, [demandez des augmentations de quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance. |
| Geofences par collection | 50000 | Contactez l'équipe d'assistance. |
## API CRUD
**Note**
Si vous avez besoin d'une limite plus élevée pour l'un d'entre eux APIs, [demandez une augmentation du quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance.
| Nom de l’API | Par défaut | Limite maximale ajustable |
| --- | --- | --- |
| [CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html) | 10 | 20 |
| [DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html) | 10 | 20 |
| [DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html) | 10 | 20 |
| [ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html) | 10 | 20 |
| [UpdateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_UpdateGeofenceCollection.html) | 10 | 20 |
## API de données
**Note**
Si vous avez besoin d'une limite plus élevée pour l'un d'entre eux APIs, [demandez une augmentation du quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou contactez l'équipe d'assistance.
| Nom de l’API | Par défaut | Limite maximale ajustable |
| --- | --- | --- |
| [BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html) | 50 | 100 |
| [PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html) | 50 | 100 |
| [BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html) | 50 | 100 |
| [ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html) | 50 | 100 |
| [GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html) | 50 | 100 |
| [BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html) | 50 | 100 |
## Autres limites d'utilisation