# Configuration de la position des passerelles LoRaWAN
Lorsque vous ajoutez votre passerelle à AWS IoT Core for LoRaWAN, vous pouvez spécifier les données de position statiques. Si vous avez activé les cartes Amazon Location Service, les données de position sont affichées sur une carte de localisation Amazon.
**Note**
Les solveurs tiers ne peuvent pas être utilisés avec les passerelles LoRaWAN. Pour les passerelles, vous pouvez toujours spécifier les coordonnées de position statiques. Lorsque les solveurs ne sont pas utilisés pour calculer la position, comme dans le cas des passerelles, les informations de précision seront signalées sous forme de `0.0`.
Vous pouvez configurer la position de la passerelle à l’aide de la AWS Management Console, de l’API AWS IoT Wireless ou d’AWS CLI.
## Configuration de la position de votre passerelle à l'aide de la console
Pour configurer la position des ressources de votre passerelle à l'aide de AWS Management Console, connectez-vous d'abord à la console, puis accédez à la page du hub [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) de la AWS IoT console.
**Ajouter les informations sur la position**
Pour ajouter une configuration de position pour votre passerelle
1. Sur la page du hub **de passerelles**, choisissez **Ajouter une passerelle**.
1. Entrez l'EUI, la bande de fréquence (RFRegion) de la passerelle, ainsi que tous les détails supplémentaires de la passerelle et les informations de configuration LoRaWAN. Pour en savoir plus, consultez [Ajouter une passerelle à l’aide de la console](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).
1. Accédez à la section **Informations de position - Facultatif**, et entrez les informations de position de votre passerelle à l'aide des coordonnées de latitude et de longitude et d'une coordonnée d'altitude facultative. Les informations de position sont basées sur le système de coordonnées WGS84.
**Afficher la position de la passerelle**
Une fois que vous avez configuré la position de votre passerelle, AWS IoT Core for LoRaWAN crée une carte de localisation Amazon appelée `iotwireless.map`. Vous pouvez voir cette carte sur la page de détails de votre passerelle dans l'onglet **Position**. Sur la base des coordonnées de position que vous avez spécifiées, la position de votre passerelle sera affichée sous forme de marqueur sur la carte. Vous pouvez zoomer ou dézoomer pour visualiser clairement la position de votre passerelle sur la carte. Dans l'onglet **Position**, vous verrez également les informations de précision et l'horodatage auxquels la position de votre passerelle a été déterminée.
**Note**
Si aucune carte Amazon Location Service n'est installée, vous verrez un message indiquant que vous devez utiliser Amazon Location Service pour accéder à la carte et voir la position de la passerelle. L'utilisation des cartes Amazon Location Service peut entraîner des frais supplémentaires pour votre compte Compte AWS. Pour en savoir plus, consultez [AWS IoT Core Tarification](https://aws.amazon.com/iot-core/pricing/).
La carte, `iotwireless.map`, agit comme une source de données cartographiques accessibles à l'aide d'opérations d'API `Get`, telles que [https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html](https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html). Pour plus d'informations sur les API `Get` utilisées avec les cartes, consultez le [manuel de référence des API Amazon Location Service](https://docs.aws.amazon.com/location-maps/latest/APIReference/Welcome.html).
Pour obtenir des informations supplémentaires sur cette carte, accédez à la console Amazon Location Service, choisissez **Cartes**, puis [iotwireless.map](https://console.aws.amazon.com/location/maps/home#/describe/iotwireless.map). Pour plus d'informations, consultez [Cartes](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html) dans le *guide du développeur Amazon Location Service*.
**Mettre à jour la configuration de position de la passerelle**
Pour modifier la configuration de position de la passerelle, sur la page des détails de la passerelle, choisissez **Modifier**, puis mettez à jour les informations de position et la destination.
**Note**
Les informations relatives aux données de position historiques ne sont pas disponibles. Lorsque vous mettez à jour les coordonnées de position de la passerelle, celle-ci remplace les données de position précédemment signalées. Après avoir mis à jour la position, dans l'onglet **Position** des détails de la passerelle, vous verrez les nouvelles informations de position. Le changement d'horodatage indique qu'il correspond à la dernière position connue de la passerelle.
## Configurez la position de votre passerelle à l'aide de l'API
Vous pouvez spécifier les informations de position et configurer la position de la passerelle à l’aide de l’API AWS IoT Wireless ou d’AWS CLI.
**Important**
Les actions d'API [ UpdatePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdatePosition.html), [GetPosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetPosition.html), [PutPositionConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_PutPositionConfiguration.html), [GetPositionConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetPositionConfiguration.html), et [ListPositionConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListPositionConfigurations.html) ne sont plus prises en charge. Les appels pour mettre à jour et récupérer les informations de position doivent plutôt utiliser les opérations d'API [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) et [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html).
### Ajouter les informations sur la position
Pour ajouter les informations de position statiques pour une passerelle sans fil donnée, spécifiez les coordonnées à l'aide de l'opération d'API [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) ou de la commande CLI [update-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-resource-position.html). Spécifiez `WirelessGateway` en tant que `ResourceType`, l'ID de la passerelle sans fil à mettre à jour en tant que `ResourceIdentifier`, et les informations de position en tant que charge utile GeoJSON.
```
aws iotwireless update-resource-position \
--resource-type WirelessGateway \
--resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
--cli-input-json file://gatewayposition.json
```
L’exemple suivant affiche le contenu du fichier `gatewayposition.json`.
**Contenu de gatewayposition.json**
```
{
"type": "Point",
"coordinates": [33.3318, -22.2155, 13.123],
"properties": {
"timestamp": "2018-11-30T18:35:24Z"
}
}
```
Exécuter cette commande ne fournit aucune sortie. Pour voir les informations de position que vous avez spécifiées, utilisez l'opération API `GetResourcePosition`.
### Obtenir des informations sur la position
Pour obtenir les informations de position d'une passerelle sans fil donnée, utilisez l'opération d'API [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) ou la commande CLI [get-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position.html). Spécifiez `WirelessGateway` en tant que `resourceType` et fournissez l'ID de la passerelle sans fil en tant que `resourceIdentifier`.
```
aws iotwireless get-resource-position \
--resource-type WirelessGateway \
--resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
```
L'exécution de cette commande affiche les informations de position de votre passerelle sans fil sous forme de charge utile GeoJSON. Vous verrez des informations sur les coordonnées de position, le type d'informations de position et des propriétés supplémentaires, telles que l'horodatage qui correspond à la dernière position connue de la passerelle.
```
{
{
"type": "Point",
"coordinates": [33.3318,-22.2155,13.123],
"properties": {
"timestamp": "2018-11-30T18:35:24Z"
}
}
}
```