

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS IoT Core 디바이스 위치에 대한 고급 구성
<a name="device-location-advanced-configuration"></a>

`AdvancedConfiguration` 파라미터를 사용하여 AWS IoT Core 디바이스 위치가 디바이스의 위치를 확인하는 방법을 사용자 지정할 수 있습니다. 이 파라미터는 [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html) API 작업 또는 AWS IoT 콘솔을 사용할 때 지원됩니다.

**참고**  
`AdvancedConfiguration` 파라미터는 선택 사항이며 현재 HTTP API 흐름에서만 지원됩니다. MQTT 또는 LoRaWAN 디바이스 위치 흐름에는 지원되지 않습니다.  
이 파라미터를 사용하지 않는 기존 통합은 영향을 받지 않으며 이전과 같이 계속 작동합니다. 파라미터를 지정하지 않으면이 파라미터를 도입하기 전의 기본 동작인 68%의 기본 신뢰 수준이 사용됩니다.

**Topics**
+ [WiFiCellular 구성](#device-location-advanced-configuration-wificellular)
+ [AdvancedConfiguration을 사용한 Wi-Fi 페이로드 예제](#device-location-advanced-configuration-wifi-example)
+ [AdvancedConfiguration을 사용한 셀룰러 페이로드 예제](#device-location-advanced-configuration-cellular-example)

## WiFiCellular 구성
<a name="device-location-advanced-configuration-wificellular"></a>

`WiFiCellular` 구성은 측정 데이터에 Wi-Fi, 셀룰러 또는 두 페이로드 정보가 모두 포함된 경우에 적용됩니다. 이 구성을 사용하여 Wi-Fi 및 셀룰러 기반 솔버의 신뢰도 수준을 사용자 지정합니다.

`ConfidencePercent`  
Wi-Fi 또는 셀룰러 측정 데이터를 사용하여 디바이스 위치를 확인할 때 사용되는 신뢰도 백분율입니다. 이 값은 실제 디바이스 위치가 보고된 정확도 반경 내에 속할 확률을 결정합니다. 50에서 99 사이의 정수 값을 지정합니다.  
신뢰도가 높을수록 정확도 반경이 커지고 신뢰도가 낮을수록 정확도 반경이 작아집니다. 이 파라미터를 지정하지 않으면 기본 신뢰도 수준은 68%입니다.

**참고**  
`WiFiCellular` 구성은 측정 데이터에 Wi-Fi 또는 셀룰러 정보가 포함된 경우에만 사용됩니다. 측정 데이터에 IP 주소 또는 GNSS와 같은 다른 유형만 포함된 경우 `WiFiCellular` 구성이 무시됩니다.

## AdvancedConfiguration을 사용한 Wi-Fi 페이로드 예제
<a name="device-location-advanced-configuration-wifi-example"></a>

다음 예제에서는 신뢰도 수준을 95%로 설정하는 `AdvancedConfiguration` 파라미터가 있는 Wi-Fi 측정 페이로드를 보여줍니다.

```
{
    "Timestamp": {{1664313161}},
    "WiFiAccessPoints": [
        {
            "MacAddress": "{{A0:EC:F9:1E:32:C1}}",
            "Rss": {{-75}}
        },
        {
            "MacAddress": "{{A0:EC:F9:15:72:5E}}",
            "Rss": {{-67}}
        }
    ],
    "AdvancedConfiguration": {
        "WiFiCellular": {
            "ConfidencePercent": {{95}}
        }
    }
}
```

다음 GeoJSON 페이로드는 요청된 95% 신뢰도와 일치하는 신뢰도 수준이 0.95로 설정된 확인된 위치를 보여줍니다.

```
{
    "coordinates": [
        23.864079,
        61.44683
    ],
    "type": "Point",
    "properties": {
        "horizontalAccuracy": 22,
        "horizontalConfidenceLevel": 0.95,
        "timestamp": "2026-04-03T00:13:15.134343033Z"
    }
}
```

## AdvancedConfiguration을 사용한 셀룰러 페이로드 예제
<a name="device-location-advanced-configuration-cellular-example"></a>

다음 예제에서는 신뢰도 수준을 55%로 설정하는 `AdvancedConfiguration` 파라미터가 있는 셀룰러 측정 페이로드를 보여줍니다.

```
{
    "Timestamp": {{1664313161}},
    "CellTowers": {
        "Gsm": [{
            "Mcc": {{262}},
            "Mnc": {{1}},
            "Lac": {{5126}},
            "GeranCid": {{16504}},
            "GsmLocalId": {
                "Bsic": {{6}},
                "Bcch": {{82}}
            },
            "GsmTimingAdvance": {{1}},
            "RxLevel": {{-110}},
            "GsmNmr": [{
                "Bsic": {{7}},
                "Bcch": {{85}},
                "RxLevel": {{-100}},
                "GlobalIdentity": {
                    "Lac": {{1}},
                    "GeranCid": {{1}}
                }
            }]
        }],
        "Wcdma": [{
            "Mcc": {{262}},
            "Mnc": {{7}},
            "Lac": {{65535}},
            "UtranCid": {{14674663}},
            "WcdmaNmr": [{
                    "Uarfcndl": {{10786}},
                    "UtranCid": {{14674663}},
                    "Psc": {{149}}
                },
                {
                    "Uarfcndl": {{10762}},
                    "UtranCid": {{14674663}},
                    "Psc": {{211}}
                }
            ]
        }],
        "Lte": [{
            "Mcc": {{262}},
            "Mnc": {{2}},
            "EutranCid": {{2898945}},
            "Rsrp": {{-50}},
            "Rsrq": {{-5}},
            "LteNmr": [{
                    "Earfcn": {{6300}},
                    "Pci": {{237}},
                    "Rsrp": {{-60}},
                    "Rsrq": {{-6}},
                    "EutranCid": {{2898945}}
                },
                {
                    "Earfcn": {{6300}},
                    "Pci": {{442}},
                    "Rsrp": {{-70}},
                    "Rsrq": {{-7}},
                    "EutranCid": {{2898945}}
                }
            ]
        }]
    },
    "AdvancedConfiguration": {
        "WiFiCellular": {
            "ConfidencePercent": {{55}}
        }
    }
}
```

다음 GeoJSON 페이로드는 요청된 55% 신뢰도와 일치하는 신뢰도 수준이 0.55로 설정된 확인된 위치를 보여줍니다.

```
{
    "coordinates": [
        13.376077,
        52.51823,
        80.1
    ],
    "type": "Point",
    "properties": {
        "verticalAccuracy": 34,
        "verticalConfidenceLevel": 0.55,
        "horizontalAccuracy": 254,
        "horizontalConfidenceLevel": 0.55,
        "timestamp": "2026-04-06T23:43:45.198088456Z"
    }
}
```