Формат запроса

POST https://locator.api.maps.yandex.ru/v1/locate?apikey=YOUR_APIKEY
Content-Type: application/json
User-Agent: <product> / <product-version> <comment>

{
    "wifi": ... ,
    "cell": ... ,
    "ip": ...
}
curl
curl -H "Content-Type: application/json" \
    -X POST "https://locator.api.maps.yandex.ru/v1/locate?apikey=YOUR_API_KEY" \
    -d '{
            "wifi": [
                {"age": 100,"bssid": "744d28cd6a10","signal_strength": -89},
                {"age": 90,"bssid": "86d9e7c78b20","signal_strength": -84},
                {"age": 110,"bssid": "b869f47255d9","signal_strength": -75}
            ],
            "cell": [
                {"gsm": {"mcc": 250,"mnc": 99,"lac": 65534,"cid": 129430793,"signal_strength": -38}}
            ],
            "ip": [
                {"address": "217.118.76.34"}
            ]
        }'

Параметры

apikey

Обязательный параметр

Ключ, полученный в Кабинете Разработчика.

Тело запроса

Поле Тип Обязательность Описание
wifi Wifi[] - Массив WiFi объектов
cell Cell[] - Массив Cell объектов
ip Ip[] - Массив IP объектов
Пример
{
    "wifi": [
        {
            "bssid": "2CD02D814C80",
            "signal_strength": -60,
            "channel" : 345,
            "age" : 100
        }
    ],
    "cell": [
        {
            "lte": {
                "mcc": 54157923,
                "mnc": 29,
                "tac": 27837,
                "ci": 40,
                "signal_strength": -60,
            }
        },
        {
            "gsm": {
                "mcc": 14157933,
                "mnc": 99,
                "lac": 27864,
                "cid": 248,
                "signal_strength": -60,
            }
        }
    ],
    "ip": [
        {"address": "95.108.173.231"}
    ]
}

WiFi

Поле Тип Обязательность Описание
bssid string + MAC-адрес узла Wi-Fi
signal_strength number + Текущая мощность сигнала, dBm
channel number - Канал взаимодействия с точкой доступа
age number - Как давно получен сигнал, мс
Пример
{
    "wifi": [
        {
            "bssid": "2CD02D814C80",
            "signal_strength": -60,
            "channel" : 345,
            "age" : 100
        }
    ]
}

Cell

Поле Тип Обязательность Описание
gsm object GSM - Объект GSM (2G) сети
wcdma object WCDMA - Объект WCDMA (3G) сети
lte object LTE - Объект LTE (4G) сети

Примечание

В одном объекте cell должен быть один из объектов gsm, wcdma, lte.

GSM

Поле Тип Обязательность Описание
mcc number + Код страны (Mobile Country Code)
mnc number + Код сети мобильной связи (Mobile Network Code)
lac number + Код зоны местоположения (Location Area Code)
cid number + Уникальный идентификатор соты
signal_strength number + Текущая мощность сигнала, dBm
bsic number - Код базовой станции (Base Station Identity Code)
arfcn number - Абсолютный радиочастотный номер канала (Absolute RF Channel Number)
age number - Как давно получен сигнал, мс
timing_advance number - Значение опережения синхронизации

WCDMA

Поле Тип Обязательность Описание
mcc number + Код страны (Mobile Country Code)
mnc number + Код сети мобильной связи (Mobile Network Code)
lac number + Код зоны местоположения (Location Area Code)
cid number + Уникальный идентификатор соты
signal_strength number + Текущая мощность сигнала, dBm
psc number - Первичный скремблирующий код (UMTS Primary Scrambling Code)
uarfcn number - Абсолютный радиочастотный номер канала (UMTS Absolute RF Channel Number)
age number - Количество мс с тех пор, как эта сота была основной

LTE

Поле Тип Обязательность Описание
mcc number + Код страны (Mobile Country Code)
mnc number + Код сети мобильной связи (Mobile Network Code)
tac number + Код зоны отслеживания (Tracking Area Code)
ci number + Уникальный идентификатор соты
signal_strength number + Текущая мощность сигнала, dBm
pci number - Физический идентификатор соты (Physical cell Id)
earfcn number - Абсолютный радиочастотный номер канала (Absolute RF Channel Number)
age number - Количество мс с тех пор, как эта сота была основной
timing_advance number - Значение опережения синхронизации
Пример
{
    "cell": [
        {
            "lte": {
                "age": 452,
                "earfcn": 1602,
                "ci": 268435455,
                "mcc": 0,
                "tac": 65535,
                "mnc": 0,
                "pci": 124,
                "signal_strength": -67
            }
        },
        {
            "wcdma": {
                "age": 452,
                "uarfcn": 2850,
                "cid": 248700418,
                "mcc": 250,
                "lac": 7702,
                "mnc": 2,
                "psc": 261,
                "signal_strength": -84
            }
        },
        {
            "gsm": {
                "mcc": 250,
                "mnc": 99,
                "lac": 65534,
                "cid": 129430793,
                "signal_strength": -38
            }
        }
    ]
}

IP

Поле Тип Обязательность Описание
address string + IPv4 или IPv6 адрес устройства
Пример
{
    "ip": [
        {
            "address": "95.108.173.231"
        }
    ]
}
Предыдущая
Быстрый старт
Следующая
Формат ответа