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 主控台時，支援此參數。

注意

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