Configurazione della posizione dei gateway LoRaWAN - Wireless AWS IoT
Configurazione della posizione del gateway utilizzando la consoleConfigurazione della posizione del gateway tramite l'API

Configurazione della posizione dei gateway LoRaWAN

Quando si aggiunge il gateway a AWS IoT Core per LoRaWAN, è possibile specificare i dati sulla posizione statica. Se sono state attivate le mappe del servizio di posizione Amazon, i dati sulla posizione vengono visualizzati su una mappa delle posizioni Amazon.

Nota

I risolutori di terze parti non possono essere utilizzati con i gateway LoRaWAN. Per i gateway, è comunque possibile specificare le coordinate della posiziona statica. Se per calcolare la posizione non vengono utilizzati i risolutori, ad esempio nel caso dei gateway, le informazioni sulla precisione verranno riportate come 0.0.

Puoi configurare la posizione della gateway utilizzando la AWS Management Console, l'API AWS IoT Wireless o la AWS CLI.

Configurazione della posizione del gateway utilizzando la console

Per configurare la posizione delle risorse gateway utilizzando la AWS Management Console, accedi prima alla console quindi passa alla pagina hub Gateway della console AWS IoT.

Aggiunta di informazioni sulla posizione

Aggiunta di una configurazione della posizione per il gateway

  1. Nella pagina hub Gateway, scegli Add gateway (Aggiungi gateway).

  2. Specifica l'identificatore univoco esteso (EUI) del gateway, la banda di frequenza (RFRegion) e tutti i dettagli aggiuntivi del gateway, oltre alle informazioni di configurazione LoRaWAN. Per ulteriori informazioni, consultare Aggiungere un gateway utilizzando la console.

  3. Vai alla sezione Position information - Optional (Informazioni sulla posizione - facoltativa) e inserisci le informazioni sulla posizione per il gateway utilizzando le coordinate di latitudine e longitudine e una coordinata di altitudine facoltativa. Le informazioni sulla posizione si basano sul sistema di coordinate WGS84.

Visualizzazione della posizione del gateway

Dopo aver configurato la posizione del gateway, AWS IoT Core per LoRaWAN crea una mappa delle posizioni Amazon chiamata iotwireless.map. Questa mappa è presente sulla pagina dei dettagli del tuo gateway nella scheda Position (Posizione). In base alle coordinate di posizione specificate, la posizione del gateway verrà visualizzata come contrassegno sulla mappa. Puoi ingrandire o rimpicciolire la mappa per visualizzare chiaramente la posizione del tuo gateway. Nella scheda Position (Posizione), vengono anche visualizzate informazioni sulla precisione e il timestamp del momento in cui è stata determinata la posizione del gateway.

Nota

Se non hai installato le mappe del servizio di posizione Amazon, sarà visualizzato un messaggio che indica che è necessario utilizzare questo servizio per accedere alla mappa e visualizzare la posizione del gateway. L'utilizzo di mappe del servizio di posizione Amazon può comportare addebiti aggiuntivi al tuo Account AWS. Per ulteriori informazioni, consultare Prezzi di AWS IoT Core.

La mappa, iotwireless.map, funge da fonte di dati cartografici a cui si accede tramite operazioni API Get, ad esempio GetMapTile. Per informazioni sulle API Get utilizzate con le mappe, consulta Amazon Location Service API reference (Documentazione di riferimento delle API del servizio di posizione Amazon).

Per ulteriori dettagli su questa mappa, vai alla console del servizio di posizione Amazon, scegli maps (mappe) quindi seleziona iotwireless.map. Per ulteriori informazioni, consultare Mappe nella Guida per gli sviluppatori del servizio di posizione Amazon.

Aggiornamento della configurazione della posizione del gateway

Per modificare la configurazione della posizione del gateway, nella pagina dei dettagli del gateway, seleziona Edit (Modifica), quindi aggiorna le informazioni sulla posizione e la destinazione.

Nota

Le informazioni sui dati storici della posizione non sono disponibili. Quando aggiorni le coordinate di posizione del gateway, i dati sulla posizione riportati in precedenza vengono sovrascritti. Dopo aver aggiornato la posizione, nella scheda Position (Posizione) dei dettagli del gateway, vedrai le nuove informazioni sulla posizione. Una modifica del timestamp indica che corrisponde all'ultima posizione nota del gateway.

Configurazione della posizione del gateway tramite l'API

Puoi specificare le informazioni sulla posizione e configurare il gateway utilizzando l'API AWS IoT Wireless o la AWS CLI.

Importante

Le operazioni API UpdatePosition, GetPosition, PutPositionConfiguration, GetPositionConfiguration e ListPositionConfigurations non sono più supportate. Le chiamate per aggiornare e recuperare le informazioni sulla posizione devono utilizzare le operazioni API GetResourcePosition e UpdateResourcePosition.

Aggiunta di informazioni sulla posizione

Per aggiungere le informazioni sulla posizione statica per un determinato gateway wireless, specificare le coordinate utilizzando l'operazione API UpdateResourcePosition o il comando update-resource-position della CLI. Specificare WirelessGateway come ResourceType, l'ID del gateway wireless da aggiornare come ResourceIdentifier e le informazioni sulla posizione come payload GeoJSON.

aws iotwireless update-resource-position \ 
    --resource-type WirelessGateway \ 
    --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ 
    --cli-input-json file://gatewayposition.json

Nell'esempio seguente viene mostrato il contenuto del file gatewayposition.json.

Contenuto di gatewayposition.json

{ 
     "type": "Point",
     "coordinates": [33.3318, -22.2155, 13.123],
     "properties": {
          "timestamp": "2018-11-30T18:35:24Z"
      }
}

L'esecuzione di questo comando non produce output. Per visualizzare le informazioni sulla posizione specificate, utilizzare l'operazione API GetResourcePosition.

Ottenimento delle informazioni sulla posizione

Per ottenere le informazioni sulla posizione di un determinato gateway wireless, utilizzare l'API GetResourcePosition o il comando get-resource-position della CLI. Specifica WirelessGateway come resourceType e immetti l'ID del gateway wireless come resourceIdentifier.

aws iotwireless get-resource-position \ 
    --resource-type WirelessGateway \ 
    --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

L'esecuzione di questo comando visualizza le informazioni sulla posizione del gateway wireless come un payload GeoJSON. Saranno visualizzate le informazioni sulle coordinate della posizione, il tipo di informazioni sulla posizione e proprietà aggiuntive, come il timestamp che corrisponde all'ultima posizione nota del gateway.

{
    {
    "type": "Point",
     "coordinates": [33.3318,-22.2155,13.123],
     "properties": {
         "timestamp": "2018-11-30T18:35:24Z"
         }
    }
}