# 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 Console di gestione AWS, l'API Wireless AWS IoT o la AWS CLI.
## Configurazione della posizione del gateway utilizzando la console
Per configurare la posizione delle risorse gateway utilizzando la Console di gestione AWS, accedi prima alla console quindi passa alla pagina hub [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) 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).
1. 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](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).
1. 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](https://aws.amazon.com/iot-core/pricing/).
La mappa, `iotwireless.map`, funge da fonte di dati cartografici a cui si accede tramite operazioni API `Get`, ad esempio [https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html](https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html). Per informazioni sulle API `Get` utilizzate con le mappe, consulta [Amazon Location Service API reference](https://docs.aws.amazon.com/location-maps/latest/APIReference/Welcome.html) (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](https://console.aws.amazon.com/location/maps/home#/describe/iotwireless.map). Per ulteriori informazioni, consultare [Mappe](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html) 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 Wireless AWS IoT o la AWS CLI.
**Importante**
Le operazioni 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) e [ListPositionConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListPositionConfigurations.html) non sono più supportate. Le chiamate per aggiornare e recuperare le informazioni sulla posizione devono utilizzare le operazioni API [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) e [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html).
### 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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) o il comando [update-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-resource-position.html) 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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) o il comando [get-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position.html) 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"
}
}
}
```