Запрос

Чтобы получить ответ о местоположении мобильного устройства, отправьте POST-запрос к ресурсу geolocation. Передайте данные в формате JSON:

• в стандартном виде;
• в сжатом виде.

Яндекс Локатор обработает данные из запроса в следующей последовательности:

1. Точки доступа Wi-Fi.
2. Сигналы сетей мобильной связи.
3. IP-адрес.

Если Яндекс Локатор успешно определит местоположение, он вернет ответ с координатами точки и радиусом погрешности. В противном случае вы получите сообщение об ошибке.

Для API Яндекс Локатора установлен лимит на количество запросов в секунду (RPS): до 1800. Считается как сумма запросов со стороны клиента и со стороны сервера.

Стандартный запросСтандартный запрос

Передайте данные о мобильном устройстве и его окружении в параметре запроса json.

Host: api.lbs.yandex.net
POST /geolocation

json={
   "common": {
      "version": "1.0",
      "api_key": "ABC1WU0BAAAANfFuIQIAV1pUEYIBeogyUNvVbhNaJPWeM-AAAAAAAAAAAACRXgDsaYNpZWpBczn4Lq6QmkwK6g==",
      "device_manufacturer": "samsung",
      "device_model": "SM-A125F"
   },
   "gsm_cells": [
       {
          "countrycode": 250,
          "operatorid": 2,
          "cellid": 197403650,
          "lac": 9900,
          "signal_strength": -80,
          "age": 1000
       }
   ],
   "wifi_networks": [
       {
          "mac": "2CD02D814C80",
          "signal_strength": -68,
          "age": 500,
       },
       {
          "mac": "E4AA5DE28CD0",
          "signal_strength": -60,
          "age": 500,
       }
   ],
   "ip": {
     "address_v4": "95.108.173.231"
   }
}

curl -X POST 'http://api.lbs.yandex.net/geolocation' -d 'json={"common": {"version": "1.0", "api_key": "ABC1WU0BAAAANfFuIQIAV1pUEYIBeogyUNvVbhNaJPWeM-AAAAAAAAAAAACRXgDsaYNpZWpBczn4Lq6QmkwK6g=="}, "gsm_cells": [ { "countrycode": 250, "operatorid": 2, "cellid": 197403650, "lac": 9900, "signal_strength": -80, "age": 1000} ], "wifi_networks": [ {"mac": "2CD02D814C80", "signal_strength": -68, "age": 500}, {"mac": "E4AA5DE28CD0", "signal_strength": -60, "age": 500} ], "ip": {"address_v4": "95.108.173.231"}}'

КлючиКлючи

Запрос c сжатыми даннымиЗапрос c сжатыми данными

Сожмите JSON с данными утилитой gzip и передайте его в запросе, указав заголовок Content-Type: multipart/from-data и параметр gzip с любым непустым значением.

Включите в запрос с типом multipart/from-data две части:

1. gzip — индикатор запроса с сжатыми данными;
2. json — параметр, содержащий сжатые данные JSON.

В каждой части запроса укажите значение одного параметра после разделителя boundary и заголовка Content-Disposition с именем параметра. Значение параметра отделите от предшествующих заголовков пустой строкой.

Отправьте POST-запрос к ресурсу geolocation.

POST /geolocation?gzip=1
Host: api.lbs.yandex.net
Accept-Encoding: identity
Content-Type: multipart/form-data; boundary=YANDEXLOCATORBOUNDARY
Content-length: 538

--YANDEXLOCATORBOUNDARY
Content-Disposition: form-data; name="gzip"

1
--YANDEXLOCATORBOUNDARY
Content-Disposition: form-data; name="json"
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary

СЖАТЫЕ ДАННЫЕ
--YANDEXLOCATORBOUNDARY--

curl -X POST 'http://api.lbs.yandex.net/geolocation?gzip=1' -H 'Content-Type: multipart/form-data' -F json=@data.json.gz

КлючиКлючи