本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS IoT Core 裝置位置的進階組態
<a name="device-location-advanced-configuration"></a>

您可以使用 `AdvancedConfiguration` 參數來自訂 AWS IoT Core Device Location 如何解析裝置的位置。使用 [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>

當您的測量資料包含 Wi-Fi、行動或兩者承載資訊時，就會套用此`WiFiCellular`組態。使用此組態來自訂 Wi-Fi 和行動網路求解器的可信度等級。

`ConfidencePercent`  
使用 Wi-Fi 或行動測量資料解析裝置位置時使用的可信度百分比。此值決定實際裝置位置落在報告的準確性半徑內的機率。指定介於 50 到 99 之間的整數值。  
較高的可信度百分比會產生較大的準確度半徑，而較低的可信度百分比則會產生較小的準確度半徑。未指定此參數時，預設可信度層級為 68%。

**注意**  
只有在測量資料包含 Wi-Fi 或行動網路資訊時，才會使用`WiFiCellular`組態。如果測量資料僅包含其他類型，例如 IP 地址或 GNSS，則會忽略`WiFiCellular`組態。

## 使用 AdvancedConfiguration 的 Wi-Fi 承載範例
<a name="device-location-advanced-configuration-wifi-example"></a>

下列範例顯示 Wi-Fi 測量承載，其中包含將可信度層級設定為 95% 的 `AdvancedConfiguration` 參數。

```
{
    "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 承載顯示已解析的位置，其可信度等級設定為 0.95，符合請求的 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 承載顯示已解析的位置，其可信度等級設定為 0.55，符合請求的 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"
    }
}
```