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.
# Appareils de suivi Amazon Location Service
![\[Ce schéma explique comment créer et utiliser des ressources de suivi.\]](http://docs.aws.amazon.com/fr_fr/location/latest/developerguide/images/illustration-trackers.PNG)
**Note**
Le stockage du tracker est automatiquement chiffré avec les clés AWS détenues. Vous pouvez ajouter une couche de chiffrement supplémentaire à l'aide des clés KMS que vous gérez, afin de garantir que vous êtes le seul à pouvoir accéder à vos données. Pour de plus amples informations, veuillez consulter [Chiffrement des données au repos pour Amazon Location Service](encryption-at-rest.md).
Un tracker enregistre les mises à jour de position d'un ensemble d'appareils. Le tracker peut être utilisé pour demander la position actuelle ou l'historique des positions des appareils. Il stocke les mises à jour, mais réduit l'espace de stockage et le bruit visuel en filtrant les emplacements avant de les stocker.
Chaque mise à jour de position stockée dans les ressources de votre tracker peut inclure une mesure de la précision de la position et jusqu'à 3 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.
Le filtrage de position et les requêtes des traceurs sont utiles en eux-mêmes, mais les trackers sont particulièrement utiles lorsqu'ils sont associés à des géofences. Vous pouvez associer les traceurs à une ou plusieurs de vos ressources de collecte de géofences, et les mises à jour de position sont évaluées automatiquement par rapport aux géofences de ces collections. L'utilisation appropriée du filtrage peut également réduire considérablement les coûts de vos évaluations de géofences.
1. Tout d'abord, vous créez une ressource de suivi dans votre AWS compte.
1. Décidez ensuite de la manière dont vous souhaitez envoyer les mises à jour de localisation à vos ressources de suivi. [AWS SDKs](dev-sdks.md)Utilisez-le pour intégrer des fonctionnalités de suivi dans vos applications mobiles. Vous pouvez également utiliser le MQTT en suivant les step-by-step instructions de [suivi à l'aide](tracking-using-mqtt.md) du MQTT.
1. Vous pouvez désormais utiliser votre ressource de suivi pour enregistrer l'historique des positions et le visualiser sur une carte.
1. Vous pouvez également lier votre ressource de suivi à une ou plusieurs collections de géofences afin que chaque mise à jour de position envoyée à votre ressource de suivi soit automatiquement évaluée par rapport à toutes les barrières géographiques de toutes les collections de géofences liées. Vous pouvez lier une ressource sur la page de détails des ressources de suivi de la console Amazon Location ou en utilisant l'API Amazon Location Trackers.
1. Vous pouvez ensuite 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).
## Fonctionnalités
+ **Filtrage des positions** — Les trackers peuvent filtrer automatiquement les positions qui leur sont envoyées. Il existe plusieurs raisons pour lesquelles vous souhaiterez peut-être filtrer certaines mises à jour de localisation de votre appareil. Si votre système n'envoie des rapports que toutes les minutes environ, vous pouvez filtrer les appareils par heure, en stockant et en évaluant les positions toutes les 30 secondes uniquement. Même si vous effectuez une surveillance plus fréquente, vous souhaiterez peut-être filtrer les mises à jour de position pour éliminer le bruit inhérent au matériel GPS et aux rapports de position. Leur précision n'est pas parfaite à 100 %, de sorte que même un appareil immobile semble légèrement bouger. À basse vitesse, cette *instabilité crée un* encombrement visuel et peut provoquer de fausses entrées et sorties si l'appareil se trouve à proximité du bord d'une clôture géographique.
Le filtrage de position fonctionne lorsque les mises à jour de position sont reçues par un traceur, ce qui réduit le bruit visuel sur les trajectoires de votre appareil (instabilité), réduit le nombre de faux événements d'entrée et de sortie de barrières géographiques et aide à gérer les coûts en réduisant le nombre de mises à jour de position stockées et d'évaluations de géofences déclenché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 GPS et 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 WiFi appareils 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 la mesure. 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 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, et aucun filtrage ne sera appliqué aux mises à jour.
**Note**
Vous pouvez 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 au cours desquelles les appareils se sont déplacés de 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.
Le filtrage basé sur la distance est utile si vous souhaitez filtrer, mais que votre appareil ne fournit pas de mesures de précision, ou si vous souhaitez filtrer un plus grand nombre de mises à jour que le filtrage basé sur la précision.
+ **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.
Dans le cadre 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.
Le filtrage basé sur le temps est particulièrement utile lorsque vous souhaitez stocker moins de positions, mais que vous souhaitez que chaque mise à jour des positions soit évaluée par rapport aux collections de géofences associées.
**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.
## Cas d'utilisation des dispositifs de suivi Amazon Location Service
Voici quelques utilisations courantes des dispositifs de suivi Amazon Location Service.
**Utilisez des traceurs dotés de géofences**
Les traceurs fournissent des fonctionnalités supplémentaires lorsqu'ils sont associés à des barrières géographiques. Vous associez un traceur à une collection de géofences, via la console Amazon Location ou l'API, pour évaluer automatiquement les emplacements des traceurs. Chaque fois que le traceur reçoit une position mise à jour, cette position est évaluée par rapport à chaque géofence de la collection, et les `EXIT` événements appropriés `ENTER` sont générés sur Amazon. EventBridge Vous pouvez également appliquer un filtrage au traceur et, en fonction du filtrage, vous pouvez réduire les coûts des évaluations de géofences en évaluant uniquement les mises à jour de localisation significatives.
Si vous associez le traceur à une collection de géofences alors qu'il a déjà reçu des mises à jour de position, la première mise à jour de position après l'association est traitée comme une mise à jour initiale pour les évaluations de géofences. S'il se trouve à l'intérieur d'une géofence, vous recevrez un `ENTER` événement. S'il ne se trouve dans aucune zone géographique, vous ne recevrez aucun `EXIT` événement, quel que soit l'état précédent.
**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 votre précieux équipement, de votre inventaire et de vos autres actifs mobiles. Configurez des barrières géographiques pour recevoir des alertes en cas de mouvements ou de suppressions non autorisés, afin d'améliorer 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é.
**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 offrir un engagement contextuel hyperciblé qui stimule les ventes et la fidélité dans le monde physique.
# Concepts de suivi
Cette section détaille les concepts courants des trackers.
## Terminologie courante des traceurs Amazon Location Service
**Ressource de suivi**
AWS Ressource qui reçoit les mises à jour de localisation des appareils. La ressource de suivi fournit une assistance pour les requêtes de localisation, telles que la localisation actuelle et historique de l'appareil. L'association d'une ressource de suivi à une collection de géofences évalue automatiquement les mises à jour de localisation par rapport à toutes les géofences de la collection de géofences liée.
**Données de position suivies**
Une ressource de suivi stocke des informations sur vos appareils au fil du temps. Les informations incluent une série de mises à jour de position, chaque mise à jour incluant le lieu, l'heure et des métadonnées facultatives. Les métadonnées peuvent inclure la précision d'une position et jusqu'à trois paires clé-valeur pour vous aider à suivre les informations clés relatives à chaque position, telles que la vitesse, la direction, la pression des pneus, le carburant restant ou la température du moteur du véhicule que vous suivez. Les trackers conservent l'historique de localisation de l'appareil pendant 30 jours.
**Filtrage de position**
Le filtrage des positions peut vous aider à contrôler les coûts et à améliorer la qualité de votre application de suivi en filtrant les mises à jour de position qui ne fournissent pas d'informations précieuses avant qu'elles ne soient stockées ou évaluées par rapport aux géofences.
Vous pouvez choisir `AccuracyBased` ou `TimeBased` filtrer. `DistanceBased` Par défaut, le filtrage des positions est défini sur`TimeBased`.
Vous pouvez configurer le filtrage des positions lorsque vous créez ou mettez à jour des ressources de suivi.
**Format d'horodatage RFC 3339 **
Les dispositifs de suivi Amazon Location Service utilisent le format [RFC 3339](https://tools.ietf.org/html/rfc3339), qui suit le format ISO [8601 de l'Organisation internationale de normalisation (ISO) pour](https://www.iso.org/iso-8601-date-and-time-format.html) les dates et les heures.
Le format est « YYYY-MM DDThh -:MM:SS.ssz\$1 00:00 » :
+ `YYYY-MM-DD`— Représente le format de date.
+ `T`— Indique que les valeurs temporelles suivront.
+ `hh:mm:ss.sss`— Représente l'heure au format 24 heures.
+ `Z`— Indique que le fuseau horaire utilisé est l'UTC, qui peut être suivi d'écarts par rapport au fuseau horaire UTC.
+ `+00:00`— Indiquez éventuellement les écarts par rapport au fuseau horaire UTC. Par exemple, \$1 01:00 indique UTC \$1 1 heure.
**Exemple**
Le 2 juillet 2020, à 12 h 15 min 20 s, avec un ajustement d'une heure supplémentaire par rapport au fuseau horaire UTC.
```
2020-07-02T12:15:20.000Z+01:00
```
# Commencez avec les outils de suivi Amazon Location Service
Cette section fournit un guide complet sur la création et l'utilisation de traceurs avec Amazon Location. Les trackers vous permettent de stocker, de traiter et d'évaluer la position des appareils tout en filtrant les mises à jour de localisation afin de réduire le bruit et de gérer les coûts. Grâce à des options avancées de filtrage de position, à la prise en charge de collections de géofences liées et à l'intégration avec AWS des services tels que EventBridge IoT Core, les trackers permettent un suivi précis en temps réel et des applications de géofencing adaptées à vos besoins spécifiques.
**Topics**
+ [Créer un dispositif de suivi](start-create-tracker.md)
+ [Authentification de vos demandes](tracking-identity-pool.md)
+ [Mettez à jour votre traceur avec la position de l'appareil](send-location-updates.md)
+ [Obtenir l'historique de localisation d'un appareil à partir d'un traceur](get-location-history.md)
+ [Listez les positions de votre appareil](list-device-positions.md)
# 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**.
# Authentification de vos demandes
Une fois que vous avez créé une ressource de suivi et que vous êtes prêt à commencer à évaluer les positions des appareils par rapport aux géofences, choisissez la manière dont vous souhaitez authentifier vos demandes :
+ Pour découvrir les moyens d'accéder aux services, voir[Authentifiez-vous auprès d'Amazon Location Service](access.md).
+ Si vous souhaitez publier les positions des appareils à l'aide de demandes non authentifiées, vous pouvez utiliser Amazon Cognito.
**Exemple**
L'exemple suivant montre l'utilisation d'un pool d'identités Amazon Cognito pour l'autorisation, à l'aide du [AWS JavaScript SDK v3](https://aws.amazon.com/sdk-for-javascript/) et de l'emplacement Amazon. [Web](how-to-auth-helper.md#loc-sdk-auth-web)
```
import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location";
import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper";
// Unauthenticated identity pool you created
const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id";
// Create an authentication helper instance using credentials from Cognito
const authHelper = await withIdentityPoolId(identityPoolId);
const client = new LocationClient({
region: "us-east-1", // The region containing both the identity pool and tracker resource
...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
});
const input = {
TrackerName: "ExampleTracker",
Updates: [
{
DeviceId: "ExampleDevice-1",
Position: [-123.4567, 45.6789],
SampleTime: new Date("2020-10-02T19:09:07.327Z"),
},
{
DeviceId: "ExampleDevice-2",
Position: [-123.123, 45.123],
SampleTime: new Date("2020-10-02T19:10:32Z"),
},
],
};
const command = new BatchUpdateDevicePositionCommand(input);
// Send device position updates
const response = await client.send(command);
```
# Mettez à jour votre traceur avec la position de l'appareil
Pour suivre vos appareils, vous pouvez publier des mises à jour de position des appareils sur votre traceur. Vous pouvez ensuite récupérer ces positions de l'appareil ou l'historique des positions de l'appareil à partir de votre ressource de suivi.
Chaque mise à jour de position doit inclure l'identifiant de l'appareil, un horodatage et une position. Vous pouvez éventuellement inclure d'autres métadonnées, notamment la précision et jusqu'à 3 paires clé-valeur pour votre propre usage.
Si votre traceur est lié à une ou plusieurs collections de géofences, les mises à jour seront évaluées par rapport à ces géofences (conformément aux règles de filtrage que vous avez spécifiées pour le traceur). Si un appareil franchit une zone géo-clôturée (en se déplaçant de l'intérieur vers l'extérieur de la zone, ou vice versa), vous recevrez des événements à l'intérieur. EventBridge Ces `EXIT` événements `ENTER` ou événements incluent les détails de mise à jour de la position, y compris l'identifiant de l'appareil, l'horodatage et toutes les métadonnées associées.
**Note**
Pour plus d'informations sur le filtrage des positions, consultez[Créer un dispositif de suivi](start-create-tracker.md).
Pour plus d'informations sur les événements de géofence, consultez. [Réagissez aux événements du service de location Amazon avec Amazon EventBridge](location-events.md)
Utilisez l'une des méthodes suivantes pour envoyer les mises à jour de l'appareil :
+ [Envoyez des mises à jour MQTT](tracking-using-mqtt.md) à une ressource AWS IoT Core et associez-la à votre ressource de suivi.
+ Envoyez des mises à jour de localisation à l'aide de l'API Amazon Location Trackers AWS CLI, en utilisant le ou l'Amazon Location APIs. Vous pouvez utiliser le [AWS SDKs](dev-sdks.md)pour appeler APIs depuis votre application iOS ou Android.
------
#### [ API ]
**Pour envoyer une mise à jour de position à l'aide de l'Amazon Location APIs**
Utilisez l'`[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)`opération des Amazon Location Trackers APIs.
L'exemple suivant utilise une demande d'API pour publier une mise à jour de la position de l'appareil *ExampleDevice* sur un tracker*ExampleTracker*.
```
POST /tracking/v0/trackers/ExampleTracker/positions
Content-type: application/json
{
"Updates": [
{
"DeviceId": "1",
"Position": [
-123.12245146162303, 49.27521118043802
],
"SampleTime": "2022-10-24T19:09:07.327Z",
"PositionProperties": {
"name" : "device1"
},
"Accuracy": {
"Horizontal": 10
}
},
{
"DeviceId": "2",
"Position": [
-123.1230104928471, 49.27752402723152
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "3",
"Position": [
-123.12325592118916, 49.27340530543111
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "4",
"Position": [
-123.11958813096311, 49.27774641063121
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "5",
"Position": [
-123.1277418058896, 49.2765989015285
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "6",
"Position": [
-123.11964267059481, 49.274188155916534
],
"SampleTime": "2022-10-02T19:09:07.327Z"
}
]
}
```
------
#### [ AWS CLI ]
**Pour envoyer une mise à jour de position à l'aide de AWS CLI commandes**
Utilisez la commande `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`.
L'exemple suivant utilise un AWS CLI pour publier une mise à jour de la position de l'appareil pour *ExampleDevice-1* et *ExampleDevice-2* vers un tracker*ExampleTracker*.
```
aws location batch-update-device-position \
--tracker-name ExampleTracker \
--updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```
------
# Obtenir l'historique de localisation d'un appareil à partir d'un traceur
Votre ressource Amazon Location Tracker conserve l'historique de localisation de tous vos appareils suivis pendant une période de 30 jours. Vous pouvez récupérer l'historique de localisation de l'appareil, y compris toutes les métadonnées associées, à partir de votre ressource de suivi. Les exemples suivants utilisent le AWS CLI, ou l'emplacement Amazon APIs.
------
#### [ API ]
**Pour obtenir l'historique de localisation de l'appareil à partir d'un traceur à l'aide d'Amazon Location APIs**
Utilisez l'`[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)`opération des Amazon Location Trackers APIs.
L'exemple suivant utilise une requête d'URI d'API pour obtenir l'historique de localisation de l'appareil *ExampleDevice* à partir d'un tracker appelé en *ExampleTracker* commençant par `19:05:07` (inclus) et se terminant à `19:20:07` (exclusif) le`2020–10–02`.
```
POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions
Content-type: application/json
{
"StartTimeInclusive": "2020-10-02T19:05:07.327Z",
"EndTimeExclusive": "2020-10-02T19:20:07.327Z"
}
```
------
#### [ AWS CLI ]
**Pour obtenir l'historique de localisation de l'appareil à partir d'un traceur à l'aide de AWS CLI commandes**
Utilisez la commande `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)`.
L'exemple suivant utilise an AWS CLI pour obtenir l'historique de localisation de l'appareil *ExampleDevice* à partir d'un tracker appelé en *ExampleTracker* commençant par `19:05:07` (inclus) et se terminant à `19:20:07` (exclusif) le`2020–10–02`.
```
aws location \
get-device-position-history \
--device-id "ExampleDevice" \
--start-time-inclusive "2020-10-02T19:05:07.327Z" \
--end-time-exclusive "2020-10-02T19:20:07.327Z" \
--tracker-name "ExampleTracker"
```
------
# Listez les positions de votre appareil
Vous pouvez consulter la liste des positions des appareils d'un appareil de suivi à l' AWS CLI aide de l' ListDevicePositions API ou de l'Amazon Location APIs. Lorsque vous appelez l' ListDevicePositions API, une liste des dernières positions de tous les appareils associés à un tracker donné est renvoyée. Par défaut, cette API renvoie 100 des dernières positions des appareils par page de résultats pour un tracker donné. Pour renvoyer uniquement des appareils situés dans une région spécifique, utilisez le `FilterGeometry` paramètre pour créer une requête de polygone de délimitation. Ainsi, lorsque vous appelez ListDevicePositions, seuls les appareils situés à l'intérieur du polygone seront renvoyés.
**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é, 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 cryptée à l'aide de votre clé gérée.
Vous pouvez choisir d'activer la fonctionnalité Bounding Polygon Queries. Pour ce faire, définissez le `KmsKeyEnableGeospatialQueries` paramètre sur true lors de la création ou de la mise à jour d'un Tracker.
------
#### [ API ]
Utilisez l'`[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`opération des Amazon Location Trackers APIs.
L'exemple suivant est une demande d'API pour obtenir une liste des positions des appareils dans une zone polygonale, à l'aide du paramètre facultatif. `[FilterGeometry](https://docs.aws.amazon.com/)` L'exemple renvoie 3 emplacements de périphériques présents dans la zone définie par le `Polygon` tableau.
```
POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1
Content-type: application/json
{
"FilterGeometry": {
"Polygon": [
[
[
-123.12003339442259,
49.27425121147397
],
[
-123.1176984148229,
49.277063620879744
],
[
-123.12389509145294,
49.277954183760926
],
[
-123.12755921328647,
49.27554025235713
],
[
-123.12330236586217,
49.27211836076236
],
[
-123.12003339442259,
49.27425121147397
]
]
]
},
"MaxResults": 3,
"NextToken": "1234-5678-9012"
}
```
Voici un exemple de réponse pour `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` :
```
{
"Entries": [
{
"DeviceId": "1",
"SampleTime": "2022-10-24T19:09:07.327Z",
"Position": [
-123.12245146162303,
49.27521118043802
],
"Accuracy": {
"Horizontal": 10
},
"PositionProperties": {
"name": "device1"
}
},
{
"DeviceId": "3",
"SampleTime": "2022-10-02T19:09:07.327Z",
"Position": [
-123.12325592118916,
49.27340530543111
]
},
{
"DeviceId": "2",
"SampleTime": "2022-10-02T19:09:07.327Z",
"Position": [
-123.1230104928471,
49.27752402723152
]
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Utilisez la commande `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`.
L'exemple suivant permet d' AWS CLI obtenir une liste de périphériques dans une zone polygonale.
```
aws location list-device-positions TODO: add arguments add props for filter geo
```
------
# Comment utiliser les dispositifs de suivi Amazon Location Service
Cette section fournit des instructions relatives à l'utilisation des dispositifs de suivi Amazon Location. Découvrez comment vérifier la position des appareils, relier les traceurs aux collections de géofences et suivre les positions à l'aide de l' AWS IoT et du MQTT. Découvrez également comment gérer efficacement vos traceurs pour prendre en charge vos applications de géolocalisation et garantir un suivi précis en temps réel.
**Topics**
+ [Vérifier la position des appareils](verify-device-positions.md)
+ [Associer un traceur à une collection de géofences](associate-consumer.md)
+ [Suivez l'utilisation AWS IoT et le MQTT avec Amazon Location Service](tracking-using-mqtt.md)
+ [Gérez votre outil de suivi Amazon Location Service](managing-trackers.md)
# Vérifier la position des appareils
Pour vérifier l'intégrité de la position d'un appareil, utilisez l'[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API. Cette API renvoie des informations sur l'intégrité de la position de l'appareil, en évaluant des propriétés telles que le signal cellulaire de l'appareil, le point d'accès Wi-Fi, l'adresse IPv4 et si un proxy est utilisé.
## Conditions préalables
Avant de pouvoir utiliser la liste APIs pour la vérification de l'appareil, assurez-vous de remplir les conditions préalables suivantes :
+ Vous avez créé un outil de suivi pour le ou les appareils que vous souhaitez vérifier. Pour de plus amples informations, veuillez consulter [Commencez avec les outils de suivi Amazon Location Service](start-tracking.md).
L'exemple suivant montre une demande pour l'[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API Amazon Location.
------
#### [ API ]
**Pour vérifier la position des appareils à l'aide de l'Amazon Location APIs**
Utilisez l'`[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)`opération depuis Amazon Location Tracking APIs.
L'exemple suivant montre une demande d'API pour évaluer l'intégrité de la position d'un appareil. Remplacez ces valeurs par votre propre appareil IDs.
```
POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1
Content-type: application/json
{
"DeviceState": {
"Accuracy": {
"Horizontal": number
},
"CellSignals": {
"LteCellDetails": [
{
"CellId": number,
"LocalId": {
"Earfcn": number,
"Pci": number
},
"Mcc": number,
"Mnc": number,
"NetworkMeasurements": [
{
"CellId": number,
"Earfcn": number,
"Pci": number,
"Rsrp": number,
"Rsrq": number
}
],
"NrCapable": boolean,
"Rsrp": number,
"Rsrq": number,
"Tac": number,
"TimingAdvance": number
}
]
},
"DeviceId": "ExampleDevice",
"Ipv4Address": "string",
"Position": [ number ],
"SampleTime": "string",
"WiFiAccessPoints": [
{
"MacAddress": "string",
"Rss": number
}
]
},
"DistanceUnit": "string"
}
```
------
**Note**
Le **SDK Integrity** fournit des fonctionnalités améliorées liées à la vérification des appareils et peut être utilisé sur demande. Pour accéder au SDK, contactez le [Support commercial](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn).
# Associer un traceur à une collection de géofences
Maintenant que vous disposez d'une collection de géofences et d'un traceur, vous pouvez les relier afin que les mises à jour de localisation soient automatiquement évaluées par rapport à toutes vos géofences. Si vous ne souhaitez pas évaluer toutes les mises à jour de localisation, ou si vous ne stockez pas certaines de vos positions dans une ressource de suivi, vous pouvez [évaluer les positions des appareils par rapport aux géofences](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html) à la demande.
Lorsque les positions des appareils sont évaluées par rapport aux géofences, des événements sont générés. Vous pouvez définir une action pour ces événements. Pour plus d'informations sur les actions que vous pouvez définir pour les événements de géofence, consultez [Réagir aux événements Amazon Location Service avec 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 et certains attributs de la barrière géographique entrée 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 relient une ressource de suivi à une collection de géofences à l'aide de la console AWS CLI, du ou de l'Amazon Location. APIs
------
#### [ Console ]
**Pour associer une ressource de suivi à une collection de géofences à l'aide de la console Amazon Location Service**
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. Sous **Device trackers**, sélectionnez le lien du nom du tracker cible.
1. Sous **Collections Geofence liées**, choisissez **Link Geofence** Collection.
1. Dans la fenêtre **Linked Geofence Collection**, sélectionnez une collection de géofences dans le menu déroulant.
1. Choisissez **Lier**.
Une fois que vous aurez lié la ressource de suivi, le statut **Actif** lui sera attribué.
------
#### [ API ]
**Pour associer une ressource de suivi à une collection de géofences à l'aide d'Amazon Location APIs**
Utilisez l'`[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)`opération des Amazon Location Trackers APIs.
L'exemple suivant utilise une demande d'API associée à une collection de géofences à l'aide de son [Amazon Resource Name](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) (ARN). *ExampleTracker*
```
POST /tracking/v0/trackers/ExampleTracker/consumers
Content-type: application/json
{
"ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection"
}
```
------
#### [ AWS CLI ]
**Pour lier une ressource de suivi à une collection de géofences à l'aide de commandes AWS CLI **
Utilisez la commande `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`.
L'exemple suivant utilise an AWS CLI pour créer une collection de géofences appelée. *ExampleGeofenceCollection*
```
aws location \
associate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
--tracker-name "ExampleTracker"
```
------
# Suivez l'utilisation AWS IoT et le MQTT avec Amazon Location Service
[MQTT](http://mqtt.org/) est un protocole de messagerie léger et largement adopté conçu pour les appareils limités. AWS IoT Core prend en charge les connexions de périphériques utilisant le protocole MQTT et le protocole MQTT over WebSocket Secure (WSS).
[AWS IoT Core](https://aws.amazon.com/iot-core/)connecte les appareils à eux AWS et vous permet d'envoyer et de recevoir des messages entre eux. Le moteur de AWS IoT Core règles stocke les requêtes concernant les sujets des messages de vos appareils et vous permet de définir des actions pour envoyer des messages à d'autres AWS services, tels qu'Amazon Location Service. Les appareils qui connaissent leur position sous forme de coordonnées peuvent voir leur position transmise à Amazon Location via le moteur de règles.
**Note**
Les appareils peuvent connaître leur propre position, par exemple via le GPS intégré. AWS IoT prend également en charge le suivi de la localisation des appareils tiers. Pour plus d'informations, consultez la section [Emplacement du périphérique AWS IoTAWS IoT principal](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html) *dans le Guide du développeur principal*.
La procédure pas à pas suivante décrit le suivi à l'aide de AWS IoT Core règles. Vous pouvez également envoyer les informations de l'appareil à votre propre AWS Lambda fonction, si vous devez les traiter avant de les envoyer à Amazon Location. Pour plus de détails sur l'utilisation de Lambda pour traiter la localisation de vos appareils, consultez. [Utilisation AWS Lambda avec MQTT](tracking-using-mqtt-with-lambda.md)
**Topics**
+ [Prérequis](#mqtt-prerequisite)
+ [Création d'une AWS IoT Core règle](#mqtt-create-iot-rule)
+ [Testez votre AWS IoT Core règle dans la console](#mqtt-test-iot-rule)
+ [Utilisation AWS Lambda avec MQTT](tracking-using-mqtt-with-lambda.md)
## Prérequis
Avant de commencer le suivi, vous devez remplir les conditions préalables suivantes :
+ [Créez une ressource de suivi](start-create-tracker.md) à laquelle vous enverrez les données de localisation de l'appareil.
+ [Créez un rôle IAM](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html) pour accorder l' AWS IoT Core accès à votre tracker.
Lorsque vous suivez ces étapes, appliquez la politique suivante pour donner accès à votre traceur :
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "WriteDevicePosition",
"Effect": "Allow",
"Action": "geo:BatchUpdateDevicePosition",
"Resource": "arn:aws:geo:*:*:tracker/*"
}
]
}
```
## Création d'une AWS IoT Core règle
Créez ensuite une AWS IoT Core règle pour transmettre la télémétrie de position de vos appareils à Amazon Location Service. Pour plus d'informations sur la création de règles, consultez les rubriques suivantes du *guide du AWS IoT Core développeur* :
+ [Création d'une AWS IoT règle](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) pour obtenir des informations sur la création d'une nouvelle règle.
+ [Action de localisation](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) pour obtenir des informations spécifiques à la création d'une règle de publication sur Amazon Location
## Testez votre AWS IoT Core règle dans la console
Si aucun appareil ne publie actuellement de télémétrie incluant la localisation, vous pouvez tester votre règle à l'aide de la AWS IoT Core console. La console dispose d'un client de test dans lequel vous pouvez publier un exemple de message pour vérifier les résultats de la solution.
1. Connectez-vous à la AWS IoT Core console à l'adresse [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Dans le volet de navigation de gauche, développez **Test**, puis choisissez le **client de test MQTT**.
1. Sous **Publier dans un sujet**, définissez le **nom du sujet** sur *iot/topic* (ou le nom du sujet que vous avez défini dans votre AWS IoT Core règle, s'il est différent) et fournissez les informations suivantes pour la **charge utile du message**. Remplacez l'horodatage *1604940328* par un horodatage valide au cours des 30 derniers jours (les horodatages antérieurs à 30 jours sont ignorés par les outils de suivi Amazon Location Service).
```
{
"payload": {
"deviceid": "thing123",
"timestamp": 1604940328,
"location": { "lat": 49.2819, "long": -123.1187 },
"accuracy": { "Horizontal": 20.5 },
"positionProperties": { "field1": "value1", "field2": "value2" }
}
}
```
1. Choisissez **Publier** dans le sujet pour envoyer le message de test.
1. Pour vérifier que le message a bien été reçu par Amazon Location Service, utilisez la AWS CLI commande suivante. Si vous l'avez modifié lors de la configuration, remplacez le nom du tracker par celui que vous avez utilisé.
```
aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123
```
# Utilisation AWS Lambda avec MQTT
Bien que l'utilisation ne AWS Lambda soit plus obligatoire lors de l'envoi des données de localisation de l'appareil à Amazon Location à des fins de suivi, vous souhaiterez peut-être toujours utiliser Lambda dans certains cas. Par exemple, si vous souhaitez traiter vous-même les données de localisation de votre appareil avant de les envoyer à Amazon Location. Les rubriques suivantes décrivent comment utiliser Lambda pour traiter les messages avant de les envoyer à votre tracker. Pour plus d'informations sur ce modèle, consultez l'[architecture de référence](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf).
**Topics**
+ [Prérequis](#mqtt-prerequisite-with-lambda)
+ [Création d’une fonction Lambda](#mqtt-with-lambda-create-lambda)
+ [Création d'une AWS IoT Core règle](#mqtt-create-iot-rule-with-lambda)
+ [Testez votre AWS IoT Core règle dans la console](#mqtt-test-iot-rule-with-lambda)
## Prérequis
Avant de commencer le suivi, vous devez [créer une ressource de suivi](start-tracking.md). Pour créer une ressource de suivi, vous pouvez utiliser la console Amazon Location AWS CLI, ou Amazon Location APIs.
L'exemple suivant utilise la console Amazon Location Service pour créer la ressource de suivi :
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 cases suivantes :
+ **Nom** — Entrez un nom unique comportant un maximum de 100 caractères. Les entrées valides incluent les caractères alphanumériques, les traits d'union et les traits de soulignement. Par exemple, *MyTracker*.
+ **Description** — Entrez une description facultative. Par exemple, *Tracker for storing AWS IoT Core device positions*.
+ **Filtrage des positions** : sélectionnez le filtrage que vous souhaitez utiliser pour les mises à jour des positions. Par exemple, le filtrage **basé sur la précision**.
1. Choisissez **Créer un tracker**.
## Création d’une fonction Lambda
Pour créer une connexion entre Amazon Location Service AWS IoT Core et Amazon, vous avez besoin d'une AWS Lambda fonction permettant de traiter les messages transférés par AWS IoT Core. Cette fonction permet d'extraire toutes les données de position, de les formater pour Amazon Location Service et de les envoyer via l'API Amazon Location Tracker. Vous pouvez créer cette fonction par le biais de la AWS Lambda console, ou vous pouvez utiliser le AWS Command Line Interface (AWS CLI) ou le AWS Lambda APIs.
Pour créer une fonction Lambda qui publie des mises à jour de position sur Amazon Location à l'aide de la console :
1. Ouvrez la AWS Lambda console à l'adresse [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home).
1. Dans le menu de navigation de gauche, choisissez **Functions**.
1. Choisissez **Créer une fonction** et assurez-vous que **l'option Auteur à partir de zéro** est sélectionnée.
1. Remplissez les cases suivantes :
+ **Nom de la fonction** — Entrez un nom unique pour votre fonction. Les entrées valides incluent les caractères alphanumériques, les traits d'union et les traits de soulignement sans espaces. Par exemple, *MyLambda*.
+ **Runtime** — Choisissez*Python 3.8*.
1. Choisissez **Créer une fonction**.
1. Cliquez sur l'onglet **Code** pour ouvrir l'éditeur.
1. [Remplacez le code de l'espace réservé `lambda_function.py` par le code suivant, en remplaçant la valeur attribuée `TRACKER_NAME` par le nom du tracker que vous avez créé comme condition préalable.](#mqtt-prerequisite-with-lambda)
```
from datetime import datetime
import json
import os
import boto3
# Update this to match the name of your Tracker resource
TRACKER_NAME = "MyTracker"
"""
This Lambda function receives a payload from AWS IoT Core and publishes device updates to
Amazon Location Service via the BatchUpdateDevicePosition API.
Parameter 'event' is the payload delivered from AWS IoT Core.
In this sample, we assume that the payload has a single top-level key 'payload' and a nested key
'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in
the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For
example:
>>> event
{ 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328,
'location': { 'lat': 49.2819, 'long': -123.1187 },
'accuracy': {'Horizontal': 20.5 },
'positionProperties': {'field1':'value1','field2':'value2'} }
}
If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to
format the data before delivering it to this Lambda function, or you can modify the code below to
match it.
"""
def lambda_handler(event, context):
update = {
"DeviceId": event["payload"]["deviceid"],
"SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"),
"Position": [
event["payload"]["location"]["long"],
event["payload"]["location"]["lat"]
]
}
if "accuracy" in event["payload"]:
update["Accuracy"] = event["payload"]['accuracy']
if "positionProperties" in event["payload"]:
update["PositionProperties"] = event["payload"]['positionProperties']
client = boto3.client("location")
response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update])
return {
"statusCode": 200,
"body": json.dumps(response)
}
```
1. Choisissez **Déployer** pour enregistrer la fonction mise à jour.
1. Cliquez sur l’onglet **Configuration**.
1. Dans la section **Autorisations**, choisissez le nom du rôle en lien hypertexte pour accorder à Amazon Location Service des autorisations pour votre fonction Lambda.
1. Sur la page **Résumé** de votre rôle, choisissez **Ajouter des autorisations**, puis dans la liste déroulante, sélectionnez **Créer une politique intégrée.**
1. Choisissez l'onglet **JSON** et remplacez la politique par le document suivant. Cela permet à votre fonction Lambda de mettre à jour les positions des appareils gérées par toutes les ressources de suivi dans toutes les régions.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "WriteDevicePosition",
"Effect": "Allow",
"Action": "geo:BatchUpdateDevicePosition",
"Resource": "arn:aws:geo:*:*:tracker/*"
}
]
}
```
1. Choisissez **Examiner une politique**.
1. Entrez un nom de stratégie. Par exemple, *AmazonLocationTrackerWriteOnly*.
1. Choisissez **Create Policy** (Créer une politique).
Vous pouvez modifier ce code de fonction, le cas échéant, pour l'adapter au schéma de message de votre appareil.
## Création d'une AWS IoT Core règle
Créez ensuite une AWS IoT Core règle pour transmettre la télémétrie de position de vos appareils à la AWS Lambda fonction de transformation et de publication sur Amazon Location Service. L'exemple de règle fourni suppose que toute transformation nécessaire des charges utiles des appareils est gérée par votre fonction Lambda. Vous pouvez créer cette règle via la AWS IoT Core console, le AWS Command Line Interface (AWS CLI) ou le AWS IoT Core APIs.
**Note**
Bien que la AWS IoT console gère les autorisations nécessaires AWS IoT Core pour appeler votre fonction Lambda, si vous créez votre règle à partir du SDK AWS CLI ou du SDK, vous devez [configurer une politique à laquelle accorder](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements) l'autorisation. AWS IoT
**Pour créer un à AWS IoT Core l'aide de la console**
1. Connectez-vous à la AWS IoT Core console à l'adresse [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Dans le volet de navigation de gauche, développez **Act**, puis sélectionnez **Rules**.
1. Choisissez **Créer une règle** pour démarrer le nouvel assistant de règles.
1. Saisissez un nom et une description pour la règle.
1. Pour l'**instruction de requête Rule**, mettez à jour l'`FROM`attribut pour faire référence à une rubrique dans laquelle au moins un appareil publie des données de télémétrie incluant la localisation. Si vous testez la solution, aucune modification n'est nécessaire.
```
SELECT * FROM 'iot/topic'
```
1. Sous **Définir une ou plusieurs actions**, choisissez **Ajouter une action**.
1. Sélectionnez **Envoyer un message à une fonction Lambda.**
1. Choisissez **Configurer une action**.
1. Recherchez et sélectionnez votre fonction Lambda dans la liste.
1. Choisissez **Add action**.
1. Choisissez **Créer une règle**.
## Testez votre AWS IoT Core règle dans la console
Si aucun appareil ne publie actuellement de télémétrie incluant la localisation, vous pouvez tester votre règle et cette solution à l'aide de la AWS IoT Core console. La console dispose d'un client de test dans lequel vous pouvez publier un exemple de message pour vérifier les résultats de la solution.
1. Connectez-vous à la AWS IoT Core console à l'adresse [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Dans le volet de navigation de gauche, développez **Test**, puis choisissez le **client de test MQTT**.
1. Sous **Publier dans un sujet**, définissez le **nom du sujet** sur *iot/topic* (ou le nom du sujet que vous avez défini dans votre AWS IoT Core règle, s'il est différent) et fournissez les informations suivantes pour la **charge utile du message**. Remplacez l'horodatage *1604940328* par un horodatage valide au cours des 30 derniers jours (tout horodatage de plus de 30 jours est ignoré).
```
{
"payload": {
"deviceid": "thing123",
"timestamp": 1604940328,
"location": { "lat": 49.2819, "long": -123.1187 },
"accuracy": { "Horizontal": 20.5 },
"positionProperties": { "field1": "value1", "field2": "value2" }
}
}
```
1. Choisissez **Publier** dans le sujet pour envoyer le message de test.
1. Pour vérifier que le message a bien été reçu par Amazon Location Service, utilisez la AWS CLI commande suivante. Si vous les avez modifiés lors de la configuration, remplacez le nom du tracker et l'identifiant de l'appareil par ceux que vous avez utilisés.
```
aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123
```
# Gérez votre outil de suivi Amazon Location Service
Vous pouvez gérer vos traceurs à l'aide de la console Amazon Location AWS CLI, du ou de l'Amazon Location APIs.
## Répertoriez vos traceurs
Vous pouvez consulter votre liste de traceurs à l'aide de la console Amazon Location, du AWS CLI, ou de l'Amazon Location : APIs
------
#### [ Console ]
**Pour consulter la liste des traceurs existants à 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 **Trackers** dans le menu de navigation de gauche.
1. Consultez la liste de vos ressources de suivi sous **Mes traceurs**.
------
#### [ API ]
Utilisez l'`[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)`opération des Amazon Location Trackers APIs.
L'exemple suivant est une demande d'API pour obtenir une liste des traceurs de votre AWS compte.
```
POST /tracking/v0/list-trackers
```
Voici un exemple de réponse pour `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` :
```
{
"Entries": [
{
"CreateTime": 2020-10-02T19:09:07.327Z,
"Description": "string",
"TrackerName": "ExampleTracker",
"UpdateTime": 2020-10-02T19:10:07.327Z
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Utilisez la commande `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`.
L'exemple suivant permet d' AWS CLI obtenir une liste des traceurs de votre AWS compte.
```
aws location list-trackers
```
------
## Déconnexion d'un traceur d'une collection de géofences
Vous pouvez déconnecter un traceur d'une collection de géofences à l'aide de la console Amazon Location AWS CLI, du ou de l'Amazon Location : APIs
------
#### [ Console ]
**Pour dissocier un traceur d'une collection de géofences associée à 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 **Trackers** dans le volet de navigation de gauche.
1. Sous **Mes traceurs**, sélectionnez le lien du nom du traceur cible.
1. **Sous **Collections de géofences liées**, sélectionnez une collection de géofences avec le statut Liée.**
1. Choisissez **Dissocier.**
------
#### [ API ]
Utilisez l'`[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`opération des Amazon Location Trackers APIs.
L'exemple suivant est une demande d'API visant à dissocier un traceur d'une collection de géofences associée.
```
DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection
```
Voici un exemple de réponse pour `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` :
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilisez la commande `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)`.
L'exemple suivant est une AWS CLI commande permettant de dissocier un traceur d'une collection de géofences associée.
```
aws location disassociate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \
--tracker-name "ExampleTracker"
```
------
## Obtenir des informations sur le tracker
Vous pouvez obtenir des informations sur n'importe quel traceur de votre AWS compte en utilisant la console Amazon Location AWS CLI, le ou l'Amazon Location APIs.
------
#### [ Console ]
**Pour consulter les détails du traceur à 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 **Trackers** dans le menu de navigation de gauche.
1. Sous **Mes traceurs**, sélectionnez le lien du nom du traceur cible.
1. Consultez les détails du traceur sous **Informations**.
------
#### [ API ]
Utilisez l'`[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`opération depuis l'Amazon Location Tracker APIs.
L'exemple suivant est une demande d'API pour obtenir les détails du tracker pour*ExampleTracker*.
```
GET /tracking/v0/trackers/ExampleTracker
```
Voici un exemple de réponse pour `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` :
```
{
"CreateTime": 2020-10-02T19:09:07.327Z,
"Description": "string",
"EventBridgeEnabled": false,
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"PositionFiltering": "TimeBased",
"Tags": {
"Tag1" : "Value1"
},
"TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker",
"TrackerName": "ExampleTracker",
"UpdateTime": 2020-10-02T19:10:07.327Z
}
```
------
#### [ CLI ]
Utilisez la commande `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`.
L'exemple suivant est une AWS CLI commande permettant d'obtenir les détails du tracker pour*ExampleTracker*.
```
aws location describe-tracker \
--tracker-name "ExampleTracker"
```
------
## Supprimer un traceur
Vous pouvez supprimer un traceur de votre AWS compte à l'aide de la console Amazon Location AWS CLI, du ou de l'Amazon Location APIs :
------
#### [ Console ]
**Pour supprimer une ressource cartographique existante à l'aide de la console Amazon Location**
**Avertissement**
Cette opération supprime définitivement la ressource. Si la ressource de suivi est en cours d'utilisation, il se peut que vous rencontriez une erreur. Assurez-vous que la ressource cible n'est pas une dépendance pour vos applications.
1. Ouvrez la console Amazon Location à l'adresse [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Choisissez **Trackers** dans le volet de navigation de gauche.
1. Sous **Mes traceurs**, sélectionnez le traqueur cible.
1. Choisissez **Supprimer le tracker**.
------
#### [ API ]
Utilisez l'`[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`opération depuis l'Amazon Location Tracker APIs.
L'exemple suivant est une demande d'API pour supprimer le tracker*ExampleTracker*.
```
DELETE /tracking/v0/trackers/ExampleTracker
```
Voici un exemple de réponse pour `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` :
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilisez la commande `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)`.
L'exemple suivant est une AWS CLI commande permettant de supprimer le traceur*ExampleTracker*.
```
aws location delete-tracker \
--tracker-name "ExampleTracker"
```
------
# Gérez les coûts et l'utilisation
Au fur et à mesure que vous en apprendrez davantage sur les dispositifs de suivi Amazon Location, il est important de comprendre comment gérer la capacité des services, garantir le respect des 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 des trackers](trackers-pricing.md)
+ [Quota et utilisation des traceurs](trackers-quotas.md)
# Tarification des trackers
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/).
**Position écrite**
Vous pouvez l'utiliser `BatchUpdateDevicePosition` pour télécharger les données de mise à jour de position d'un ou de plusieurs appareils vers une ressource de suivi (jusqu'à dix appareils par lot). Le prix est basé sur le nombre de positions des appareils dans votre demande d'API. Le prix unitaire par mise à jour de la position de l'appareil 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 position écrite 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 utilisant éventuellement un filtre local pour télécharger uniquement les mises à jour de position pertinentes de l'appareil sur Amazon Location Service.
**Position lue**
Vous pouvez l'utiliser `BatchGetDevicePosition` pour répertorier les dernières positions des appareils demandés, jusqu'à 100 appareils par demande. Vous pouvez également l'utiliser `GetDevicePosition` pour récupérer la position la plus récente d'un appareil en fonction de son temps d'échantillonnage.
Le prix est basé sur le nombre de demandes d'API.
**Supprimer la position**
Vous pouvez l'utiliser `BatchDeleteDevicePositionHistory` pour supprimer l'historique des positions d'un ou de plusieurs appareils d'une ressource de suivi, jusqu'à 100 appareils par demande.
Le prix est basé sur le nombre d'appareils inclus dans votre demande d'API.
**Évaluation de l'intégrité du poste**
Vous pouvez l'utiliser `VerifyDevicePosition` pour vérifier l'intégrité de la position de l'appareil en déterminant si elle a été signalée derrière un proxy et en la comparant à une position déduite estimée en fonction de l'état de l'appareil.
Le prix est basé sur le nombre de demandes d'API.
# Quota et utilisation des traceurs
Cette rubrique fournit un résumé des limites de débit et des quotas pour les dispositifs de suivi Amazon Location Service.
**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 suivi par compte | 500 | 1 000 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. |
| Suivez les consommateurs par traceur | 5 | La limite maximale ajustable n'est pas applicable. 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 |
| --- | --- | --- |
| [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 |
| [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 |
| [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 |
| [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 |
| [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 |
| [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 |
| [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 |
| [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.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 |
| --- | --- | --- |
| [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 |
| [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 |
| [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 |
| [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 |
| [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 |
| [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 |
## Autres limites d'utilisation