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. # Créer un dispositif de suivi Créez une ressource de suivi pour stocker et traiter les mises à jour de position à partir de vos appareils. Vous pouvez utiliser la console Amazon Location Service AWS CLI, le ou Amazon Location APIs. Chaque mise à jour de position stockée dans vos ressources de suivi peut inclure une mesure de la précision de la position et jusqu'à trois champs de métadonnées concernant la position ou l'appareil que vous souhaitez stocker. Les métadonnées sont stockées sous forme de paires clé-valeur et peuvent stocker des informations telles que la vitesse, la direction, la pression des pneus ou la température du moteur. Les trackers filtrent les mises à jour de position au fur et à mesure de leur réception. Cela réduit le bruit visuel sur les trajectoires de votre appareil (appelé *instabilité*) et le nombre de faux événements d'entrée et de sortie de barrières géographiques. Cela permet également de gérer les coûts en réduisant le nombre d'évaluations de géofences lancées. Les trackers proposent trois options de filtrage des positions pour vous aider à gérer les coûts et à réduire l'agitation lors des mises à jour de votre position. + **Basé sur la précision** — À *utiliser avec n'importe quel appareil fournissant une mesure précise. La plupart des appareils mobiles fournissent ces informations.* La précision de chaque mesure de position dépend de nombreux facteurs environnementaux, notamment la réception des satellites GPS, le paysage et la proximité des appareils Wi-Fi et Bluetooth. La plupart des appareils, y compris la plupart des appareils mobiles, peuvent fournir une estimation de la précision de la mesure en même temps que celle-ci. Grâce au `AccuracyBased` filtrage, Amazon Location ignore les mises à jour de localisation si le déplacement de l'appareil est inférieur à la précision mesurée. Par exemple, si deux mises à jour consécutives provenant d'un appareil ont une plage de précision de 5 m et 10 m, Amazon Location ignore la deuxième mise à jour si l'appareil s'est déplacé de moins de 15 m. Amazon Location n'évalue pas les mises à jour ignorées par rapport aux géofences et ne les stocke pas. Lorsque la précision n'est pas fournie, elle est considérée comme nulle et la mesure est considérée comme parfaitement précise. **Note** Vous pouvez également utiliser le filtrage basé sur la précision pour supprimer tous les filtres. Si vous sélectionnez le filtrage basé sur la précision, mais que vous remplacez toutes les données de précision à zéro, ou que vous omettez complètement la précision, Amazon Location ne filtrera aucune mise à jour. + **Basé sur la distance** : à *utiliser lorsque vos appareils ne fournissent pas de mesure précise, mais que vous souhaitez tout de même tirer parti du filtrage pour réduire l'instabilité et gérer les coûts.* `DistanceBased`le filtrage ignore les mises à jour de localisation dans lesquelles les appareils se sont déplacés à moins de 30 m (98,4 pieds). Lorsque vous utilisez le filtrage de `DistanceBased` position, Amazon Location n'évalue pas ces mises à jour ignorées par rapport aux géofences et ne stocke pas les mises à jour. La précision de la plupart des appareils mobiles, y compris la précision moyenne des appareils iOS et Android, est inférieure à 15 m. Dans la plupart des applications, le `DistanceBased` filtrage permet de réduire l'effet des inexactitudes de localisation lors de l'affichage de la trajectoire des appareils sur une carte, ainsi que l'effet de rebond de plusieurs événements consécutifs d'entrée et de sortie lorsque les appareils se trouvent à proximité de la limite d'une géofence. Cela peut également contribuer à réduire le coût de votre application, en effectuant moins d'appels pour effectuer une évaluation par rapport à des géofences liées ou pour récupérer les positions des appareils. + **Basé sur le temps** — (par défaut) À *utiliser lorsque vos appareils envoient des mises à jour de position très fréquemment (plus d'une fois toutes les 30 secondes) et que vous souhaitez réaliser des évaluations de géofences en temps quasi réel sans enregistrer* chaque mise à jour.Lors du `TimeBased` filtrage, chaque mise à jour de localisation est évaluée par rapport à des collections de géofences liées, mais toutes les mises à jour de localisation ne sont pas stockées. Si votre fréquence de mise à jour est supérieure à 30 secondes, une seule mise à jour toutes les 30 secondes est enregistrée pour chaque ID d'appareil unique. **Note** Tenez compte des coûts de votre application de suivi lorsque vous décidez de votre méthode de filtrage et de la fréquence des mises à jour de position. Vous êtes facturé pour chaque mise à jour de position et une fois pour l'évaluation de la mise à jour de position par rapport à chaque collection de géofences liée. Par exemple, lorsque vous utilisez le filtrage basé sur le temps, si votre traceur est lié à deux collections de géofences, chaque mise à jour de position comptera comme une demande de mise à jour de localisation et deux évaluations de collections de géofences. Si vous signalez des mises à jour de position toutes les 5 secondes pour vos appareils et que vous utilisez un filtrage basé sur le temps, 720 mises à jour de localisation et 1 440 évaluations de géofences par heure vous seront facturées pour chaque appareil. 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. Par défaut, vous recevrez EventBridge des événements chaque fois qu'un appareil suivi entre ou sort d'une géofence liée. Pour de plus amples informations, veuillez consulter [Associer un traceur à une collection de géofences](associate-consumer.md). Vous pouvez activer des événements pour toutes les mises à jour de position filtrées pour une ressource de suivi. Pour de plus amples informations, veuillez consulter [Activer les événements de mise à jour pour un tracker](location-events.md#enable-update-events). **Note** Si vous souhaitez chiffrer vos données à l'aide de votre propre clé gérée par le AWS KMS client, la fonctionnalité Bounding Polygon Queries sera désactivée par défaut. En effet, en utilisant cette fonctionnalité de requêtes polygonales de délimitation, aucune représentation des positions de votre appareil ne sera cryptée à l'aide de votre clé AWS KMS gérée. Cependant, la position exacte de l’appareil est toujours chiffrée à l’aide de votre clé gérée. Vous pouvez choisir d'activer la fonctionnalité Bounding Polygon Queries en définissant le `KmsKeyEnableGeospatialQueries` paramètre sur true lors de la création ou de la mise à jour d'un outil de suivi. ------ #### [ Console ] **Pour créer un outil de suivi à l'aide de la console Amazon Location** 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 **Trackers**. 1. Choisissez **Créer un tracker**. 1. Remplissez les champs suivants : + ****Nom**** — Entrez un nom unique. Par exemple, *ExampleTracker*. 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. 1. Sous **Filtrage des positions**, choisissez l'option qui correspond le mieux à la manière dont vous avez l'intention d'utiliser votre ressource de suivi. Si vous ne définissez pas le **filtrage de position**, le paramètre par défaut est`TimeBased`. Pour plus d'informations, consultez [Appareils de suivi Amazon Location Service](trackers.md) ce guide et `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)` le manuel Amazon Location Service Trackers API Reference. 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 de plus amples informations, veuillez consulter [Comment utiliser les tags](manage-resources.md#manage-resources_how-to). 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. (Facultatif) Sous **KmsKeyEnableGeospatialQueries**, vous pouvez choisir d'activer les **requêtes géospatiales**. Cela vous permet d'utiliser la fonctionnalité Bounding Polygon Queries, tout en chiffrant vos données à l'aide d'une clé gérée par le client AWS KMS. **Note** Lorsque vous utilisez la fonctionnalité Bounding Polygon Queries, la représentation des positions de votre appareil n'est pas cryptée à l'aide de votre clé AWS KMS gérée. Cependant, la position exacte de l’appareil est toujours chiffrée à l’aide de votre clé gérée. 1. (Facultatif) Dans **EventBridge la configuration**, vous pouvez choisir d'activer les EventBridge événements pour les mises à jour de position filtrées. Cela enverra un événement chaque fois qu'une mise à jour de position d'un appareil dans ce tracker répond à l'évaluation du filtrage de position. 1. Choisissez **Créer un tracker**. ------ #### [ API ] **Pour créer un outil de suivi à l'aide de l'Amazon Location APIs** Utilisez l'`[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)`opération des Amazon Location Trackers APIs. L'exemple suivant utilise une demande d'API pour créer un outil de suivi appelé*ExampleTracker*. La ressource de suivi est associée à une [AWS KMS clé gérée par le client pour chiffrer les données du client](encryption-at-rest.md) et ne [permet pas les mises à jour de position dans EventBridge](location-events.md#enable-update-events). ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": false, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` **Créez un tracker avec `KmsKeyEnableGeospatialQueries` activé** Dans l'exemple suivant, le paramètre est `KmsKeyEnableGeospatialQueries` défini sur true. Cela vous permet d'utiliser la fonctionnalité Bounding Polygon Queries, tout en chiffrant vos données à l'aide d'une clé gérée par le client AWS KMS . Pour plus d'informations sur l'utilisation de la fonctionnalité Bounding Polygon Requêtes, voir [Listez les positions de votre appareil](list-device-positions.md) **Note** Lorsque vous utilisez la fonctionnalité Bounding Polygon Queries, la représentation des positions de votre appareil n'est pas cryptée à l'aide de votre clé AWS KMS gérée. Cependant, la position exacte de l’appareil est toujours chiffrée à l’aide de votre clé gérée. ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": true, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` ------ #### [ AWS CLI ] **Pour créer un tracker à l'aide de AWS CLI commandes** Utilisez la commande `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)`. L'exemple suivant utilise le AWS CLI pour créer un tracker appelé*ExampleTracker*. La ressource de suivi est associée à une [AWS KMS clé gérée par le client pour chiffrer les données du client](encryption-at-rest.md) et ne [permet pas les mises à jour de position dans EventBridge](location-events.md#enable-update-events). ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries false \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` **Créez un tracker avec `KmsKeyEnableGeospatialQueries` activé** Dans l'exemple suivant, le paramètre est `KmsKeyEnableGeospatialQueries` défini sur true. Cela vous permet d'utiliser la fonctionnalité Bounding Polygon Queries, tout en chiffrant vos données à l'aide d'une clé gérée par le client AWS KMS . Pour plus d'informations sur l'utilisation de la fonctionnalité Bounding Polygon Requêtes, voir [Listez les positions de votre appareil](list-device-positions.md) **Note** Lorsque vous utilisez la fonctionnalité Bounding Polygon Queries, la représentation des positions de votre appareil n'est pas cryptée à l'aide de votre clé AWS KMS gérée. Cependant, la position exacte de l’appareil est toujours chiffrée à l’aide de votre clé gérée. ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries true \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` ------ **Note** La facturation dépend de votre utilisation. L'utilisation d'autres AWS services peut entraîner des frais. Pour plus d'informations, consultez les [tarifs d'Amazon Location Service](https://aws.amazon.com/location/pricing/). Vous pouvez modifier la **description**, le **filtrage des positions** et la **EventBridge configuration** une fois le tracker créé en choisissant **Modifier le tracker**.