

# Configuración de la posición de las puertas de enlace LoRaWAN
<a name="lorawan-location-gateways"></a>

Cuando agrega su puerta de enlace a AWS IoT Core para LoRaWAN, puede especificar los datos de posición estática. Si ha activado los mapas de Amazon Location Service, los datos de posición se muestran en un mapa de Amazon Location. 

**nota**  
Los solucionadores de terceros no se pueden usar con las puertas de enlace LoRaWAN. En el caso de las puertas de enlace, puede especificar las coordenadas de posición estática. Cuando no se utilizan solucionadores para calcular la posición, como en el caso de las puertas de enlace, la información de precisión se mostrará como `0.0`.

Puede configurar la posición de la puerta de enlace mediante la Consola de administración de AWS, la API AWS IoT Wireless o la AWS CLI. 

## Configuración de la posición de la puerta de enlace mediante la consola
<a name="lorawan-location-gateways-console"></a>

Para configurar la posición de los recursos de la puerta de enlace mediante la Consola de administración de AWS, primero inicie sesión en la consola y, a continuación, vaya a la página central [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) de la consola de AWS IoT.

**Agregar la información de posición**  
Para agregar una configuración de posición a su puerta de enlace

1. En la página central **Puertas de enlace**, elija **Agregar puerta de enlace**.

1. Introduzca la EUI de la puerta de enlace, la banda de frecuencia (región RF) y cualquier detalle adicional de la puerta de enlace y la información de configuración de LoRaWAN. Para obtener más información, consulte [Agregar etiquetas a una puerta de enlace mediante la consola](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).

1. Vaya a la sección **Información de posición: opcional** e introduzca la información de posición de su puerta de enlace utilizando las coordenadas de latitud y longitud y una coordenada de altitud opcional. La información de posición se basa en el sistema de coordenadas WGS84.

**Ver la posición de la puerta de enlace**  
Después de configurar la posición de su puerta de enlace, AWS IoT Core para LoRaWAN crea un mapa de ubicaciones de Amazon llamado `iotwireless.map`. Puede ver este mapa en la página de detalles de su puerta de enlace, en la pestaña **Posición**. En función de las coordenadas de posición especificadas, la posición de su puerta de enlace se mostrará como un marcador en el mapa. Puede acercar o alejar la imagen para ver claramente la posición de su puerta de enlace en el mapa. En la pestaña **Posición**, también verá la información de precisión y la marca temporal en la que se determinó la posición de su puerta de enlace.

**nota**  
Si no tiene instalados los mapas de Amazon Location Service, verá un mensaje que indica que debe usar Amazon Location Service para acceder al mapa y ver la posición de la puerta de enlace. Si utiliza los mapas de Amazon Location Service, se le cobrarán cargos adicionales en su Cuenta de AWS. Para más información, consulte [Precios de AWS IoT Core](https://aws.amazon.com/iot-core/pricing/).

El mapa, `iotwireless.map`, actúa como un origen de datos cartográficos a los que se accede mediante operaciones de la 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 obtener información sobre las API `Get` que se utilizan con los mapas, consulte la [Referencia de API de Amazon Location Service](https://docs.aws.amazon.com/location-maps/latest/APIReference/Welcome.html).

Para obtener información adicional sobre este mapa, vaya a la consola de Amazon Location Service, elija **maps** y, a continuación, elija [iotwireless.map](https://console.aws.amazon.com/location/maps/home#/describe/iotwireless.map). Para obtener más información, consulte la sección [Mapas](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html) en la *Guía para desarrolladores de Amazon Location Service*.

**Actualizar la configuración de posición de la puerta de enlace**  
Para cambiar la configuración de posición de la puerta de enlace, en la página de detalles de la puerta de enlace, seleccione **Editar** y, a continuación, actualice la información de posición y el destino.

**nota**  
La información sobre los datos históricos de posición no está disponible. Al actualizar las coordenadas de posición de la puerta de enlace, se sobrescriben los datos de posición registrados anteriormente. Una vez que haya actualizado la posición, en la pestaña **Posición** de los detalles de la puerta de enlace verá la información de la nueva posición. El cambio en la marca temporal indica que corresponde a la última posición conocida de la puerta de enlace.

## Configurar la posición de la puerta de enlace mediante la API
<a name="lorawan-location-gateways-api"></a>

Puede especificar la información de posición y configurar la posición de la puerta de enlace mediante la API AWS IoT Wireless o la AWS CLI.

**importante**  
Las acciones de la 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) y [ListPositionConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListPositionConfigurations.html) ya no se admiten. En su lugar, las llamadas para actualizar y recuperar la información de posición deberían utilizar las operaciones de la API [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) y [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html).

### Agregar la información de posición
<a name="lorawan-location-gateways-api-add"></a>

Para agregar la información de posición estática de una puerta de enlace inalámbrica determinada, especifique las coordenadas mediante la operación de la API [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) o el comando de la CLI [update-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-resource-position.html). Especifique `WirelessGateway` como `ResourceType`, el ID de la puerta de enlace inalámbrica que se va a actualizar como `ResourceIdentifier` y la información de posición como una carga de GeoJSON.

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

A continuación se muestra el contenido del archivo `gatewayposition.json`.

**Contenido de gatewayposition.json**

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

Este comando no proporciona ningún resultado. Para ver la información de posición especificada, utilice la operación de la API `GetResourcePosition`.

### Obtener la información de posición
<a name="lorawan-location-devices-api-get"></a>

Para obtener la información de posición de una puerta de enlace inalámbrica determinada, utilice la operación de la API [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) o el comando de la CLI [get-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position.html). Especifique `WirelessGateway` como `resourceType` y proporcione el ID de la puerta de enlace inalámbrica como `resourceIdentifier`.

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

Al ejecutar este comando, se muestra la información de posición de la puerta de enlace inalámbrica como una carga de GeoJSON. Verá información sobre las coordenadas de posición, el tipo de información de posición y propiedades adicionales, como la marca temporal que corresponde a la última posición conocida de la puerta de enlace.

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