Configuration de la position des passerelles LoRaWAN - AWS IoT Wireless
Configuration de la position de votre passerelle à l'aide de la consoleConfigurez la position de votre passerelle à l'aide de l'API

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 Passerelle 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.

  2. 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.

  3. 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.

La carte, iotwireless.map, agit comme une source de données cartographiques accessibles à l'aide d'opérations d'API Get, telles que GetMapTile. 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.

Pour obtenir des informations supplémentaires sur cette carte, accédez à la console Amazon Location Service, choisissez Cartes, puis iotwireless.map. Pour plus d'informations, consultez Cartes 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, GetPosition, PutPositionConfiguration, GetPositionConfiguration, et ListPositionConfigurations 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 et UpdateResourcePosition.

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 ou de la commande CLI update-resource-position. 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 ou la commande CLI get-resource-position. 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"
         }
    }
}