View a markdown version of this page

Advanced configuration for AWS IoT Core Device Location - AWS IoT Core
WiFiCellular configurationWi-Fi payload example with AdvancedConfigurationCellular payload example with AdvancedConfiguration

Advanced configuration for AWS IoT Core Device Location

You can use the AdvancedConfiguration parameter to customize how AWS IoT Core Device Location resolves the location of your devices. This parameter is supported when using the GetPositionEstimate API operation or the AWS IoT console.

Note

The AdvancedConfiguration parameter is optional and currently supported only for the HTTP API flow. It is not supported for the MQTT or LoRaWAN device location flows.

Existing integrations that do not use this parameter are not affected and continue to work as before. When the parameter is not specified, the default confidence level of 68 percent is used, which is the default behavior prior to the introduction of this parameter.

WiFiCellular configuration

The WiFiCellular configuration applies when your measurement data contains Wi-Fi, Cellular or both payload information. Use this configuration to customize the confidence level for the Wi-Fi and Cellular based solvers.

ConfidencePercent

The confidence percentage used when resolving the device location with Wi-Fi or Cellular measurement data. This value determines the probability that the actual device location falls within the reported accuracy radius. Specify an integer value between 50 and 99.

A higher confidence percentage results in a larger accuracy radius, while a lower confidence percentage results in a smaller accuracy radius. The default confidence level is 68 percent when this parameter is not specified.

Note

The WiFiCellular configuration is used only when the measurement data contains Wi-Fi or Cellular information. If the measurement data contains only other types, such as IP address or GNSS, the WiFiCellular configuration is ignored.

Wi-Fi payload example with AdvancedConfiguration

The following example shows a Wi-Fi measurement payload with the AdvancedConfiguration parameter that sets the confidence level to 95 percent.

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

The following GeoJSON payload shows the resolved location with the confidence level set to 0.95, matching the requested 95 percent confidence.

{
    "coordinates": [
        23.864079,
        61.44683
    ],
    "type": "Point",
    "properties": {
        "horizontalAccuracy": 22,
        "horizontalConfidenceLevel": 0.95,
        "timestamp": "2026-04-03T00:13:15.134343033Z"
    }
}

Cellular payload example with AdvancedConfiguration

The following example shows a cellular measurement payload with the AdvancedConfiguration parameter that sets the confidence level to 55 percent.

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

The following GeoJSON payload shows the resolved location with the confidence level set to 0.55, matching the requested 55 percent confidence.

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