Геолокация определяет местоположение клиента по IP-адресу.
С версии 18.12 «Подсказок» поддерживается формат адреса IPv6.
Запрос
В версии 19.2 изменился формат запроса
Для пользователей подсказок DaData.ru:
curl -X GET \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/iplocate/address?ip=213.180.193.3
Для пользователей standalone-подсказок:
curl -X GET \ -H "Accept: application/json" \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/iplocate/address?ip=2a0d:e100::12
Заголовки
Заголовок | Описание |
---|---|
| Тип данных в запросе: |
| Тип данных в ответе: application/json или application/xml |
| API-ключ в формате: Только для пользователей подсказок DaData.ru |
Параметры
Параметр | Обязательный? | Описание |
---|---|---|
ip | нет | IP-адрес. Если не указан, используется IP-адрес из HTTP-запроса |
Ответ (18.12 и раньше)
Объект вида:
{ "location": { "value": "83.220.54.223", "unrestricted_value": null, "data": { ... } } }
Где location.value — это IP-адрес клиента, а location.data заполнен аналогично полю data в объекте адреса.
Ответ (19.1+)
Объект вида:
{ "location": { "value": "г Москва", "unrestricted_value": "г Москва", "data": { ... } } }
Где location — это объект адреса.
Если местоположение определить не удалось, то location = null:
{ "location": null }
Алгоритм выбора IP-адреса из параметров запроса
ЕСЛИ IP указан в параметре ip ТО использовать его ИНАЧЕ ЕСЛИ IP указан в HTTP-заголовке X-Forwarded-For ТО использовать его ИНАЧЕ вернуть IP сокета соединения
Местоположение определяется только для российских адресов.
Обзор
Инструменты контента