Стандартизация адресов

POST

/clean/address

• Разбивает адрес по отдельным полям (регион, город, улица, дом, квартира).
• Рассчитывает корректный индекс по данным Почты России.
• Определяет координаты.
• Показывает округ и район города, ближайшее метро, площадь и стоимость квартиры.
• Достает коды КЛАДР, ФИАС (ГАР), ОКАТО, ОКТМО и ИФНС.

Ссылки на официальную документацию:

https://dadata.ru/api/clean/address/

Авторизация

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Тип

API Key (header: Authorization)

+

SecretKey

Секретный ключ

Тип

API Key (header: X-Secret)

Формат запроса

application/json

Формат запроса ко всем эндпоинтам API стандартизации (clean) «Дадаты»,
кроме стандартизации составной записи https://dadata.ru/api/clean/record/

Все эндпоинты поддерживают стандартизацию только одной записи в одном запросе, например:
@example [ "мск сухонска 11/-89" ] // Адрес - https://dadata.ru/api/clean/address/
@example [ "Срегей владимерович иванов" ] // ФИО - https://dadata.ru/api/clean/name/
@example [ "serega@yandex/ru" ] // Email - https://dadata.ru/api/clean/email/
@example [ "раб 846)231.60.14 *139" ] // Телефон - https://dadata.ru/api/clean/phone/
@example [ "4509 235857" ] // Проверка паспорта - https://dadata.ru/api/clean/passport/
@example [ "24/3/12" ] // Дата - https://dadata.ru/api/clean/birthdate/
@example [ "форд фокус" ] // Марка и модель автомобиля - https://dadata.ru/api/clean/vehicle/

Мин. элементов1

Макс. элементов1

Ответы API

Запрос успешно обработан

Content-Type

application/json

object[]

Мин. элементов1

Макс. элементов1

Исходный адрес одной строкой

Стандартизированный адрес одной строкой

Нераспознанная часть адреса.
Для адреса Москва, Митинская улица, 40, вход с торца вернет "ВХОД, С, ТОРЦА"

Код точности координат:

• 0 — точные координаты
• 1 — ближайший дом
• 2 — улица
• 3 — населенный пункт
• 4 — город
• 5 — координаты не определены, или отсутствуют в справочнике

Возможные значения012345

Код пригодности к рассылке https://dadata.ru/api/clean/address/#qc_complete.

Годится ли адрес для доставки корреспонденции:

Код	Подходит для рассылки?	Описание
0	Да	Пригоден для почтовой рассылки
10	Под вопросом	Дома нет в ФИАС
5	Под вопросом	Нет квартиры. Подходит для юридических лиц или частных владений
8	Под вопросом	До почтового отделения — абонентский ящик или адрес до востребования. Подходит для писем, но не для курьерской доставки.
9	Под вопросом	Сначала проверьте, правильно ли Дадата разобрала исходный адрес
1	Нет	Нет региона
2	Нет	Нет города
3	Нет	Нет улицы
4	Нет	Нет дома
6	Нет	Адрес неполный
7	Нет	Иностранный адрес

Возможные значения012345678910

Признак наличия дома в ФИАС https://dadata.ru/api/clean/address/#qc_house

• 2 — дом в ФИАС есть
• 3 — в ФИАС есть похожий дом и разница только в корпусе или строении
• 10 — дом в ФИАС не найден

• (see https://support.dadata.ru/communities/1/topics/3174-proverka-suschestvovaniya-adresa-cherez-api)

В кобинации с полем qc_geo Уточняют вероятность успешной доставки письма:

Код qc_house	Код qc_geo	Вероятность доставки	Описание
2	любой	Высокая	Дом найден в ФИАС
10	0	Высокая	Дом не найден в ФИАС, но есть на картах
10	1	Средняя	Дом не найден в ФИАС, но есть похожий на картах
10	≥ 2	Низкая	Дом не найден в ФИАС и на картах

Возможные значения2310

Код проверки адреса https://dadata.ru/api/clean/address/#qc

Нужно ли вручную проверить распознанный адрес:

Код	Нужно проверить вручную?	Описание
0	Нет	Адрес распознан уверенно
1	Да	Остались «лишние» части. Пример: «109341 Тверская область Москва Верхние Поля» — здесь лишняя «Тверская область». Либо в исходном адресе недостаточно данных для уверенного разбора. Пример: «Сходня Красная 12» — здесь нет региона и города.
2	Нет	Адрес пустой или заведомо «мусорный»
3	Да	Есть альтернативные варианты. Пример: «Москва Тверская-Ямская» — в Москве четыре Тверских-Ямских улицы

Возможные значения0123

null |object

Обязательный

Компоненты адреса в административном/муниципальном делении.

Любой из:

object

object

Обязательный

Компоненты адреса в административном делении:

• area — район региона;
• city — город;
• city_district — район города;
• settlement — населенный пункт;
• planning_structure — планировочная структура.

Поле отсутствует в новых версиях API, в старых не заполнялось.

Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД).
Чаще всего вам нужен не он, а fias_id

string

Обязательный

Уровень детализации, до которого адрес найден в ФИАС:

