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 AWS Management Console, 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 AWS Management Console, faça login no console e, depois, acesse a página do hub Gateways
Adicionar informações de posição
Para adicionar uma configuração de posição para um gateway
-
Na página do hub Gateways, selecione Adicionar gateway.
-
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.
-
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
O mapa iotwireless.map atua como uma fonte de dados de mapa que é acessada usando operações de API Get, como GetMapTile. Para acessar mais informações sobre as APIs Get usadas com mapas, consulte Referência de API do Amazon Location Service.
Para obter detalhes adicionais sobre esse mapa, vá para o console do Amazon Location Service, selecione mapas e, depois, selecione iotwireless.map
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, GetPosition, PutPositionConfiguration, GetPositionConfiguration e ListPositionConfigurations 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 e UpdateResourcePosition.
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 ou o comando update-resource-position 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-jsonfile://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 ou o comando get-resource-position 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" } } }
