Геолокация определяет местоположение клиента по IP-адресу.

Запрос

Для пользователей подсказок DaData.ru:

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/detectAddressByIp?ip=213.180.193.3

Для пользователей standalone-подсказок:

curl -X GET \
  -H "Accept: application/json" \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/detectAddressByIp?ip=213.180.193.3

Параметры

ПараметрОбязательный?Описание
ipнетIP-адрес. Если не указан, используется IP-адрес из HTTP-запроса

Ответ

Объект вида:

{
    "location": {
        "data": { ... },
        "value": "83.220.54.223"
    }
}

Где location.value — это IP-адрес клиента, а location.data —  объект адреса . Если местоположение определить не удалось, то  location.data = null.

Алгоритм определения IP адреса следующий:

Если IP указан в параметре ip
ТО
   использовать его
ИНАЧЕ
   Если IP указан в HTTP-заголовке X-Forwarded-For
   ТО
       использовать его
    ИНАЧЕ
       вернуть IP сокета соединения

Местоположение определяется только для российских адресов.

Почтовый индекс

Метод возвращает индекс, который есть в базе налоговой службы (ФИАС). Для населённых пунктов и городов он часто пустой.

Если вам нужен индекс — возьмите из результата значение fias_id и отправьте его в метод «Адрес по коду ФИАС» — вернётся индекс (работает только в облачных подсказках и расширенной «коробке»).