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.
Ajouter des géofences
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é 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.
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, AWS CLI ou des API Amazon Location.
- Console
-
Pour créer une collection de géofences à l'aide de la console Amazon Location
-
Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/.
-
Dans le volet de navigation de gauche, choisissez Geofence collections.
-
Choisissez Créer une collection de géofences.
-
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.
-
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.
-
(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, consultez Marquage de vos ressources Amazon Location Service.
-
(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.
-
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 de géofences 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 an AWS CLI pour créer une collection de géofences appelée. ExampleGeofenceCollection La collection de géofences 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 "ExampleGeofenceCollection1234abcd-12ab-34cd-56ef-1234567890ab" \
--tags Tag1=Value1
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 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 des API Amazon Location Service, 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 GeoJSON
Maintenant que vous avez créé votre collection de géofences, vous pouvez définir vos géofences à l'aide d'un outil d'édition GeoJSON, tel que geojson.io.
Pour créer un fichier GeoJSON
-
Ouvrez un outil d'édition GeoJSON. Par exemple, geojson.io.
-
Choisissez l'icône Dessiner un polygone et dessinez la zone qui vous intéresse.
-
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, de, 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
-
Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/.
-
Dans le volet de navigation de gauche, choisissez Geofence collections.
-
Dans la liste des collections Geofence, sélectionnez le lien du nom de la collection Geofence cible.
-
Sous Geofences, choisissez Create Geofences.
-
Dans la fenêtre Ajouter des géofences, faites glisser et déposez votre fichier GeoJSON dans la fenêtre.
-
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 ayant 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 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 barrières géographiques circulaires à l'aide des API Amazon Location ou du. AWS CLI
- 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 ayant l'ID GEOFENCE-EXAMPLE2 à 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}'
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
Dans l'exemple, le fichier circle.json inclut le JSON pour la géométrie du cercle.
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
