

# Configurar a posição dos recursos sem fio com o AWS IoT Core for LoRaWAN
<a name="lorawan-configure-location"></a>


|  | 
| --- |
| Antes de usar esse atributo, observe que o provedor terceiro selecionado para resolver informações de posição para dispositivos LoRaWAN depende de feeds e conjuntos de dados fornecidos ou mantidos pelo Serviço Internacional de GNSS (IGS), EarthData via NASA ou outros terceiros. Esses feeds e conjuntos de dados são conteúdo de terceiros (conforme definido no contrato do cliente) e são fornecidos no estado em que se encontram. Para obter mais informações, consulte [Termos de serviço da AWS](https://aws.amazon.com/service-terms). | 

É possível utilizar o AWS IoT Core for LoRaWAN para especificar os dados de posição estática ou ativar o posicionamento para identificar a posição de um dispositivo em tempo real utilizando solucionadores de terceiros. É possível adicionar ou atualizar as informações de posição para dispositivos LoRaWAN ou gateways, ou ambos. 

Especifique as informações de posição ao adicionar o dispositivo ou o gateway ao AWS IoT Core for LoRaWAN ou ao editar os detalhes da configuração de um dispositivo ou gateway. As informações de posição são especificadas como uma carga [GeoJSON](https://geojson.org/). O formato GeoJSON é um formato usado para codificar estruturas de dados geográficos. A carga contém as coordenadas de latitude e longitude da localização do dispositivo, que são baseadas no [sistema de coordenadas do Sistema Geodésico Mundial (WGS84)](https://gisgeography.com/wgs84-world-geodetic-system/).

Depois que os solucionadores calcularem a posição do recurso, se você tiver o Amazon Location Service, será possível ativar um mapa de localização da Amazon, onde será mostrada a posição do recurso. Com os dados de posição, você pode:
+ Ativar o posicionamento para identificar e obter a posição de dispositivos LoRaWAN.
+ Rastrear e monitorar a posição de gateways e dispositivos.
+ Definir regras do AWS IoT que processem atualizações nos dados de posição e as encaminhem para outros AWS service (Serviço da AWS). Para obter uma lista de ações de regras, consulte [AWS IoT rule actions](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rule-actions.html) no *Guia do desenvolvedor do AWS IoT*.
+ Criar alertas e receber notificações em dispositivos em caso de atividade incomum usando os dados de posição e o Amazon SNS.

## Como funciona o posicionamento para dispositivos LoRaWAN
<a name="lorawan-location-solver"></a>

É possível ativar o posicionamento para identificar a posição de dispositivos usando solucionadores Wi-Fi e GNSS de terceiros. Essas informações podem ser utilizadas para rastrear e monitorar dispositivos. As etapas a seguir demonstram como ativar o posicionamento e visualizar as informações de posição de dispositivos LoRaWAN.

**nota**  
Os solucionadores de terceiros podem ser usados apenas com dispositivos LoRaWAN que possuam o chip [LoRa Edge](https://www.semtech.com/products/wireless-rf/lora-edge). Não pode ser utilizado com gateways LoRaWAN. Para gateways, ainda é possível especificar as informações de posição estática e identificar a localização em um mapa de localização da Amazon.

1. 

**Adicione o dispositivo**

   Antes de ativar o posicionamento, adicione o dispositivo ao AWS IoT Core for LoRaWAN. O dispositivo LoRaWAN deve possuir o chipset LoRa Edge, que é uma plataforma de potência ultrabaixa que integra um transceptor LoRa de longo alcance, um scanner GNSS de várias constelações e um scanner MAC Wi-Fi passivo voltado para aplicativos de geolocalização.

1. 

**Ative o posicionamento**

   Para obter a posição em tempo real de dispositivos, ative o posicionamento. Quando o dispositivo LoRaWAN envia uma mensagem de uplink, os dados de verificação de Wi-Fi e GNSS contidos na mensagem são enviados ao AWS IoT Core for LoRaWAN utilizando a porta do quadro de geolocalização.

1. 

**Recupere informações de posição**

   Recupere a posição estimada do dispositivo a partir dos solucionadores calculados com base nos resultados da varredura dos transceptores. Se as informações de posição tiverem sido calculadas utilizando os resultados da verificação de Wi-Fi e GNSS, o AWS IoT Core for LoRaWAN selecionará a posição estimada com maior precisão.

1. 

**Visualize informações de posição**

   Depois que o solucionador computar as informações de posição, ele também fornecerá as informações de precisão que indicam a diferença entre a posição calculada pelos solucionadores e as informações de posição estática inseridas. Também é possível visualizar a localização do dispositivo no mapa de localização da Amazon.
**nota**  
Como os solucionadores não podem ser usados para gateways LoRaWAN, as informações de precisão serão relatadas como `0.0`.

Para acessar mais informações sobre o formato da mensagem de uplink e as portas de frequência que são usadas para o solucionador de posicionamento, consulte [Mensagem de uplink do AWS IoT Core for LoRaWAN para o mecanismo de regras](lorawan-location-devices.md#lorawan-location-devices-uplink).

## Visão geral do fluxo de trabalho do posicionamento
<a name="lorawan-location-workflow"></a>

O diagrama a seguir mostra como o AWS IoT Core for LoRaWAN armazena e atualiza as informações de posição dos dispositivos e gateways.

![Imagem que mostra como o AWS IoT Core for LoRaWAN pode utilizar dados de posição estática e dados brutos para calcular a posição em tempo real.](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/images/iot-lorawan-lms-architecture.png)


1. 

**Especifique a posição estática do recurso**  
Especifique as informações de posição estática do dispositivo ou gateway como uma carga GeoJSON usando as coordenadas de latitude e longitude. Também é possível especificar uma coordenada de altitude opcional. Essas coordenadas se baseiam no sistema de coordenadas WGS84. Para acessar mais informações, consulte [Sistema Geodésico Mundial (WGS84)](https://gisgeography.com/wgs84-world-geodetic-system/).

1. 

**Ative o posicionamento para dispositivos**  
Se estiver usando dispositivos LoRaWAN que possuem o chip LoRa Edge, é possível ativar, opcionalmente, o posicionamento para rastrear a posição do dispositivo em tempo real. Quando o dispositivo envia uma mensagem de uplink, os dados de verificação de Wi-Fi e GNSS são enviados ao AWS IoT Core for LoRaWAN utilizando a porta do quadro de geolocalização. Então, os solucionadores usam essas informações para solucionar a posição do dispositivo. 

1. 

**Adicione um destino aos dados de posição de rota**  
É possível adicionar um destino que descreva a regra do IoT para processar os dados do dispositivo e rotear as informações de posição atualizadas para o AWS IoT Core for LoRaWAN. Também é possível visualizar a última posição conhecida do recurso em um mapa de localização da Amazon.

## Configuração da posição de um recurso
<a name="lorawan-location-how"></a>

É possível configurar a posição de um recurso utilizando o Console de gerenciamento da AWS, a API do AWS IoT Wireless ou a AWS CLI. 

Se os dispositivos tiverem o chip do LoRa Edge, você poderá ativar o posicionamento para calcular as informações de posição em tempo real. Para os gateways, ainda é possível inserir as coordenadas de posição estática e usar a localização da Amazon para rastrear a posição do gateway em um mapa de localização da Amazon.

**Topics**
+ [Como funciona o posicionamento para dispositivos LoRaWAN](#lorawan-location-solver)
+ [Visão geral do fluxo de trabalho do posicionamento](#lorawan-location-workflow)
+ [Configuração da posição de um recurso](#lorawan-location-how)
+ [Configuração da posição dos gateways LoRaWAN](lorawan-location-gateways.md)
+ [Configuração da posição de dispositivos LoRaWAN](lorawan-location-devices.md)