• 0 — страна
• 1 — регион
• 3 — район
• 4 — город
• 5 — район города
• 6 — населенный пункт
• 7 — улица
• 8 — дом
• 9 — квартира (подсказки: v21.4+)
• 65 — планировочная структура
• 90 — доп. территория
• 91 — улица в доп. территории
• -1 — иностранный или пустой.

Любой из:

Возможные значения"1""3""4""5""6""65""7""8"

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

Дадата работает по объединенному справочнику налоговой службы ФИАС (ГАР) и Почты России.
В нем исправлены более 7 000 некорректных и отсутствующих индексов.
Однако, справочник индексов Почты детализирован только до населенных пунктов
(привязки к улицам и домам нет), поэтому исправлены не все-все индексы.

Страна

Двухсимвольный код страны ISO 3166

• (подсказки: v19.7+)

Федеральный округ

• (подсказки: v19.5+)

ФИАС-код региона

для Белоруссии, Узбекистана и Казахстана — код OSM,
для остальных стран — код Geonames

КЛАДР-код региона

Код региона ISO 3166

• (подсказки: v19.7+)

Регион с типом

Тип региона (сокращенный)

Тип региона

Регион

ФИАС-код района. Район - это:

• Административное деление: административный район региона
• Муниципальное деление: муниципальный район

для Белоруссии, Узбекистана и Казахстана — код OSM,
для остальных стран — код Geonames

КЛАДР-код административного район региона

Район с типом. Район - это:

• Административное деление: административный район региона
• Муниципальное деление: муниципальный район

Тип района (сокращенный). Район - это:

• Административное деление: административный район региона
• Муниципальное деление: муниципальный район

Тип района. Район - это:

• Административное деление: административный район региона
• Муниципальное деление: муниципальный район

Район:

• Административное деление: административный район региона
• Муниципальное деление: муниципальный район

ФИАС-код города

для Белоруссии, Узбекистана и Казахстана — код OSM,
для остальных стран — код Geonames

КЛАДР-код города

Город с типом

Тип города (сокращенный)

Тип города

Город

ФИАС-код района города (заполняется, только если район есть в ФИАС)

Код КЛАДР района города (заполняется только при поиске типа ФИАС)

Адм. район города с типом

• В подсказках по адресам - заполняется при выборе конкретной подсказки (запрос с count=1)

Тип адм. района города (сокращенный)

• В подсказках по адресам - заполняется при выборе конкретной подсказки (запрос с count=1)

Тип адм. района города

• В подсказках по адресам - заполняется при выборе конкретной подсказки (запрос с count=1)

Адм. район города

• В подсказках по адресам - заполняется при выборе конкретной подсказки (запрос с count=1)

ФИАС-код нас. пункта

для Белоруссии, Узбекистана и Казахстана — код OSM,
для остальных стран — код Geonames

КЛАДР-код нас. пункта

Населенный пункт с типом

Тип населенного пункта (сокращенный)

Тип населенного пункта

Населенный пункт

ФИАС-код улицы

для Белоруссии, Узбекистана и Казахстана — код OSM,
для остальных стран — код Geonames

КЛАДР-код улицы

Улица с типом

Тип улицы (сокращенный)

Тип улицы

Улица

ФИАС-код участка

• (подсказки: v21.12+)

КЛАДР-код земельного участка

Тип участка (сокращенный, = «уч»)

• (подсказки: v21.12+)

Тип участка, = «участок»

• (подсказки: v21.12+)

Участок

• (подсказки: v21.12+)

ФИАС-код дома

для Белоруссии, Узбекистана и Казахстана — код OSM,
для остальных стран — код Geonames

КЛАДР-код дома

Тип дома (сокращенный)

Тип дома

Дом

Количество квартир в доме

В подсказках по адресам - заполняется при выборе конкретной подсказки (запрос с count=1)

• Только на тарифе «Максимальный»
• (подсказки: v24.3+)

Тип корпуса/строения (сокращенный)

Тип корпуса/строения

Корпус/строение (в ФИАС - только корпус)

ФИАС-код квартиры / помещения

• (подсказки: v20.1+)

Тип квартиры/помещения (сокращенный)

Тип квартиры/помещения полностью

Квартира/помещение

Абонентский ящик

Тип комнаты (сокращенный), "ком"

• (подсказки: v22.8+)

Тип комнаты, например, "комната"

• (подсказки: v22.8+)

Комната

• (подсказки: v22.8+)

ФИАС-код (он же код ГАР - object GUID) адреса для России.

Идентификатор OpenStreetMap для Беларуси, Казахстана и Узбекистана.

Для остальных стран — идентификатор объекта в базе GeoNames.

в ФИАС: Код ФИАС:HOUSE.HOUSEGUID для домов
ADDROBJ.AOGUID для улиц, н/п и вышестоящих объектов.

КЛАДР-код адреса

Идентификатор объекта в базе GeoNames.

Для российских адресов не заполняется, либо заполняется до уровня города.

null |string

Обязательный

Признак центра района или региона:

• 1 — центр района (Московская обл, Одинцовский р-н, г Одинцово)
• 2 — центр региона (Новосибирская обл, г Новосибирск)
• 3 — центр района и региона (Томская обл, г Томск)
• 4 — центральный район региона (Тюменская обл, Тюменский р-н)
• 0 — ничего из перечисленного (Московская обл, г Балашиха)

Любой из:

Возможные значения"0""1""2""3""4"