本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon IoT Core 设备定位的高级配置
<a name="device-location-advanced-configuration"></a>

您可以使用`AdvancedConfiguration`参数来自定义 “ Amazon IoT Core 设备位置” 解析设备位置的方式。使用 [GetPositionEstimate](https://docs.amazonaws.cn/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API 操作或 Amazon IoT 控制台时支持此参数。

**注意**  
该`AdvancedConfiguration`参数是可选的，目前仅支持 HTTP API 流程。MQTT 或 LoRa WAN 设备定位流程不支持该功能。  
不使用此参数的现有集成不会受到影响，并且可以像以前一样继续运行。如果未指定参数，则使用 68% 的默认置信度，这是引入此参数之前的默认行为。

**Topics**
+ [WiFiCellular 配置](#device-location-advanced-configuration-wificellular)
+ [Wi-Fi 有效载荷示例 AdvancedConfiguration](#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`配置。

## Wi-Fi 有效载荷示例 AdvancedConfiguration
<a name="device-location-advanced-configuration-wifi-example"></a>

以下示例显示了 Wi-Fi 测量有效负载，其`AdvancedConfiguration`参数将置信度设置为 95%。

```
{
    "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>

以下示例显示了蜂窝测量有效载荷，其`AdvancedConfiguration`参数将置信度设置为 55%。

```
{
    "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"
    }
}
```