View a markdown version of this page

AWS IoT Core 设备定位的高级配置 - AWS IoT Core
WiFiCellular 配置Wi-Fi 有效载荷示例 AdvancedConfiguration蜂窝网络有效载荷示例 AdvancedConfiguration

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

AWS IoT Core 设备定位的高级配置

您可以使用AdvancedConfiguration参数来自定义 “ AWS IoT Core 设备位置” 解析设备位置的方式。使用 GetPositionEstimateAPI 操作或 AWS IoT 控制台时支持此参数。

注意

该AdvancedConfiguration参数是可选的，目前仅支持 HTTP API 流程。MQTT 或 LoRa WAN 设备定位流程不支持该功能。

不使用此参数的现有集成不会受到影响，并且可以像以前一样继续运行。如果未指定参数，则使用 68% 的默认置信度，这是引入此参数之前的默认行为。

WiFiCellular 配置

当您的测量数据包含 Wi-Fi、蜂窝网络或两者的有效载荷信息时，该WiFiCellular配置适用。使用此配置可以自定义基于 Wi-Fi 和蜂窝网络的求解器的置信度。

ConfidencePercent

使用 Wi-Fi 或蜂窝网络测量数据解析设备位置时使用的置信度百分比。该值决定了实际设备位置落在报告的精度半径范围内的概率。指定一个介于 50 和 99 之间的整数值。

置信百分比越高，精度半径越大，而置信百分比越低，精度半径越小。如果未指定此参数，则默认置信度为 68%。

注意

仅当测量数据包含 Wi-Fi 或蜂窝网络信息时才使用该WiFiCellular配置。如果测量数据仅包含其他类型，例如 IP 地址或 GNSS，则会忽略WiFiCellular配置。

Wi-Fi 有效载荷示例 AdvancedConfiguration

以下示例显示了 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

以下示例显示了蜂窝测量有效载荷，其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"
    }
}