View a markdown version of this page

AWS IoT Core 裝置位置的進階組態 - AWS IoT Core
WiFiCellular 組態使用 AdvancedConfiguration 的 Wi-Fi 承載範例使用 AdvancedConfiguration 的行動承載範例

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

AWS IoT Core 裝置位置的進階組態

您可以使用 AdvancedConfiguration 參數來自訂 AWS IoT Core Device Location 如何解析裝置的位置。使用 GetPositionEstimate API 操作、 AWS IoT 主控台或裝置位置 MQTT 主題時，支援此參數。

注意

AdvancedConfiguration 參數是選用的，目前支援 HTTP API 流程和 MQTT 裝置位置流程。LoRaWAN 裝置位置流程不支援此功能。

未使用此參數的現有整合不會受到影響，並繼續像以前一樣運作。未指定 參數時，會使用預設可信度層級 68%，這是引入此參數之前的預設行為。

WiFiCellular 組態

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

ConfidencePercent

使用 Wi-Fi 或行動測量資料解析裝置位置時使用的可信度百分比。此值決定實際裝置位置落在報告的準確性半徑內的機率。指定介於 50 到 99 之間的整數值。

較高的可信度百分比會產生較大的準確度半徑，而較低的可信度百分比則會產生較小的準確度半徑。未指定此參數時，預設可信度層級為 68%。

注意

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

使用 AdvancedConfiguration 的 Wi-Fi 承載範例

下列範例顯示 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 的行動承載範例

下列範例顯示行動測量承載，其中包含將可信度層級設定為 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"
    }
}