# AWS IoT Core for LoRaWAN으로 무선 리소스 위치 구성
| |
| --- |
| 이 기능을 사용하기 전에 LoRaWAN 디바이스의 위치 정보를 확인하기 위해 선택한 서드 파티 공급자는 IGS(International GNSS Service), NASA를 통한 EarthData 또는 기타 서드 파티가 제공하거나 유지 관리하는 데이터 피드 및 데이터 세트를 사용한다는 점에 유의하세요. 이러한 데이터 피드 및 데이터 세트는 서드 파티 콘텐츠(고객 계약에 정의됨)이며 있는 그대로 제공됩니다. 자세한 내용은 [AWS서비스 약관](https://aws.amazon.com/service-terms)을 참조하세요. |
AWS IoT Core for LoRaWAN을 사용하여 정적 위치 데이터를 지정하거나 위치 확인을 활성화하여 서드 파티 솔버를 통해 디바이스의 위치를 실시간으로 식별할 수 있습니다. LoRaWAN 디바이스나 게이트웨이 또는 둘 다에 대한 위치 정보를 추가하거나 업데이트할 수 있습니다.
AWS IoT Core for LoRaWAN에 디바이스 또는 게이트웨이를 추가하거나 디바이스 또는 게이트웨이의 구성 세부 정보를 편집할 때 위치 정보를 지정합니다. 위치 정보는 [GeoJSON](https://geojson.org/) 페이로드로 지정됩니다. GeoJSON 형식은 지리적 데이터 구조를 인코딩하는 데 사용되는 형식입니다. 페이로드에는 [세계 측지 시스템 좌표계(WGS84)](https://gisgeography.com/wgs84-world-geodetic-system/)를 기반으로 하는 디바이스 위치의 위도 및 경도 좌표가 포함됩니다.
솔버가 리소스의 위치를 계산한 후 Amazon Location Service가 있는 경우, 리소스 위치가 표시되는 Amazon Location 맵을 활성화할 수 있습니다. 위치 데이터를 사용하여 다음을 수행할 수 있습니다.
+ 위치 확인을 활성화하여 LoRaWAN 디바이스의 위치를 식별하고 가져옵니다.
+ 게이트웨이와 디바이스의 위치를 추적하고 모니터링합니다.
+ 위치 데이터에 대한 업데이트를 처리하고 이를 다른 AWS 서비스로 라우팅하는 AWS IoT 규칙을 정의합니다. 규칙 작업 목록은 **AWS IoT 개발자 안내서의 [AWS IoT 규칙 작업](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rule-actions.html)을 참조하세요.
+ 위치 데이터와 Amazon SNS를 사용하여, 비정상적인 활동이 발생할 경우 알림을 생성하고 디바이스로 알림을 수신할 수 있습니다.
## LoRaWAN 디바이스의 위치 확인이 작동하는 방식
위치 확인을 활성화하여 서드 파티 Wi-Fi 및 GNSS 솔버를 통해 디바이스의 위치를 식별할 수 있습니다. 이 정보를 사용하여 디바이스를 추적하고 모니터링할 수 있습니다. 다음 단계에서는 위치 확인을 활성화하고 LoRaWAN 디바이스의 위치 정보를 보는 방법을 보여줍니다.
**참고**
서드 파티 솔버는 [LoRa Edge](https://www.semtech.com/products/wireless-rf/lora-edge) 칩이 있는 LoRaWAN 디바이스에서만 사용할 수 있습니다. LoRaWAN 게이트웨이와 함께 사용할 수 없습니다. 게이트웨이의 경우, 여전히 정적 위치 정보를 지정하고 Amazon Location 맵에서 위치를 식별할 수 있습니다.
1.
**디바이스 추가**
위치 확인을 활성화하려면 먼저 AWS IoT Core for LoRaWAN에 디바이스를 추가합니다. LoRaWAN 디바이스에는 LoRa Edge 칩셋이 있어야 합니다. 이 칩셋은 장거리 LoRa 송수신장치, 다중 위성군 GNSS 스캐너 및 패시브 Wi-Fi MAC 스캐너를 통합한 초저전력 플랫폼으로, 지리적 위치 애플리케이션을 대상으로 합니다.
1.
**위치 확인 활성화**
디바이스의 실시간 위치를 확인하려면 위치 확인을 활성화합니다. LoRaWAN 디바이스에서 업링크 메시지를 보내면 메시지에 포함된 Wi-Fi 및 GNSS 스캔 데이터가 지리적 위치 프레임 포트를 사용하여 AWS IoT Core for LoRaWAN으로 전송됩니다.
1.
**위치 정보 검색**
송수신장치의 스캔 결과를 바탕으로 계산된 예상 디바이스 위치를 솔버에서 검색합니다. 위치 정보가 Wi-Fi와 GNSS 스캔 결과를 모두 사용하여 계산된 경우 AWS IoT Core for LoRaWAN은 정확도가 더 높은 예상 위치를 선택합니다.
1.
**위치 정보 보기**
솔버가 위치 정보를 계산한 후 솔버에서 계산한 위치와 사용자가 입력한 정적 위치 정보 간의 차이를 나타내는 정확도 정보가 표시됩니다. Amazon Location 맵에서 디바이스 위치를 확인할 수도 있습니다.
**참고**
LoRaWAN 게이트웨이에는 솔버를 사용할 수 없으므로 정확도 정보는 `0.0`과 같이 보고됩니다.
위치 확인 솔버에 사용되는 업링크 메시지 형식 및 주파수 포트에 대한 자세한 정보는 [AWS IoT Core for LoRaWAN에서 규칙 엔진으로 전송되는 업링크 메시지](lorawan-location-devices.md#lorawan-location-devices-uplink) 섹션을 참조하세요.
## 위치 확인 워크플로 개요
다음 다이어그램은 AWS IoT Core for LoRaWAN이 디바이스 및 게이트웨이의 위치 정보를 저장하고 업데이트하는 방법을 보여 줍니다.
![\[AWS IoT Core for LoRaWAN이 정적 위치 데이터와 원시 데이터를 사용하여 실시간으로 위치를 계산하는 방법을 보여 주는 이미지.\]](http://docs.aws.amazon.com/ko_kr/iot-wireless/latest/developerguide/images/iot-lorawan-lms-architecture.png)
1.
**리소스의 정적 위치 지정**
위도 및 경도 좌표를 사용하여 디바이스 또는 게이트웨이의 정적 위치 정보를 GeoJSON 페이로드로 지정합니다. 고도 좌표를 지정할 수도 있습니다. 이러한 좌표는 WGS84 좌표계를 기반으로 합니다. 자세한 정보는 [ World Geodetic System(WGS84)](https://gisgeography.com/wgs84-world-geodetic-system/)을 참조하세요.
1.
**디바이스에 대한 위치 확인 활성화**
LoRa Edge 칩이 장착된 LoRaWAN 디바이스를 사용하는 경우, 선택적으로 위치 확인을 활성화하여 디바이스 위치를 실시간으로 추적할 수 있습니다. 디바이스에서 업링크 메시지를 보내면 GNSS 및 Wi-Fi 스캔 데이터가 지리적 위치 프레임 포트를 사용하여 AWS IoT Core for LoRaWAN으로 전송됩니다. 그런 다음 솔버는 이 정보를 사용하여 디바이스 위치를 확인합니다.
1.
**위치 데이터를 라우팅할 대상 추가**
디바이스 데이터를 처리하기 위한 IoT 규칙을 설명하는 대상을 추가하고 업데이트된 위치 정보를 AWS IoT Core for LoRaWAN으로 라우팅할 수 있습니다. Amazon Location 맵에서 리소스의 마지막으로 알려진 위치를 볼 수도 있습니다.
## 리소스 위치 구성
AWS Management Console, AWS IoT 무선 API 또는 AWS CLI를 사용하여 리소스 위치를 구성할 수 있습니다.
디바이스에 LoRa Edge 칩이 있는 경우, 위치 확인을 활성화하여 실시간 위치 정보를 계산할 수도 있습니다. 게이트웨이의 경우에도 정적 위치 좌표를 입력하고 Amazon Location을 사용하여 Amazon Location 맵에서 게이트웨이 위치를 추적할 수 있습니다.
**Topics**
+ [LoRaWAN 디바이스의 위치 확인이 작동하는 방식](#lorawan-location-solver)
+ [위치 확인 워크플로 개요](#lorawan-location-workflow)
+ [리소스 위치 구성](#lorawan-location-how)
+ [LoRaWAN 게이트웨이의 위치 구성](lorawan-location-gateways.md)
+ [LoRaWAN 디바이스의 위치 구성](lorawan-location-devices.md)
# 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"
}
}
}
```
# LoRaWAN 디바이스의 위치 구성
디바이스를 AWS IoT Core for LoRaWAN에 추가할 때 정적 위치 정보를 지정하고, 선택적으로 위치 확인을 활성화하고, 대상을 지정할 수 있습니다. 대상은 디바이스의 위치 정보를 처리하고 업데이트된 위치를 Amazon Location Service에 라우팅하는 IoT 규칙을 설명합니다. 디바이스 위치를 구성하면 위치 데이터가 Amazon Location 맵에 정확도 정보 및 지정한 대상과 함께 표시됩니다.
AWS Management Console, AWS IoT 무선 API 또는 AWS CLI를 사용하여 디바이스 위치를 구성할 수 있습니다.
## 업링크 메시지의 프레임 포트 및 형식
위치 확인을 활성화하는 경우 디바이스의 Wi-Fi 및 GNSS 스캔 데이터를 AWS IoT Core for LoRaWAN에 전달하기 위한 지리적 위치 프레임 포트를 지정해야 합니다. 위치 정보는 이 프레임 포트를 사용하여 AWS IoT Core for LoRaWAN으로 전달됩니다.
LoRaWAN 사양은 서로 다른 유형의 메시지를 구별하기 위해 데이터 전송 필드(FRMPayload)와 포트 필드(FPort)를 제공합니다. 위치 정보를 전달하기 위해 프레임 포트에 1부터 223 사이의 값을 지정할 수 있습니다. FPort 0은 MAC 메시지 전용이고, FPort 224는 MAC 규정 준수 테스트 전용이며, 포트 225\$1255는 향후 표준화된 애플리케이션 확장 전용입니다.
### AWS IoT Core for LoRaWAN에서 규칙 엔진으로 전송되는 업링크 메시지
대상을 추가하면 대상은 규칙 엔진을 사용하여 데이터를 Amazon Location Service로 라우팅하는 AWS IoT 규칙을 생성합니다. 그 후 업데이트된 위치 정보가 Amazon Location 맵에 표시됩니다. 위치 확인을 활성화하지 않은 경우, 대상은 디바이스의 정적 위치 좌표를 업데이트할 때 위치 데이터를 라우팅합니다.
다음 코드는 AWS IoT Core for LoRaWAN에서 전송된 업링크 메시지(위치 정보, 정확도, 솔버 구성 및 무선 메타데이터 포함)의 형식을 보여 줍니다. 아래에 강조 표시된 필드는 선택 사항입니다. 수직 정확도 정보가 없는 경우, 값은 `null`입니다.
```
{
// Position configuration parameters for given wireless device
"WirelessDeviceId": "5b58245e-146c-4c30-9703-0ca942e3ff35",
// Position information for a device in GeoJSON format. Altitude
// is optional. If no vertical accuracy information is available
// or positioning isn't activated, the value is set to null.
// The position information coordinates are listed in the order
// [longitude, latitude, altitude].
"coordinates": [33.33000183105469, -22.219999313354492, 99.0],
"type": "Point",
"properties": {
"horizontalAccuracy": number,
"verticalAccuracy": number",
"timestamp": "2022-08-19T03:08:35.061Z"
},
//Parameters controlled by AWS IoT Core for LoRaWAN
"WirelessMetadata":
{
"LoRaWAN":
{
"ADR": false,
"Bandwidth": 125,
"ClassB": false,
"CodeRate": "4/5",
"DataRate": "0",
"DevAddr": "00b96cd4",
"DevEui": "58a0cb000202c99",
"FOptLen": 2,
"FCnt": 1,
"Fport": 136,
"Frequency": "868100000",
"Gateways": [
{
"GatewayEui": "80029cfffe5cf1cc",
"Snr": -29,
"Rssi": 9.75
}
],
"MIC": "7255cb07",
"MType": "UnconfirmedDataUp",
"Major": "LoRaWANR1",
"Modulation": "LORA",
"PolarizationInversion": false,
"SpreadingFactor": 12,
"Timestamp": "2021-05-03T03:24:29Z"
}
}
}
```
## 콘솔을 사용하여 디바이스의 위치 구성
AWS Management Console을 사용하여 디바이스의 위치를 구성하고 관리하려면, 먼저 콘솔에 로그인한 다음 AWS IoT 콘솔의 [https://console.aws.amazon.com/iot/home#/wireless/devices](https://console.aws.amazon.com/iot/home#/wireless/devices)(디바이스) 허브 페이지로 이동합니다.
**위치 정보 추가**
디바이스의 위치 정보를 추가하려면:
1. **디바이스(Devices)** 허브 페이지에서 **무선 디바이스 추가(Add wireless device)**를 선택합니다.
1. 무선 디바이스 사양, 디바이스 및 서비스 프로파일, 데이터를 다른 AWS 서비스로 라우팅하기 위한 IoT 규칙을 정의하는 대상을 입력합니다. 자세한 내용은 [AWS IoT Core for LoRaWAN에 디바이스 온보딩](lorawan-onboard-end-devices.md) 단원을 참조하십시오.
1. 위치 정보를 입력하고, 선택적으로 지리적 위치를 활성화하고, 메시지 라우팅에 사용할 위치 데이터 대상을 지정합니다.
+
**위치 정보**
위도 및 경도 좌표와 선택적으로 고도 좌표를 사용하여 디바이스의 위치 데이터를 지정합니다. 위치 정보는 WGS84 좌표계를 기반으로 합니다.
+
**지리적 위치**
AWS IoT Core for LoRaWAN이 디바이스 위치를 계산하는 데 지리적 위치를 사용하도록 하려면 위치 확인을 활성화합니다. 서드 파티 GNSS 및 Wi-Fi 솔버를 사용하여 디바이스의 위치가 실시간으로 식별됩니다.
지리적 위치 정보를 입력하려면 **위치 확인 활성화**를 선택하고 GNSS 및 Wi-Fi 스캔 데이터를 AWS IoT Core for LoRaWAN에 전달하기 위한 지리적 위치 프레임 포트를 입력합니다. 참조용으로 기본 FPort가 채워져 있습니다. 그러나 1부터 223 사이에서 다른 값을 선택할 수 있습니다.
+
**위치 데이터 대상**
디바이스의 위치 데이터를 처리하고 처리된 위치를 AWS IoT Core for LoRaWAN으로 전달하는 AWS IoT 규칙을 설명하기 위한 대상을 선택합니다. 이 대상은 위치 데이터의 라우팅에만 사용합니다. 디바이스 데이터를 다른 AWS 서비스로 라우팅하는 데 사용하는 대상과 달라야 합니다.
**디바이스의 위치 구성 보기**
디바이스의 위치를 구성한 후 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 명령을 사용하여 좌표를 지정합니다. `WirelessDevice`를 `ResourceType`으로 지정하고, 업데이트할 무선 디바이스의 ID를 `ResourceIdentifier`로 지정하고, 위치 정보를 지정합니다.
```
aws iotwireless update-resource-position \
--resource-type WirelessDevice \
--resource-id "1ffd32c8-8130-4194-96df-622f072a315f" \
--position [33.33, -33.33, 10.0]
```
다음은 `deviceposition.json` 파일의 콘텐츠를 보여줍니다. 지리적 위치 데이터를 전송하기 위한 FPort 값을 지정하려면 [위치 확인](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_Positioning.html) 객체를 [CreateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) 및 [UpdateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDevice.html) API 작업과 함께 사용합니다.
**deviceposition.json의 내용**
```
{
"type": "Point",
"coordinates": [33.3318, -22.2155, 13.123],
"properties": {
"verticalAccuracy": 707,
"horizontalAccuracy":
"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-resource-position.html) CLI 명령을 사용합니다. `WirelessDevice`를 `resourceType`으로 지정하고 무선 디바이스 ID를 `resourceIdentifier`로 제공합니다.
```
aws iotwireless get-resource-position \
--resource-type WirelessDevice \
--resource-id "1ffd32c8-8130-4194-96df-622f072a315f"
```
이 명령을 실행하면 무선 디바이스의 위치 정보가 GeoJSON 페이로드로 표시됩니다. 위치 좌표, 위치 유형 그리고 디바이스의 마지막으로 알려진 위치에 해당하는 타임스탬프 및 정확도 정보를 비롯한 속성에 대한 정보가 표시됩니다.
```
{
"type": "Point",
"coordinates": [33.3318, -22.2155, 13.123],
"properties": {
"verticalAccuracy": 707,
"horizontalAccuracy": 389,
"horizontalConfidenceLevel": 0.68,
"verticalConfidenceLevel": 0.68,
"timestamp": "2018-11-30T18:35:24Z"
}
}
```