# Configuração da posição dos gateways LoRaWAN
Ao adicionar o gateway ao AWS IoT Core for LoRaWAN, é possível especificar os dados de posição estática. Caso tenha ativado os mapas do Amazon Location Service, os dados da posição serão exibidos em um mapa de localização da Amazon.
**nota**
Solucionadores de terceiros não podem ser usados com gateways LoRaWAN. Para gateways, ainda é possível especificar as coordenadas da posição estática. Quando os solucionadores não são usados para calcular a posição, como no caso de gateways, as informações de precisão serão relatadas como `0.0`.
É possível configurar a posição do gateway utilizando o Console de gerenciamento da AWS, a API do AWS IoT Wireless ou a AWS CLI.
## Configuração da posição de um gateway com o console
Para configurar a posição de recursos do gateway usando o Console de gerenciamento da AWS, faça login no console e, depois, acesse a página do hub [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) do console do AWS IoT.
**Adicionar informações de posição**
Para adicionar uma configuração de posição para um gateway
1. Na página do hub **Gateways**, selecione **Adicionar gateway**.
1. Informe a EUI do gateway, a banda de frequência (RFRegion) e quaisquer detalhes adicionais do gateway e informações de configuração do LoRaWAN. Para ter mais informações, consulte [Adicionar um gateway usando o console](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).
1. Navegue para a seção **Informações de posição - Opcional** e informe as informações de posição do gateway usando as coordenadas de latitude e longitude e uma coordenada de altitude opcional. As informações de posição se baseiam no sistema de coordenadas WGS84.
**Visualize a posição do gateway**
Depois de configurar a posição do gateway, o AWS IoT Core for LoRaWAN cria um mapa do Amazon Location chamado `iotwireless.map`. É possível visualizar esse mapa na página de detalhes do gateway na guia **Posição**. Com base nas coordenadas de posição especificadas, a posição do gateway será exibida como um marcador no mapa. É possível ampliar ou reduzir o zoom para visualizar a posição do gateway no mapa com clareza. Na guia **Posição**, você também terá acesso às informações de precisão e registro de data/hora em que a posição do gateway foi determinada.
**nota**
Se não tiver mapas do Amazon Location Service instalados, será exibida uma mensagem indicando que você deve usar o Amazon Location Service para acessar o mapa e visualizar a posição do gateway. Usar mapas do Amazon Location Service pode incorrer em cobranças adicionais na sua Conta da AWS. Para obter mais informações, consulte [Definição de preços do AWS IoT Core](https://aws.amazon.com/iot-core/pricing/).
O mapa `iotwireless.map` atua como uma fonte de dados de mapa que é acessada usando operações de API `Get`, como [https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html](https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html). Para acessar mais informações sobre as APIs `Get` usadas com mapas, consulte [Referência de API do Amazon Location Service](https://docs.aws.amazon.com/location-maps/latest/APIReference/Welcome.html).
Para obter detalhes adicionais sobre esse mapa, vá para o console do Amazon Location Service, selecione **mapas** e, depois, selecione [iotwireless.map](https://console.aws.amazon.com/location/maps/home#/describe/iotwireless.map). Para acessar mais informações, consulte [Mapas](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html) no *Guia do desenvolvedor do Amazon Location Service*.
**Atualize a configuração de posição do gateway**
Para alterar a configuração da posição do gateway, na página de detalhes do gateway, selecione **Editar** e atualize as informações de posição e o destino.
**nota**
As informações de dados históricos de posição não estão disponíveis. Quando você atualiza as coordenadas de posição do gateway, os dados de posição relatados anteriormente são substituídos. Depois de atualizar a posição, na guia **Posição** dos detalhes do gateway, as informações da nova posição serão exibidas. A alteração no registro de data/hora indica que ela corresponde à última posição conhecida do gateway.
## Configurar a posição do gateway usando a API
É possível especificar as informações de posição e configurar a posição do gateway utilizando a API do AWS IoT Wireless ou a AWS CLI.
**Importante**
As ações de 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) não são mais compatíveis. Ao invés disso, as chamadas para atualizar e recuperar as informações de posição devem usar as operações de 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).
### Adicionar informações de posição
Para adicionar as informações de posição estática de um gateway sem fio determinado, especifique as coordenadas usando a operação de API [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) ou o comando [update-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-resource-position.html) da CLI. Especifique `WirelessGateway` como o `ResourceType`, o ID do gateway sem fio a ser atualizado como o `ResourceIdentifier` e as informações de posição como uma carga GeoJSON.
```
aws iotwireless update-resource-position \
--resource-type WirelessGateway \
--resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
--cli-input-json file://gatewayposition.json
```
O exemplo a seguir mostra o conteúdo do arquivo `gatewayposition.json`.
**Conteúdo do gatewayposition.json**
```
{
"type": "Point",
"coordinates": [33.3318, -22.2155, 13.123],
"properties": {
"timestamp": "2018-11-30T18:35:24Z"
}
}
```
A execução desse comando não retorna nenhuma saída. Para acessar as informações de posição especificadas, use a operação de API `GetResourcePosition`.
### Obter informações de posição
Para acessar as informações de posição de um gateway sem fio determinado, use a operação de API [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) ou o comando [get-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position.html) da CLI. Especifique `WirelessGateway` como o `resourceType` e forneça o ID do gateway sem fio como o `resourceIdentifier`.
```
aws iotwireless get-resource-position \
--resource-type WirelessGateway \
--resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
```
Executar esse comando exibe as informações de posição do gateway sem fio como uma carga GeoJSON. Você verá informações sobre as coordenadas de posição, o tipo de informação de posição e propriedades adicionais, tais como o registro de data/hora correspondente à última posição conhecida do gateway.
```
{
{
"type": "Point",
"coordinates": [33.3318,-22.2155,13.123],
"properties": {
"timestamp": "2018-11-30T18:35:24Z"
}
}
}
```