# LoRaWAN 게이트웨이의 위치 구성
게이트웨이를 AWS IoT Core for LoRaWAN에 추가할 때 정적 위치 데이터를 지정할 수 있습니다. Amazon Location Service 맵을 활성화하면 위치 데이터가 Amazon Location 맵에 표시됩니다.
**참고**
서드 파티 솔버는 LoRaWAN 게이트웨이와 함께 사용할 수 없습니다. 게이트웨이의 경우, 여전히 정적 위치 좌표를 지정할 수 있습니다. 게이트웨이의 경우처럼 솔버를 사용하여 위치를 계산하지 않는 경우, 정확도 정보는 `0.0`과 같이 보고됩니다.
AWS Management Console, AWS IoT 무선 API 또는 AWS CLI를 사용하여 게이트웨이 위치를 구성할 수 있습니다.
## 콘솔을 사용한 게이트웨이 위치 구성
AWS Management Console을 사용하여 게이트웨이 리소스의 위치를 구성하려면 먼저 콘솔에 로그인한 다음 AWS IoT 콘솔의 [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) 허브 페이지로 이동합니다.
**위치 정보 추가**
게이트웨이에 대한 위치 구성 추가
1. **게이트웨이(Gateways)** 허브 페이지에서 **게이트웨이 추가(Add gateway)**를 선택합니다.
1. 게이트웨이의 EUI, 주파수 대역(RFRegion) 및 추가 게이트웨이 세부 정보와 LoRaWAN 구성 정보를 입력합니다. 자세한 내용은 [콘솔을 사용하여 게이트웨이 추가](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console) 단원을 참조하십시오.
1. **Position information - Optional**(위치 정보 - 선택 사항) 섹션에서 위도 및 경도 좌표와 선택적 고도 좌표를 사용하여 게이트웨이의 위치 정보를 입력합니다. 위치 정보는 WGS84 좌표계를 기반으로 합니다.
**게이트웨이의 위치 보기**
게이트웨이의 위치를 구성한 후 AWS IoT Core for LoRaWAN은 `iotwireless.map`이라고 불리는 Amazon Location 맵을 생성합니다. 이 맵은 **위치(Position)** 탭의 게이트웨이 세부 정보 페이지에서 확인할 수 있습니다. 지정한 위치 좌표에 따라 게이트웨이의 위치가 맵에 마커로 표시됩니다. 확대 또는 축소하여 맵에서 게이트웨이의 위치를 명확하게 볼 수 있습니다. **Position**(위치) 탭에는 정확도 정보와 게이트웨이의 위치가 결정된 타임스탬프도 표시됩니다.
**참고**
Amazon Location Service 맵이 설치되어 있지 않은 경우, 맵에 액세스하고 게이트웨이 위치를 확인하려면 Amazon Location Service를 사용해야 한다는 메시지가 표시됩니다. Amazon Location Service 맵을 사용하면 AWS 계정에 추가 요금이 발생할 수 있습니다. 자세한 내용은 [AWS IoT Core 요금](https://aws.amazon.com/iot-core/pricing/)을 참조하십시오.
`iotwireless.map` 맵은 [https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html](https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html)과 같은 `Get` API 작업을 사용하여 액세스되는 지도 데이터의 소스 역할을 합니다. 맵과 함께 사용되는 `Get` API에 대한 자세한 정보는 [Amazon Location Service API 참조](https://docs.aws.amazon.com/location-maps/latest/APIReference/Welcome.html)를 참고하세요.
이 맵에 대한 추가 세부 정보를 보려면 Amazon Location Service 콘솔로 이동하여 **맵(Maps)**을 선택한 다음 [iotwireless.map](https://console.aws.amazon.com/location/maps/home#/describe/iotwireless.map)을 선택합니다. 자세한 정보는 *Amazon Location Service 개발자 안내서*의 [맵](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html)을 참조하세요.
**게이트웨이의 위치 구성 업데이트**
게이트웨이의 위치 구성을 변경하려면 게이트웨이 세부 정보 페이지에서 **편집(Edit)**을 선택한 다음 위치 정보와 대상을 업데이트합니다.
**참고**
과거 위치 데이터에 대한 정보는 제공되지 않습니다. 게이트웨이의 위치 좌표를 업데이트하면 이전에 보고된 위치 데이터를 덮어씁니다. 위치를 업데이트한 후 게이트웨이 세부 정보의 **위치(Position)** 탭에서 새 위치 정보를 볼 수 있습니다. 타임스탬프의 변화는 새 위치 정보가 마지막으로 알려진 게이트웨이 위치와 동기화되었다는 것을 나타냅니다.
## API를 사용한 게이트웨이 위치 구성
AWS IoT 무선 API 또는 AWS CLI를 사용하여 위치 정보를 지정하고 게이트웨이 위치를 구성할 수 있습니다.
**중요**
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) 및 [ListPositionConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListPositionConfigurations.html)는 더 이상 지원되지 않습니다. 위치 정보를 업데이트하고 검색하기 위한 호출에는 [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) 및 [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) API 작업을 대신 사용해야 합니다.
### 위치 정보 추가
특정 무선 게이트웨이에 정적 위치 정보를 추가하려면 [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) API 작업 또는 [update-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-resource-position.html) CLI 명령을 사용하여 좌표를 지정합니다. `WirelessGateway`를 `ResourceType`으로 지정하고, 업데이트할 무선 게이트웨이의 ID를 `ResourceIdentifier`로 지정하고, 위치 정보를 GeoJSON 페이로드로 지정합니다.
```
aws iotwireless update-resource-position \
--resource-type WirelessGateway \
--resource-id {{"12345678-a1b2-3c45-67d8-e90fa1b2c34d"}} \
--cli-input-json {{file://gatewayposition.json}}
```
다음은 `{{gatewayposition.json}}` 파일의 콘텐츠를 보여줍니다.
**gatewayposition.json의 내용**
```
{
"type": "Point",
"coordinates": {{[33.3318, -22.2155, 13.123]}},
"properties": {
"timestamp": {{"2018-11-30T18:35:24Z"}}
}
}
```
이 명령을 실행하면 출력을 생성하지 않습니다. 지정한 위치 정보를 보려면 `GetResourcePosition` API 작업을 사용합니다.
### 위치 정보 가져오기
특정 무선 게이트웨이에 대한 위치 정보를 가져오려면 [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) API 또는 [get-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position.html) CLI 명령을 사용합니다. `WirelessGateway`를 `resourceType`으로 지정하고 무선 게이트웨이의 ID를 `resourceIdentifier`로 제공합니다.
```
aws iotwireless get-resource-position \
--resource-type WirelessGateway \
--resource-id {{"12345678-a1b2-3c45-67d8-e90fa1b2c34d"}}
```
이 명령을 실행하면 무선 게이트웨이의 위치 정보가 GeoJSON 페이로드로 표시됩니다. 위치 좌표, 위치 정보 유형 및 추가 속성(예: 게이트웨이의 마지막으로 알려진 위치에 해당하는 타임스탬프)에 대한 정보가 표시됩니다.
```
{
{
"type": "Point",
"coordinates": [33.3318,-22.2155,13.123],
"properties": {
"timestamp": "2018-11-30T18:35:24Z"
}
}
}
```