Ищет адреса по любой части адреса от региона до дома («тверская нижний 12» → «Нижегородская обл, г Нижний Новгород, ул Тверская, д 12»). Также ищет по почтовому индексу («105568» → «г Москва, ул Магнитогорская»).
Что умеет:
✔️ Работает по всем странам мира (по России и Белоруссии до дома, по остальным странам — до города). Ищет и показывает результаты как на русском языке («Самара, пр-кт Металлургов»), так и на английском («Russia, gorod Samara, prospekt Metallurgov»).
✔️ Находит актуальные адреса по историческим названиям (Свердловск → Екатеринбург) и синонимам (Питер → Санкт-Петербург).
✔️ Ищет по частичному совпадению («москва болот» → «г Москва, Болотная наб»), но только в последнем слове запроса («мос болот» не найдет).
✔️ Исправляет опечатки («самара авиционная») и запросы в неправильной раскладке («vjcrdf» → «москва»).
✔️ Раскладывает выбранный адрес на гранулярные части (от региона до квартиры).
✔️ Поддерживает гранулярные подсказки по отдельным частям адреса (регионы, города, улицы, дома).
✔️ Подсказывает адреса в конкретных регионах, районах, городах и населенных пунктах. Понимает названия («Петергоф»), коды КЛАДР («7800000800000») и ФИАС («8f238984-812b-4bb1-850b-49749fb5c56d»).
✔️ Учитывает, где вы находитесь (в связке с методом город по IP-адресу).
Не умеет:
❌ Автоматически (без участия человека) обработать адреса из базы или файла.
❌ Транслитерировать (moskva suhonskaja 11 → 127642, г Москва, ул Сухонская, д 11).
Подсказки не подходят для автоматической обработки адресов. Они предлагают варианты, но не гарантируют, что угадали правильно. Поэтому окончательное решение всегда должен принимать человек.
Запрос
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "query": "москва серпуховская" }' \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/address
Заголовки
Заголовок | Описание |
---|---|
Content-Type | Тип данных в запросе: application/json или application/xml |
Accept | Тип данных в ответе: application/json или application/xml |
Authorization | API-ключ в формате: Только для пользователей подсказок DaData.ru |
Параметры
Параметр | Обязательный? | Описание |
---|---|---|
query | да | Запрос, для которого нужно получить подсказки |
count | нет | Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20). |
locations | нет | Ограничение области поиска |
locations_geo | нет | Географическое ограничение 20.4+ |
locations_boost | нет | Приоритет города при ранжировании |
| нет | Гранулярные подсказки по адресу |
language | нет | Язык отображения адреса в результатах поиска (en/ru) 20.3+ |
Ответ
Возвращается список объектов адреса:
Примеры
Запрос
{ "query": "москва серпуховская" }
Ответ:
Запрос:
<req> <query>москва серпуховская</query> </req>
Ответ: