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.
# AWS IoT Core Emplacement de l'appareil
| |
| --- |
| Avant d'utiliser la fonction de localisation de l' AWS IoT Core appareil, consultez les conditions générales de cette fonctionnalité. Notez que les paramètres de votre demande de recherche de géolocalisation, tels que les données de localisation utilisées pour effectuer les recherches, et d'autres informations AWS peuvent être transmises au fournisseur de données tiers que vous avez choisi, qui peuvent être autres Région AWS que celui que vous utilisez actuellement. Le fournisseur tiers et le solveur à utiliser sont choisis en fonction de la charge utile d'entrée reçue. Pour plus d'informations, consultez [Conditions de service AWS](https://aws.amazon.com/service-terms). |
Utilisez la localisation des AWS IoT Core appareils pour tester l'emplacement de vos appareils IoT à l'aide de solveurs tiers. Les *solveurs* sont des algorithmes fournis par des fournisseurs tiers qui résolvent les données de mesure et estiment l'emplacement de votre appareil. En identifiant l'emplacement de vos appareils, vous pouvez les suivre et les déboguer sur le terrain pour résoudre les problèmes éventuels.
Les données de mesure collectées à partir de diverses sources sont résolues et les informations de géolocalisation sont rapportées sous forme de charge utile [GeoJSON.](https://geojson.org/) Le format GeoJSON est un format utilisé pour coder les structures de données géographiques. La charge utile contient les coordonnées de latitude et de longitude de l'emplacement de votre appareil, qui sont basées sur le système de [coordonnées du système géodésique mondial](https://gisgeography.com/wgs84-world-geodetic-system/) (). WGS84
**Topics**
+ [Types de mesures et solveurs](#location-measurement-types)
+ [Comment fonctionne la localisation des AWS IoT Core appareils](#location-how-works)
+ [Comment utiliser la localisation de AWS IoT Core l'appareil](#location-how-use)
+ [Résolution de la localisation des appareils IoT](device-location-resolve-solvers.md)
+ [Résolution de la localisation de l'appareil à l'aide des AWS IoT Core rubriques MQTT relatives à la localisation](device-location-reserved-topics.md)
+ [Solveurs de localisation et charge utile de l'appareil](device-location-solvers-payload.md)
## Types de mesures et solveurs
AWS IoT Core Device Location s'associe à des fournisseurs tiers pour résoudre les données de mesure et fournir une estimation de l'emplacement de l'appareil. Le tableau suivant indique les types de mesures et les résolveurs de localisation tiers, ainsi que des informations sur les appareils pris en charge. Pour plus d'informations sur les périphériques LoRa WAN et la configuration de leur emplacement, voir [Configuration de la position des ressources LoRa WAN](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html).
**Note**
Les appareils IoT généraux et les appareils Sidewalk peuvent utiliser les rubriques MQTT de localisation des appareils pour obtenir les informations de localisation. Pour les types de mesure d'adresses Wi-Fi, cellulaire et IP, si les appareils publient les données de mesure dans les [rubriques réservées](device-location-reserved-topics.md) au format GeoJSON défini, l'emplacement du AWS IoT Core périphérique peut résoudre la position de l'appareil. Pour le type de mesure GNSS, l'appareil doit disposer de la LR11xx puce permettant de scanner les données de mesure afin d'obtenir les informations de localisation résolues à l'aide du solveur GNSS. Pour plus d'informations sur l'obtention d'informations de localisation pour les périphériques LoRa WAN, consultez [la section Configuration de la position des ressources LoRa WAN](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) dans la *documentation sur le AWS IoT réseau sans fil*.
**Types de mesures et solveurs**
| Type de mesure | Solveurs tiers | Appareils pris en charge |
| --- | --- | --- |
| Points d'accès Wi-Fi | Solveur basé sur le Wi-Fi | Appareils IoT généraux, LoRa WAN et appareils Amazon Sidewalk |
| Tours de téléphonie cellulaire : données GSM, LTE, CDMA, SCDMA, WCMDA et TD-SCDMA | Solveur cellulaire | Appareils IoT généraux, LoRa WAN et appareils Amazon Sidewalk |
| Adresse IP | Solveur de recherche inversée IP | Tout appareil IoT connecté via TCP/IP |
| Données de numérisation GNSS (messages NAV) | solveur GNSS | Appareils IoT généraux, LoRa WAN et appareils Amazon Sidewalk |
| Bluetooth Low Energy (BLE) | Solveur basé sur BLE | Appareils Amazon Sidewalk |
Pour plus d'informations sur les solveurs de localisation et des exemples illustrant la charge utile de l'appareil pour les différents types de mesures, consultez [Solveurs de localisation et charge utile de l'appareil](device-location-solvers-payload.md).
## Comment fonctionne la localisation des AWS IoT Core appareils
Le schéma suivant montre comment AWS IoT Core Device Location collecte les données de mesure et résout les informations de localisation de vos appareils.
![\[Image montrant comment la localisation de l' AWS IoT Core appareil utilise vos données de mesure brutes et résout la position de l'appareil.\]](http://docs.aws.amazon.com/fr_fr/iot/latest/developerguide/images/iot-device-location.png)
Les étapes suivantes montrent comment fonctionne la localisation de l' AWS IoT Core appareil.
1.
**Recevoir des données de mesure**
Les données de mesure brutes relatives à l'emplacement de votre appareil sont d'abord envoyées depuis l'appareil. Les données de mesure sont spécifiées sous forme de charge utile JSON.
1.
**Données de mesure de processus**
Les données de mesure sont traitées et AWS IoT Core Device Location choisit les données de mesure à utiliser, qui peuvent être des informations Wi-Fi, cellulaires, de scan GNSS ou d'adresse IP.
1.
**Choisissez un solveur**
Le solveur tiers est choisi en fonction des données de mesure. Par exemple, si les données de mesure contiennent des informations sur le Wi-Fi et l'adresse IP, il choisit le solveur Wi-Fi et le solveur de recherche inversée IP.
1.
**Obtenir un emplacement résolu**
Une demande d'API est envoyée aux fournisseurs de solveur pour leur demander de résoudre l'emplacement. AWS IoT Core Device Location obtient ensuite les informations de géolocalisation estimées auprès des solveurs.
1.
**Choisissez l'emplacement résolu**
Les informations de localisation résolues et leur exactitude sont comparées, et AWS IoT Core Device Location choisit les résultats de géolocalisation avec la plus grande précision.
1.
**Informations sur l'emplacement de sortie**
Les informations de géolocalisation vous sont envoyées sous forme de charge utile GeoJSON. La charge utile contient les WGS84 coordonnées géographiques, les informations de précision, les niveaux de confiance et l'horodatage auquel l'emplacement résolu a été obtenu.
## Comment utiliser la localisation de AWS IoT Core l'appareil
Les étapes suivantes montrent comment utiliser la localisation de AWS IoT Core l'appareil.
1.
**Fournir des données de mesure**
Spécifiez les données de mesure brutes relatives à l'emplacement de votre appareil sous forme de charge utile JSON. Pour récupérer les données de mesure de la charge utile, accédez aux journaux de votre appareil ou utilisez CloudWatch Logs et copiez les informations relatives aux données de charge utile. La charge utile JSON doit contenir un ou plusieurs types de mesure de données. Pour des exemples illustrant le format de charge utile de différents solveurs, consultez [Solveurs de localisation et charge utile de l'appareil](device-location-solvers-payload.md).
1.
**Résoudre les informations de localisation**
À l'aide de la page de [localisation de l'appareil](https://console.aws.amazon.com/iot/home#/device-location-test) de la AWS IoT console ou de l'opération [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API, transmettez les données de mesure de la charge utile et déterminez l'emplacement de l'appareil. AWS IoT Core Device Location choisit ensuite le solveur le plus précis et indique l'emplacement de l'appareil. Pour de plus amples informations, veuillez consulter [Résolution de la localisation des appareils IoT](device-location-resolve-solvers.md).
1.
**Copier les informations de localisation**
Vérifiez les informations de géolocalisation qui ont été résolues par AWS IoT Core Device Location et signalées sous forme de charge utile GeoJSON. Vous pouvez copier la charge utile pour l'utiliser avec vos applications et d'autres applications Service AWS. Par exemple, vous pouvez envoyer vos données de localisation géographique à Amazon Location Service à l'aide de l'action de [Location](location-rule-action.md) AWS IoT règle.
Les rubriques suivantes montrent comment utiliser la localisation des AWS IoT Core appareils et des exemples de charge utile de localisation des appareils.
+ [Résolution de la localisation des appareils IoT](device-location-resolve-solvers.md)
+ [Solveurs de localisation et charge utile de l'appareil](device-location-solvers-payload.md)
# Résolution de la localisation des appareils IoT
Utilisez la localisation de l' AWS IoT Core appareil pour décoder les données de mesure de vos appareils et déterminez l'emplacement de l'appareil à l'aide de solveurs tiers. L'emplacement résolu est généré sous forme de charge utile GeoJSON avec les coordonnées géographiques et les informations de précision. Vous pouvez déterminer l'emplacement de votre appareil à partir de la AWS IoT console, de l'API AWS IoT sans fil ou AWS CLI.
**Topics**
+ [Résolution de la localisation de l'appareil (console)](#location-resolve-console)
+ [Résolution de la localisation de l'appareil (API)](#location-resolve-api)
+ [Résolution des erreurs lors de la résolution de l'emplacement](#location-resolve-troubleshoot)
## Résolution de la localisation de l'appareil (console)
Pour résoudre l'emplacement de l'appareil (console)
1. Accédez à la page de [localisation de l'appareil](https://console.aws.amazon.com/iot/home#/device-location-test) dans la AWS IoT console.
1. Obtenez les données de mesure de la charge utile à partir des journaux de votre appareil ou CloudWatch des journaux, et saisissez-les dans la section **Position de résolution via la charge utile**.
Le code suivant montre un exemple de charge utile JSON. La charge utile contient des données de mesure cellulaires et Wi-Fi. Si votre charge utile contient d'autres types de données de mesure, le solveur le plus précis sera utilisé. Pour plus d’informations et des exemples de charges utiles, consultez [Solveurs de localisation et charge utile de l'appareil](device-location-solvers-payload.md).
**Note**
La charge utile JSON doit contenir au moins un type de données de mesure.
```
{
"Timestamp": 1664313161,
"Ip":{
"IpAddress": "54.240.198.35"
},
"WiFiAccessPoints": [{
"MacAddress": "A0:EC:F9:1E:32:C1",
"Rss": -77
}],
"CellTowers": {
"Gsm": [{
"Mcc": 262,
"Mnc": 1,
"Lac": 5126,
"GeranCid": 16504,
"GsmLocalId": {
"Bsic": 6,
"Bcch": 82
},
"GsmTimingAdvance": 1,
"RxLevel": -110,
"GsmNmr": [{
"Bsic": 7,
"Bcch": 85,
"RxLevel": -100,
"GlobalIdentity": {
"Lac": 1,
"GeranCid": 1
}
}]
}],
"Wcdma": [{
"Mcc": 262,
"Mnc": 7,
"Lac": 65535,
"UtranCid": 14674663,
"WcdmaNmr": [{
"Uarfcndl": 10786,
"UtranCid": 14674663,
"Psc": 149
},
{
"Uarfcndl": 10762,
"UtranCid": 14674663,
"Psc": 211
}
]
}],
"Lte": [{
"Mcc": 262,
"Mnc": 2,
"EutranCid": 2898945,
"Rsrp": -50,
"Rsrq": -5,
"LteNmr": [{
"Earfcn": 6300,
"Pci": 237,
"Rsrp": -60,
"Rsrq": -6,
"EutranCid": 2898945
},
{
"Earfcn": 6300,
"Pci": 442,
"Rsrp": -70,
"Rsrq": -7,
"EutranCid": 2898945
}
]
}]
}
}
```
1. Pour résoudre les informations de localisation, choisissez **Résoudre**.
Les informations de localisation sont de type blob et renvoyées sous forme de charge utile utilisant le format GeoJSON, qui est un format utilisé pour coder les structures de données géographiques. La charge utile contient :
+ Les WGS84 coordonnées géographiques, qui incluent les informations de latitude et de longitude. Il peut également inclure une information d'altitude.
+ Type d'informations de localisation signalées, telles que **Point**. Un type d'emplacement de point représente l'emplacement sous forme de WGS84 latitude et de longitude, codé sous forme de point [GeoJSON](https://geojson.org/geojson-spec.html#point).
+ Les informations de précision horizontale et verticale, qui indiquent la différence, en mètres, entre les informations de localisation estimées par les solveurs et l'emplacement réel de l'appareil.
+ Le niveau de confiance, qui indique l'incertitude de la réponse à l'estimation de l'emplacement. La valeur par défaut est 0,68, ce qui indique une probabilité de 68 % que l'emplacement réel de l'appareil se situe dans le rayon d'incertitude de l'emplacement estimé.
+ Ville, État, pays et code postal où se trouve l'appareil. Ces informations ne seront communiquées que lorsque le solveur de recherche inversée IP est utilisé.
+ Les informations d'horodatage, qui correspondent à la date et à l'heure auxquelles la localisation a été résolue. Il utilise le format d'horodatage Unix.
Le code suivant montre un exemple de charge utile GeoJSON renvoyée en résolvant l'emplacement.
**Note**
Si AWS IoT Core l'emplacement de l'appareil signale des erreurs lors de la tentative de résolution de la localisation, vous pouvez résoudre les erreurs et résoudre la localisation. Pour de plus amples informations, veuillez consulter [Résolution des erreurs lors de la résolution de l'emplacement](#location-resolve-troubleshoot).
```
{
"coordinates": [
13.376076698303223,
52.51823043823242
],
"type": "Point",
"properties": {
"verticalAccuracy": 45,
"verticalConfidenceLevel": 0.68,
"horizontalAccuracy": 303,
"horizontalConfidenceLevel": 0.68,
"country": "USA",
"state": "CA",
"city": "Sunnyvalue",
"postalCode": "91234",
"timestamp": "2022-11-18T12:23:58.189Z"
}
}
```
1. Accédez à la section **Emplacement des ressources** et vérifiez les informations de géolocalisation indiquées par AWS IoT Core Device Location. Vous pouvez copier la charge utile pour l'utiliser avec d'autres applications et Service AWS s. Par exemple, vous pouvez utiliser [Location](location-rule-action.md) pour envoyer vos données de localisation géographique à Amazon Location Service.
## Résolution de la localisation de l'appareil (API)
Pour déterminer l'emplacement de l'appareil à l'aide de l'API AWS IoT sans fil, utilisez l'opération [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API ou la commande [get-position-estimate](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position-estimate.html)CLI. Spécifiez les données de mesure de la charge utile en entrée et exécutez l'opération API pour déterminer l'emplacement de l'appareil.
**Note**
L'opération `GetPositionEstimate` API ne stocke aucune information sur l’appareil ou l’état et ne peut pas être utilisée pour récupérer des données de localisation historiques. Il effectue une opération unique qui résout les données de mesure et produit l'emplacement estimé. Pour récupérer les informations de localisation, vous devez spécifier les informations de charge utile chaque fois que vous effectuez cette opération d'API.
La commande suivante montre un exemple de la marche à suivre pour résoudre l'emplacement à l'aide de cette opération d'API.
**Note**
Lorsque vous exécutez la commande CLI `get-position-estimate`, vous devez spécifier le fichier JSON de sortie comme première entrée. Ce fichier JSON stockera les informations de localisation estimées obtenues en réponse à la CLI au format GeoJSON. Par exemple, la commande suivante enregistre les informations de localisation dans le *locationout.json* fichier.
```
aws iotwireless get-position-estimate locationout.json \
--ip IpAddress=""54.240.198.35"" \
--wi-fi-access-points \
MacAddress="A0:EC:F9:1E:32:C1",Rss=-75 \
MacAddress="A0:EC:F9:15:72:5E",Rss=-67
```
Cet exemple inclut à la fois les points d'accès Wi-Fi et l'adresse IP comme types de mesure. AWS IoT Core L'emplacement de l'appareil choisit entre le solveur Wi-Fi et le solveur de recherche inversée IP, et le solveur est sélectionné avec la plus grande précision.
L'emplacement résolu est renvoyé sous forme de charge utile qui utilise le format GeoJSON, qui est un format utilisé pour coder les structures de données géographiques. Il est ensuite enregistré dans le *locationout.json* fichier. La charge utile contient les coordonnées de WGS84 latitude et de longitude, les informations de précision et de niveau de confiance, le type de données de localisation et l'horodatage auquel la position a été résolue.
```
{
"coordinates": [
13.37704086303711,
52.51865005493164
],
"type": "Point",
"properties": {
"verticalAccuracy": 707,
"verticalConfidenceLevel": 0.68,
"horizontalAccuracy": 389,
"horizontalConfidenceLevel": 0.68,
"country": "USA",
"state": "CA",
"city": "Sunnyvalue",
"postalCode": "91234",
"timestamp": "2022-11-18T14:03:57.391Z"
}
}
```
## Résolution des erreurs lors de la résolution de l'emplacement
Lorsque vous tentez de résoudre l'emplacement, l'un des codes d'erreur suivants peut s'afficher. AWS IoT Core L'emplacement du périphérique peut générer une erreur lors de l'utilisation de l'`GetPositionEstimate`API, ou bien faire référence au numéro de ligne correspondant à l'erreur dans la AWS IoT console.
+
**Erreur 400**
Cette erreur indique que le format de la charge utile de l'appareil JSON ne peut pas être validé par AWS IoT Core Device Location. L'erreur peut se produire pour les raisons suivantes :
+ Les données de mesure JSON ne sont pas formatées correctement.
+ La charge utile contient uniquement les informations d'horodatage.
+ Les paramètres des données de mesure, tels que l'adresse IP, ne sont pas valides.
Pour résoudre cette erreur, vérifiez si votre fichier JSON est correctement formaté et s'il contient des données provenant d'un ou de plusieurs types de mesures en entrée. Si l'adresse IP n'est pas valide, pour plus d'informations sur la manière dont vous pouvez fournir une adresse IP valide pour résoudre l'erreur, consultez [Solveur de recherche inversée IP](device-location-solvers-payload.md#location-solvers-ip).
+
**Erreur 403**
Cette erreur indique que vous n'êtes pas autorisé à effectuer l'opération d'API ou à utiliser la AWS IoT console pour récupérer l'emplacement de l'appareil. Pour résoudre cette erreur, vérifiez que vous disposez des autorisations requises pour effectuer cette action. Cette erreur peut se produire si votre AWS Management Console session ou votre jeton de AWS CLI session a expiré. Pour résoudre cette erreur, actualisez le jeton de session pour l'utiliser AWS CLI, ou déconnectez-vous du, AWS Management Console puis connectez-vous à l'aide de vos informations d'identification.
+
**Erreur 404**
Cette erreur indique qu'aucune information de localisation n'a été trouvée ou résolue par AWS IoT Core Device Location. L'erreur peut être due à des cas tels que l'insuffisance des données lors de la saisie des données de mesure. Par exemple :
+ L'adresse MAC ou les informations de la tour cellulaire ne sont pas complètes.
+ L'adresse IP n'est pas disponible pour rechercher et récupérer l'emplacement.
+ La charge utile du GNSS n'est pas suffisante.
Pour résoudre l'erreur dans de tels cas, vérifiez si vos données de mesure contiennent suffisamment d'informations nécessaires pour localiser l'appareil.
+
**Erreur 500**
Cette erreur indique qu'une exception interne au serveur s'est produite lorsque AWS IoT Core Device Location a tenté de résoudre l'emplacement. Pour tenter de corriger cette erreur, actualisez la session et réessayez d'envoyer les données de mesure à résoudre.
# Résolution de la localisation de l'appareil à l'aide des AWS IoT Core rubriques MQTT relatives à la localisation
Vous pouvez utiliser des sujets MQTT réservés pour obtenir les dernières informations de localisation de vos appareils grâce à la fonction de localisation des AWS IoT Core appareils.
## Format des rubriques MQTT relatives à la localisation des appareils
Les rubriques réservées pour la localisation des AWS IoT Core appareils utilisent le préfixe suivant :
`$aws/device_location/{customer_device_id}/`
Pour créer une rubrique complète, remplacez `customer_device_id` par votre identifiant unique que vous utilisez pour identifier votre appareil. Nous vous recommandons de spécifier le`WirelessDeviceId`, par exemple pour les appareils LoRa WAN et Sidewalk`thingName`, et si votre appareil est enregistré en tant qu' AWS IoT objet. Vous ajoutez ensuite la rubrique avec le stub de rubrique, tel que `get_position_estimate` ou `get_position_estimate/accepted` comme indiqué dans la section suivante.
**Note**
Le `{customer_device_id}` ne peut contenir que des lettres, des chiffres et des tirets. Lorsque vous vous abonnez à des rubriques relatives à la localisation des appareils, vous ne pouvez utiliser le signe plus (\$1) que comme caractère générique. Par exemple, vous pouvez utiliser le caractère `+` générique pour `{customer_device_id}` pour obtenir les informations de localisation de vos appareils. Lorsque vous vous abonnez à la rubrique `$aws/device_location/+/get_position_estimate/accepted`, un message contenant les informations de localisation des appareils correspondant à n'importe quel identifiant d'appareil est publié si le problème a été résolu avec succès.
Les rubriques réservées utilisées pour interagir avec la localisation de l' AWS IoT Core appareil sont les suivantes.
**Format des rubriques MQTT de Device location**
| Rubrique | Opérations autorisées | Description |
| --- | --- | --- |
| \$1aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | Publication | Un appareil publie dans cette rubrique pour obtenir les données de mesure brutes numérisées à résoudre en fonction de l'emplacement de AWS IoT Core l'appareil. |
| \$1aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | S’abonner | AWS IoT Core La localisation de l'appareil publie les informations de localisation dans cette rubrique lorsqu'elle résout avec succès la localisation de l'appareil. |
| \$1aws/device\$1location/ /get\$1position\$1estimate/rejeté *customer\$1device\$1id* | S’abonner | AWS IoT Core L'emplacement du périphérique publie les informations d'erreur dans cette rubrique lorsqu'il ne parvient pas à résoudre l'emplacement du périphérique. |
## Rubriques MQTT relatives à la politique de localisation des appareils
Pour recevoir des messages provenant de sujets relatifs à la localisation de l'appareil, celui-ci doit utiliser une politique lui permettant de se connecter à la passerelle de l' AWS IoT appareil et de s'abonner aux sujets MQTT.
Voici un exemple de la politique requise pour recevoir des messages pour les différentes rubriques.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Publish"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/accepted",
"arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/rejected"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Subscribe"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/accepted",
"arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/rejected"
]
}
]
}
```
## Sujets relatifs à la localisation des appareils et charge utile
Vous trouverez ci-dessous les rubriques relatives à la localisation des AWS IoT Core appareils, le format de la charge utile des messages et un exemple de politique pour chaque rubrique.
**Topics**
+ [/get\$1position\$1estimate](#get-position-estimate)
+ [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted)
+ [/get\$1position\$1estimate/rejeté](#get-position-estimate-rejected)
### /get\$1position\$1estimate
Publiez un message dans cette rubrique pour obtenir les données de mesure brutes de l'appareil à résoudre en fonction de l'emplacement de AWS IoT Core l'appareil.
```
$aws/device_location/customer_device_id/get_position_estimate
```
AWS IoT Core Device Location répond en publiant sur l'un [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted) ou l'autre[/get\$1position\$1estimate/rejeté](#get-position-estimate-rejected).
**Note**
Le message publié dans cette rubrique doit être une charge utile JSON valide. Si le message d'entrée n'est pas au format JSON valide, vous n'obtiendrez aucune réponse. Pour plus d’informations, consultez [Message payload](#get-position-estimate-payload). (Charge utile du message)
#### Charge utile du message
Le format de charge utile du message suit une structure similaire à celle du corps de la demande d'opération de l'API AWS IoT Wireless, [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html). Il contient :
+ Chaîne facultative `Timestamp`, qui correspond à la date et à l'heure de résolution de l'emplacement. La chaîne `Timestamp` peut avoir une longueur minimale de 1 et une longueur maximale de 10.
+ Chaîne facultative `MessageId`, qui peut être utilisée pour mapper la demande à la réponse. Si vous spécifiez cette chaîne, le message publié dans les rubriques `get_position_estimate/accepted` ou `get_position_estimate/rejected` contiendra ce `MessageId`. La chaîne `MessageID` peut avoir une longueur minimale de 1 et une longueur maximale de 256.
+ Les données de mesure de l'appareil qui contient un ou plusieurs des types de mesure suivants :
+ [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html)
+ [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CellTowers.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CellTowers.html)
+ [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Ip.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Ip.html)
+ [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Gnss.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Gnss.html)
Ce qui suit montre un exemple de charge utile de message.
```
{
"Timestamp": "1664313161",
"MessageId": "ABCD1",
"WiFiAccessPoints": [
{
"MacAddress": "A0:EC:F9:1E:32:C1",
"Rss": -66
}
],
"Ip":{
"IpAddress": "54.192.168.0"
},
"Gnss":{
"Payload":"8295A614A2029517F4F77C0A7823B161A6FC57E25183D96535E3689783F6CA48",
"CaptureTime":1354393948
}
}
```
#### Exemple de stratégie
Voici un exemple de document de stratégie requise :
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Publish"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate"
]
}
]
}
```
### /get\$1position\$1estimate/accepted
AWS IoT Core L'emplacement de l'appareil publie une réponse à cette rubrique lorsque vous renvoyez les informations de localisation résolues pour votre appareil. Les informations de localisation sont renvoyées en [format GeoJSON](https://geojson.org/).
```
$aws/device_location/customer_device_id/get_position_estimate/accepted
```
Vous trouverez ci-dessous la charge utile des messages et un exemple de politique.
#### Charge utile du message
Voici un exemple de la charge utile du message au format GeoJSON. Si vous avez spécifié un `MessageId` dans vos données de mesure brutes et que AWS IoT Core Device Location a résolu les informations de localisation avec succès, la charge utile du message renvoie les mêmes `MessageId` informations.
```
{
"coordinates": [
13.37704086303711,
52.51865005493164
],
"type": "Point",
"properties": {
"verticalAccuracy": 707,
"verticalConfidenceLevel": 0.68,
"horizontalAccuracy": 389,
"horizontalConfidenceLevel": 0.68,
"country": "USA",
"state": "CA",
"city": "Sunnyvalue",
"postalCode": "91234",
"timestamp": "2022-11-18T14:03:57.391Z",
"messageId": "ABCD1"
}
}
```
#### Exemple de stratégie
Voici un exemple de document de stratégie requise :
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Subscribe"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/accepted"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/accepted"
]
}
]
}
```
### /get\$1position\$1estimate/rejeté
AWS IoT Core L'emplacement de l'appareil publie une réponse d'erreur à cette rubrique lorsqu'il ne parvient pas à résoudre l'emplacement de l'appareil.
```
$aws/device_location/customer_device_id/get_position_estimate/rejected
```
Vous trouverez ci-dessous la charge utile des messages et exemple de politique. Pour plus d'informations sur les erreurs, consultez [Résolution des erreurs lors de la résolution de l'emplacement](device-location-resolve-solvers.md#location-resolve-troubleshoot).
#### Charge utile du message
Voici un exemple de charge utile du message qui fournit le code d'erreur et le message, qui indiquent pourquoi AWS IoT Core Device Location n'a pas réussi à résoudre les informations de localisation. Si vous avez spécifié un `MessageId` lorsque vous avez fourni vos données de mesure brutes et que l'emplacement de l' AWS IoT Core appareil n'a pas résolu les informations de localisation, les mêmes `MessageId` informations seront renvoyées dans la charge utile du message.
```
{
"errorCode": 500,
"errorMessage":"Internal server error",
"messageId": "ABCD1"
}
```
#### Exemple de stratégie
Voici un exemple de document de stratégie requise :
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Subscribe"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/rejected"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/rejected"
]
}
]
}
```
# Solveurs de localisation et charge utile de l'appareil
Les solveurs de localisation sont des algorithmes qui peuvent être utilisés pour déterminer la position de vos appareils IoT. AWS IoT Core Device Location prend en charge les solveurs de localisation suivants. Vous verrez des exemples du format de charge utile JSON pour ces types de mesures, les appareils pris en charge par le solveur et la manière dont la localisation est résolue.
Pour déterminer l'emplacement de l'appareil, spécifiez un ou plusieurs de ces types de données de mesure. Une position unique et résolue sera renvoyée pour toutes les données de mesure combinées.
**Topics**
+ [Solveur basé sur le Wi-Fi](#location-solvers-wifi)
+ [Solveur cellulaire](#location-solvers-cellular)
+ [Solveur de recherche inversée IP](#location-solvers-ip)
+ [solveur GNSS](#location-solvers-gnss)
+ [Solveur BLE pour appareils compatibles Amazon Sidewalk](#location-solvers-ble)
## Solveur basé sur le Wi-Fi
Utilisez le solveur basé sur le Wi-Fi pour déterminer la position à l'aide des informations de numérisation provenant des points d'accès Wi-Fi. Le solveur prend en charge la technologie WLAN et peut être utilisé pour calculer l'emplacement des appareils IoT généraux connectés via TCP/IP, des appareils sans fil LoRa WAN et des appareils compatibles Amazon Sidewalk.
Les appareils LoRa WAN doivent être équipés du chipset LoRa Edge, qui peut décoder les informations de numérisation Wi-Fi entrantes. LoRa Edge est une plate-forme à très faible consommation qui intègre un LoRa émetteur-récepteur longue portée, un scanner GNSS multi-constellations et un scanner MAC Wi-Fi passif ciblant les applications de géolocalisation. Lorsqu'un message de liaison montante est reçu de l'appareil, les données de numérisation Wi-Fi sont envoyées à l'emplacement de l' AWS IoT Core appareil, et l'emplacement est estimé sur la base des résultats du scan Wi-Fi. Les informations décodées sont ensuite transmises au solveur basé sur le Wi-Fi pour récupérer les informations de localisation.
Pour en savoir plus sur la résolution des données de localisation pour les appareils compatibles Amazon Sidewalk, consultez le [guide AWS IoT Core pour Amazon Sidewalk du développeur](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/iot-sidewalk.html).
### Exemple de charge utile d'un solveur basé sur le Wi-Fi
Le code suivant montre un exemple de la charge utile JSON provenant de l'appareil qui contient les données de mesure. Lorsque AWS IoT Core Device Location reçoit ces données en entrée, il envoie une requête HTTP au fournisseur du solveur pour résoudre les informations de localisation. Pour récupérer les informations, spécifiez les valeurs de l'adresse MAC et du flux RSS (intensité du signal reçu). Pour ce faire, fournissez la charge utile JSON en utilisant ce format ou utilisez le paramètre [WiFiAccessPointsobject](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html) de l'opération d'[GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API.
```
{
"Timestamp": 1664313161, // optional
"WiFiAccessPoints": [
{
"MacAddress": "A0:EC:F9:1E:32:C1", // required
"Rss": -75 // required
}
]
}
```
## Solveur cellulaire
Vous pouvez utiliser le solveur cellulaire pour déterminer l'emplacement à l'aide des données de mesure obtenues à partir des pylônes de téléphonie cellulaire. Le solveur prend en charge les technologies suivantes. Une seule information de localisation résolue est obtenue, même si vous incluez des données de mesure issues de l'une ou de l'ensemble de ces technologies.
+ GSM
+ CDMA
+ WCDMA
+ TD-SCDMA
+ LTE
### Exemples de charge utile d'un solveur cellulaire
Le code suivant montre des exemples de charge utile JSON de l'appareil qui contient des données de mesure cellulaire. Lorsque AWS IoT Core Device Location reçoit ces données en entrée, il envoie une requête HTTP au fournisseur du solveur pour résoudre les informations de localisation. Pour récupérer les informations, vous devez soit fournir la charge utile JSON en utilisant ce format dans la console, soit spécifier des valeurs pour le [CellTowers](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-CellTowers)paramètre de l'opération d'[GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API. Vous pouvez fournir les données de mesure en spécifiant les valeurs des paramètres à l'aide de l'une ou de l'ensemble de ces technologies cellulaires.
#### LTE (évolution à long terme)
Lorsque vous utilisez ces données de mesure, vous devez spécifier des informations telles que le réseau et le code du pays du réseau mobile, ainsi que des paramètres supplémentaires facultatifs, notamment des informations sur l'identifiant local. Le code suivant montre un exemple du format de charge utile. Pour plus d'informations sur ces paramètres, consultez [LTE object](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_LteObj.html). (Objet LTE)
```
{
"Timestamp": 1664313161, // optional
"CellTowers": {
"Lte": [
{
"Mcc": int, // required
"Mnc": int, // required
"EutranCid": int, // required. Make sure that you use int for EutranCid.
"Tac": int, // optional
"LteLocalId": { // optional
"Pci": int, // required
"Earfcn": int, // required
},
"LteTimingAdvance": int, // optional
"Rsrp": int, // optional
"Rsrq": float, // optional
"NrCapable": boolean, // optional
"LteNmr": [ // optional
{
"Pci": int, // required
"Earfcn": int, // required
"EutranCid": int, // required
"Rsrp": int, // optional
"Rsrq": float // optional
}
]
}
]
}
}
```
#### GSM (Système mondial de communications mobiles)
Lorsque vous utilisez ces données de mesure, vous devez spécifier des informations telles que le réseau et le code pays du réseau mobile, les informations de la station de base et des paramètres supplémentaires facultatifs. Le code suivant montre un exemple du format de charge utile. Pour plus d'informations sur ces paramètres, consultez [GSM object](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GsmObj.html). (Objet GSM)
```
{
"Timestamp": 1664313161, // optional
"CellTowers": {
"Gsm": [
{
"Mcc": int, // required
"Mnc": int, // required
"Lac": int, // required
"GeranCid": int, // required
"GsmLocalId": { // optional
"Bsic": int, // required
"Bcch": int, // required
},
"GsmTimingAdvance": int, // optional
"RxLevel": int, // optional
"GsmNmr": [ // optional
{
"Bsic": int, // required
"Bcch": int, // required
"RxLevel": int, // optional
"GlobalIdentity": {
"Lac": int, // required
"GeranCid": int // required
}
}
]
}
]
}
```
#### CDMA (accès multiple par division de code)
Lorsque vous utilisez ces données de mesure, vous devez spécifier des informations telles que la puissance du signal et les informations d'identification, les informations de la station de base et des paramètres supplémentaires facultatifs. Le code suivant montre un exemple du format de charge utile. Pour plus d'informations sur ces paramètres, consultez [CDMA object](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). (Objet CDMA)
```
{
"Timestamp": 1664313161, // optional
"CellTowers": {
"Cdma": [
{
"SystemId": int, // required
"NetworkId": int, // required
"BaseStationId": int, // required
"RegistrationZone": int, // optional
"CdmaLocalId": { // optional
"PnOffset": int, // required
"CdmaChannel": int, // required
},
"PilotPower": int, // optional
"BaseLat": float, // optional
"BaseLng": float, // optional
"CdmaNmr": [ // optional
{
"PnOffset": int, // required
"CdmaChannel": int, // required
"PilotPower": int, // optional
"BaseStationId": int // optional
}
]
}
]
}
}
```
#### WCDMA (Wideband code-division multiple access)/ (accès multiple par répartition en code à large bande)
Lorsque vous utilisez ces données de mesure, vous devez spécifier des informations telles que le code du réseau et du pays, la puissance du signal et les informations d'identification, les informations de la station de base et des paramètres supplémentaires facultatifs. Le code suivant montre un exemple du format de charge utile. Pour plus d'informations sur ces paramètres, consultez [CDMA object](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). (Objet CDMA)
```
{
"Timestamp": 1664313161, // optional
"CellTowers": {
"Wcdma": [
{
"Mcc": int, // required
"Mnc": int, // required
"UtranCid": int, // required
"Lac": int, // optional
"WcdmaLocalId": { // optional
"Uarfcndl": int, // required
"Psc": int, // required
},
"Rscp": int, // optional
"Pathloss": int, // optional
"WcdmaNmr": [ // optional
{
"Uarfcndl": int, // required
"Psc": int, // required
"UtranCid": int, // required
"Rscp": int, // optional
"Pathloss": int, // optional
}
]
}
]
}
}
```
#### TD-SCDMA (Time division synchronous code-division multiple access)/ (accès multiple synchrone par répartition dans le temps par code)
Lorsque vous utilisez ces données de mesure, vous devez spécifier des informations telles que le code du réseau et du pays, la puissance du signal et les informations d'identification, les informations de la station de base et des paramètres supplémentaires facultatifs. Le code suivant montre un exemple du format de charge utile. Pour plus d'informations sur ces paramètres, consultez [CDMA object](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). (Objet CDMA)
```
{
"Timestamp": 1664313161, // optional
"CellTowers": {
"Tdscdma": [
{
"Mcc": int, // required
"Mnc": int, // required
"UtranCid": int, // required
"Lac": int, // optional
"TdscdmaLocalId": { // optional
"Uarfcn": int, // required
"CellParams": int, // required
},
"TdscdmaTimingAdvance": int, // optional
"Rscp": int, // optional
"Pathloss": int, // optional
"TdscdmaNmr": [ // optional
{
"Uarfcn": int, // required
"CellParams": int, // required
"UtranCid": int, // optional
"Rscp": int, // optional
"Pathloss": int, // optional
}
]
}
]
}
}
```
## Solveur de recherche inversée IP
Vous pouvez utiliser le solveur de recherche inversée IP pour déterminer l'emplacement en utilisant l'adresse IP comme entrée. Le solveur peut obtenir les informations de localisation à partir des appareils qui ont été approvisionnés. AWS IoT Spécifiez les informations d'adresse IP en utilisant un format qui est IPv4 soit le modèle IPv6 standard, soit le modèle compressé IPv6 hexadécimal. Vous obtenez ensuite l'estimation de localisation résolue, y compris des informations supplémentaires telles que la ville et le pays où se trouve l'appareil.
**Note**
En utilisant la recherche inversée d'adresse IP, vous acceptez de ne pas l'utiliser dans le but d'identifier ou de localiser une adresse résidentielle ou municipale spécifique.
### Exemple de charge utile d'un solveur de recherche inversée IP
Le code suivant montre un exemple de la charge utile JSON provenant de l'appareil qui contient les données de mesure. Lorsque AWS IoT Core Device Location reçoit les informations d'adresse IP contenues dans les données de mesure, il recherche ces informations dans la base de données du fournisseur du solveur, qui est ensuite utilisée pour résoudre les informations de localisation. Pour récupérer les informations, fournissez la charge utile JSON en utilisant ce format ou spécifiez des valeurs pour le paramètre [Ip](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Ip) de l'opération d'[GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API.
**Note**
Lorsque ce solveur est utilisé, la ville, l'État, le pays et le code postal où se trouve l'appareil sont également indiqués en plus des coordonnées. Pour obtenir un exemple, consultez [Résolution de la localisation de l'appareil (console)](device-location-resolve-solvers.md#location-resolve-console).
```
{
"Timestamp": 1664313161,
"Ip":{
"IpAddress":"54.240.198.35"
}
}
```
## solveur GNSS
Utilisez le solveur GNSS (Global Navigation Satellite System) pour récupérer l'emplacement de l'appareil à l'aide des informations contenues dans les messages de résultats du scan GNSS ou les messages NAV. Vous pouvez éventuellement fournir des informations d'assistance GNSS supplémentaires, ce qui réduit le nombre de variables que le solveur doit utiliser pour rechercher des signaux. En fournissant ces informations d'assistance, qui incluent la position, l'altitude, le temps de capture et les informations de précision, le solveur peut facilement identifier les satellites en vue et calculer la position de l'appareil.
Ce solveur peut être utilisé avec des appareils LoRa WAN et des appareils compatibles avec Amazon Sidewalk, ainsi qu'avec d'autres appareils équipés d'appareils AWS IoT fournis avec. AWS IoT Pour les appareils IoT généraux, si les appareils prennent en charge l'estimation de position à l'aide du GNSS, lorsque les informations de numérisation GNSS sont reçues de l'appareil, les émetteurs-récepteurs résolvent les informations de localisation. Pour les appareils LoRa WAN, ils doivent être équipés du chipset LoRa Edge. Lorsqu'un message de liaison montante est reçu de l'appareil, les données de numérisation GNSS sont envoyées vers le LoRa WAN ou vers AWS IoT AWS IoT Amazon Sidewalk, et l'emplacement est estimé sur la base des résultats de numérisation des émetteurs-récepteurs.
### Exemple de charge utile d'un solveur GNSS
Le code suivant montre un exemple de la charge utile JSON provenant de l'appareil qui contient les données de mesure. Lorsque AWS IoT Core Device Location reçoit les informations de numérisation GNSS contenant la charge utile contenue dans les données de mesure, il utilise les émetteurs-récepteurs et toute information d'assistance supplémentaire incluse pour rechercher des signaux et résoudre les informations de localisation. Pour récupérer les informations, fournissez la charge utile JSON en utilisant ce format ou spécifiez des valeurs pour le paramètre [Gnss](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Gnss) de l'opération d'[GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API.
**Note**
Avant que AWS IoT Core l'emplacement du périphérique puisse résoudre l'emplacement du périphérique, vous devez supprimer l'octet de destination de la charge utile.
```
{
"Timestamp": 1664313161, // optional
"Gnss": {
"AssistAltitude": number, // optional
"AssistPosition": [ number ], // optional
"CaptureTime": number, // optional
"CaptureTimeAccuracy": number, // optional
"Payload": "string", // required
"Use2DSolver": boolean // optional
}
}
```
## Solveur BLE pour appareils compatibles Amazon Sidewalk
**Note**
Pour la localisation basée sur Bluetooth Low Energy, AWS IoT renvoie les coordonnées de localisation basées sur l'emplacement approximatif des passerelles Sidewalk Gateway situées à proximité qui sont connectées à Amazon Sidewalk et dont la fonction de recherche de communauté est activée. Les données de localisation de Gateway sont AWS du contenu et vous sont fournies uniquement dans le but de vous aider à localiser vos appareils connectés à Amazon Sidewalk, et vous ne devez utiliser les données qu'à cette fin. Vous ne devez utiliser et accéder aux données de localisation que via l'interface et les fonctionnalités que nous mettons généralement à votre disposition, et vous ne devez pas tenter de réidentifier, de rétroconcevoir ou de recartographier les données de localisation de Gateway que nous vous avons fournies.
Les terminaux Amazon Sidewalk qui se connectent AWS IoT Core pour Amazon Sidewalk peuvent résoudre leurs données de localisation à l'aide de messages de liaison montante BLE, Wi-Fi ou GNSS publiés par le terminal Amazon Sidewalk. Pour plus d'informations, consultez le [guide du AWS IoT Core pour Amazon Sidewalk développeur](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/sidewalk-getting-started.html).