View a markdown version of this page

Configuração avançada para localização AWS IoT Core do dispositivo - AWS IoT Core
WiFiCellular configuraçãoExemplo de carga útil de Wi-Fi com AdvancedConfigurationExemplo de carga útil celular com AdvancedConfiguration

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configuração avançada para localização AWS IoT Core do dispositivo

Você pode usar o AdvancedConfiguration parâmetro para personalizar como a localização do AWS IoT Core dispositivo resolve a localização dos seus dispositivos. Esse parâmetro é suportado ao usar a operação GetPositionEstimateda API ou o AWS IoT console.

nota

O AdvancedConfiguration parâmetro é opcional e atualmente é compatível somente com o fluxo da API HTTP. Não é compatível com os fluxos de localização de dispositivos MQTT ou LoRa WAN.

As integrações existentes que não usam esse parâmetro não são afetadas e continuam funcionando como antes. Quando o parâmetro não é especificado, o nível de confiança padrão de 68 por cento é usado, que é o comportamento padrão antes da introdução desse parâmetro.

WiFiCellular configuração

A WiFiCellular configuração se aplica quando seus dados de medição contêm informações de Wi-Fi, celular ou ambas as cargas úteis. Use essa configuração para personalizar o nível de confiança dos solucionadores baseados em Wi-Fi e celular.

ConfidencePercent

A porcentagem de confiança usada ao resolver a localização do dispositivo com dados de medição de Wi-Fi ou celular. Esse valor determina a probabilidade de que a localização real do dispositivo esteja dentro do raio de precisão relatado. Especifique um valor inteiro entre 50 e 99.

Uma porcentagem de confiança maior resulta em um raio de precisão maior, enquanto uma porcentagem de confiança menor resulta em um raio de precisão menor. O nível de confiança padrão é de 68 por cento quando esse parâmetro não é especificado.

nota

A WiFiCellular configuração é usada somente quando os dados de medição contêm informações de Wi-Fi ou celular. Se os dados de medição contiverem somente outros tipos, como endereço IP ou GNSS, a WiFiCellular configuração será ignorada.

Exemplo de carga útil de Wi-Fi com AdvancedConfiguration

O exemplo a seguir mostra uma carga útil de medição de Wi-Fi com o AdvancedConfiguration parâmetro que define o nível de confiança em 95 por cento.

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

A carga útil GeoJSON a seguir mostra a localização resolvida com o nível de confiança definido como 0,95, correspondendo à confiança de 95% solicitada.

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

Exemplo de carga útil celular com AdvancedConfiguration

O exemplo a seguir mostra uma carga útil de medição celular com o AdvancedConfiguration parâmetro que define o nível de confiança em 55 por cento.

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

A carga útil GeoJSON a seguir mostra a localização resolvida com o nível de confiança definido como 0,55, correspondendo aos 55 por cento de confiança solicitados.

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