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).](https://geojson.org/) Vous pouvez utiliser gratuitement des outils tels que [geojson.io](http://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](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.6)) ni les géofences qui traversent l'antiméridien (la ligne de longitude à 180°).
**Topics**
+ [Création d’une collection de périmètres virtuels](#create-geofence-collection)
+ [Dessiner des géofences](#draw-geofences)
+ [Ajouter des géofences polygonales](#draw-polygon-geofences)
+ [Ajouter des géofences circulaires](#draw-circle-geofences)
## 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 ]
1. Ouvrez la console Amazon Location Service à l'adresse [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Dans le volet de navigation de gauche, choisissez **Geofence collections.**
1. Choisissez **Créer une collection de géofences.**
1. 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.
1. 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](location-events.md). Cela permet à Amazon Location de publier des événements sur Amazon CloudWatch Logs.
1. (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](manage-resources.md).
1. (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.](encryption-at-rest.md)
1. Choisissez **Créer une collection de géofences.**
------
#### [ API ]
Utilisez l'`[CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html)`opé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](encryption-at-rest.md) 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 ]
Utilisez la commande `[create-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/create-geofence-collection.html)`.
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](encryption-at-rest.md) 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](https://aws.amazon.com/location/pricing/).
## 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.](http://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](#draw-circle-geofences).
À 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 lorsque[Réagissez aux événements du service de location Amazon avec Amazon EventBridge](location-events.md).
## 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
1. [Ouvrez un outil d'édition GeoJSON, tel que geojson.io.](http://geojson.io/)
1. Choisissez l'icône **Dessiner un polygone** et dessinez la zone qui vous intéresse.
1. 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 ]
1. Ouvrez la console Amazon Location Service à l'adresse [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Dans le volet de navigation de gauche, choisissez **Geofence collections.**
1. Dans la liste des **collections Geofence**, sélectionnez le lien du nom de la collection Geofence cible.
1. Sous **Geofences**, choisissez **Create** Geofences.
1. Dans la fenêtre **Ajouter des géofences**, faites glisser votre fichier GeoJSON dans la fenêtre.
1. Choisissez **Ajouter des géofences.**
------
#### [ API ]
Utilisez l'`[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)`opé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](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html)`
```
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 ]
Utilisez la commande `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
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 ]
1. Ouvrez la console Amazon Location Service à l'adresse [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Dans le volet de navigation de gauche, choisissez **Geofence collections.**
1. Dans la liste des **collections Geofence**, sélectionnez le lien du nom de la collection Geofence cible.
1. Sous **Geofences**, choisissez **Create** Geofences.
1. Dans la fenêtre **Ajouter des géofences**, choisissez **Cercle**, puis entrez la **latitude**, la **longitude** et le **rayon du centre en mètres**.
1. Choisissez **Ajouter des géofences.**
------
#### [ API ]
Utilisez l'`[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)`opé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 ]
Utilisez la commande `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
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
}
}
```
------