Возможности
Ищет адреса по любой части адреса от региона до дома («тверская нижний 12» → «Нижегородская обл, г Нижний Новгород, ул Тверская, д 12»). Также ищет по почтовому индексу («105568» → «г Москва, ул Магнитогорская»).
Что умеет:
✔️ Работает по всем странам мира (по России и Белоруссии до дома, по остальным странам — до города). Ищет и показывает результаты как на русском языке («Самара, пр-кт Металлургов»), так и на английском («Russia, gorod Samara, prospekt Metallurgov»).
✔️ Находит актуальные адреса по историческим названиям (Свердловск → Екатеринбург) и синонимам (Питер → Санкт-Петербург).
✔️ Ищет по частичному совпадению («москва болот» → «г Москва, Болотная наб»), но только в последнем слове запроса («мос болот» не найдет).
✔️ Исправляет опечатки («самара авиционная») и запросы в неправильной раскладке («vjcrdf» → «москва»).
✔️ Возвращает адреса в административном и муниципальном делениях. Раскладывает выбранный адрес на гранулярные части (от региона до квартиры).
✔️ Поддерживает гранулярные подсказки по отдельным частям адреса (регионы, города, улицы, дома).
✔️ Подсказывает адреса в конкретных регионах, районах, городах и населенных пунктах. Понимает названия («Петергоф»), коды КЛАДР («7800000800000») и ФИАС («8f238984-812b-4bb1-850b-49749fb5c56d»), а также кадастровые номера («77:03:0005010:1791»).
✔️ Учитывает, где вы находитесь (в связке с методом город по 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
API-пробник (21.8+)
Заголовки
Заголовок | Описание |
---|---|
| Тип данных в запросе: |
| Тип данных в ответе: application/json или application/xml |
| API-ключ в формате: Только для пользователей подсказок DaData.ru |
Параметры
Параметр | Тип | Обязательный? | Описание |
---|---|---|---|
query | string(300) | да | Запрос, для которого нужно получить подсказки |
| int | нет | Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20). |
| string(2) | нет | Язык отображения адреса в результатах поиска 20.3+ по умолчанию — русский |
division | string(20) | нет | Административное либо муниципальное деление 22.4+ |
| object[100] | нет | Ограничение области поиска |
| object[1] | нет | Географическое ограничение 20.4+ |
locations_boost | object[1] | нет | Приоритет города при ранжировании |
| object | нет | Гранулярные подсказки по адресу |
Ответ
Возвращается список объектов адреса:
Примеры
Запрос
{ "query": "москва серпуховская" }
Ответ:
Запрос:
<req> <query>москва серпуховская</query> </req>
Ответ: