Адрес по коду КЛАДР или ФИАС

Что умеет

Находит адрес по коду КЛАДР или ФИАС.

Как вызвать

Чтобы вызвать метод, зарегистрируйтесь и получите ключ

URL:

https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/address

Пример запроса:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "77000000000268400" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/address

Или:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "9120b43f-2fae-4838-a144-85e43c2bfb29" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/address

Пример ответа

{
    "suggestions": [{
        "value": "г Москва, ул Снежная",
        "unrestricted_value": "г Москва, ул Снежная",
        "data": {
            "postal_code": "129323",
            "country": "Россия",
            "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
            "region_kladr_id": "7700000000000",
            "region_with_type": "г Москва",
            "region_type": "г",
            "region_type_full": "город",
            "region": "Москва",
            "area_fias_id": null,
            "area_kladr_id": null,
            "area_with_type": null,
            "area_type": null,
            "area_type_full": null,
            "area": null,
            "city_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
            "city_kladr_id": "7700000000000",
            "city_with_type": "г Москва",
            "city_type": "г",
            "city_type_full": "город",
            "city": "Москва",
            "city_area": null,
            "city_district_fias_id": null,
            "city_district_kladr_id": null,
            "city_district_with_type": null,
            "city_district_type": null,
            "city_district_type_full": null,
            "city_district": null,
            "settlement_fias_id": null,
            "settlement_kladr_id": null,
            "settlement_with_type": null,
            "settlement_type": null,
            "settlement_type_full": null,
            "settlement": null,
            "street_fias_id": "9120b43f-2fae-4838-a144-85e43c2bfb29",
            "street_kladr_id": "77000000000268400",
            "street_with_type": "ул Снежная",
            "street_type": "ул",
            "street_type_full": "улица",
            "street": "Снежная",
            "house_fias_id": null,
            "house_kladr_id": null,
            "house_type": null,
            "house_type_full": null,
            "house": null,
            "block_type": null,
            "block_type_full": null,
            "block": null,
            "flat_type": null,
            "flat_type_full": null,
            "flat": null,
            "flat_area": null,
            "square_meter_price": null,
            "flat_price": null,
            "postal_box": null,
            "fias_id": "9120b43f-2fae-4838-a144-85e43c2bfb29",
            "fias_code": "77000000000000026840000",
            "fias_level": "7",
            "fias_actuality_state": "0",
            "kladr_id": "77000000000268400",
            "capital_marker": "0",
            "okato": "45000000000",
            "oktmo": null,
            "tax_office": "7716",
            "tax_office_legal": "7716",
            "timezone": "UTC+3",
            "geo_lat": "55.8523692",
            "geo_lon": "37.6469407",
            "beltway_hit": "IN_MKAD",
            "beltway_distance": null,
            "metro": null,
            "qc_geo": "2",
            "qc_complete": null,
            "qc_house": null,
            "history_values": null,
            "unparsed_parts": null,
            "source": "г Москва, ул Снежная",
            "qc": null
        }
    }]
}

Поля в ответе

Название Описание
Базовые поля, заполняются для всех тарифов
value Адрес одной строкой (как показывается в списке подсказок)
unrestricted_value Адрес одной строкой (полный, от региона)
data.postal_code Индекс
data.country Страна
data.region_fias_id Код ФИАС региона
data.region_kladr_id Код КЛАДР региона
data.region_with_type Регион с типом
data.region_type Тип региона (сокращенный)
data.region_type_full Тип региона
data.region Регион
data.area_fias_id Код ФИАС района в регионе
data.area_kladr_id Код КЛАДР района в регионе
data.area_with_type Район в регионе с типом
data.area_type Тип района в регионе (сокращенный)
data.area_type_full Тип района в регионе
data.area Район в регионе
data.city_fias_id Код ФИАС города
data.city_kladr_id Код КЛАДР города
data.city_with_type Город с типом
data.city_type Тип города (сокращенный)
data.city_type_full Тип города
data.city Город
data.city_district_fias_id Код ФИАС района города (заполняется, только если район есть в ФИАС)
data.city_district_kladr_id Код КЛАДР района города (не заполняется)
data.city_district_with_type Район города с типом
data.city_district_type Тип района города (сокращенный)
data.city_district_type_full Тип района города
data.city_district Район города
data.settlement_fias_id Код ФИАС нас. пункта
data.settlement_kladr_id Код КЛАДР нас. пункта
data.settlement_with_type Населенный пункт с типом
data.settlement_type Тип населенного пункта (сокращенный)
data.settlement_type_full Тип населенного пункта
data.settlement Населенный пункт
data.street_fias_id Код ФИАС улицы
data.street_kladr_id Код КЛАДР улицы
data.street_with_type Улица с типом
data.street_type Тип улицы (сокращенный)
data.street_type_full Тип улицы
data.street Улица
data.house_fias_id Код ФИАС дома
data.house_kladr_id Код КЛАДР дома
data.house_type Тип дома (сокращенный)
data.house_type_full Тип дома
data.house Дом
data.block_type Тип корпуса/строения (сокращенный)
data.block_type_full Тип корпуса/строения
data.block Корпус/строение
data.flat_type Тип квартиры (сокращенный)
data.flat_type_full Тип квартиры
data.flat Квартира
data.postal_box Абонентский ящик
data.fias_id Код ФИАС:
  • HOUSE.HOUSEGUID, если дом найден в ФИАС по точному совпадению;
  • ADDROBJ.AOGUID в противном случае.
data.fias_level Уровень детализации, до которого адрес найден в ФИАС:
    0 — страна
    1 — регион
    3 — район
    4 — город
    5 — район города
    6 — населенный пункт
    7 — улица
    8 — дом
   65 — планировочная структура
   -1 — иностранный или пустой
data.kladr_id Код КЛАДР
data.geoname_id Идентификатор объекта в базе GeoNames. Для российских адресов не заполняется.
data.capital_marker Признак центра района или региона:
    1 — центр района (Московская обл, Одинцовский р-н, г Одинцово)
    2 — центр региона (Новосибирская обл, г Новосибирск)
    3 — центр района и региона (Томская обл, г Томск)
    4 — центральный район региона (Тюменская обл, Тюменский р-н)
    0 — ничего из перечисленного (Московская обл, г Балашиха)
data.okato Код ОКАТО
data.oktmo Код ОКТМО
data.tax_office Код ИФНС для физических лиц
data.tax_office_legal Код ИФНС для организаций
data.history_values[ ] Список исторических названий объекта нижнего уровня.
Если подсказка до улицы — это прошлые названия этой улицы, если до города — города.
Дополнительные поля, заполняются в зависимости от тарифа
Заполняются при выборе конкретной подсказки. До этого они пустые.
Все тарифы
data.geo_lat Координаты: широта
data.geo_lon Координаты: долгота
data.qc_geo Код точности координат:
    0 —	точные координаты
    1 — ближайший дом
    2 — улица
    3 — населенный пункт
    4 — город
    5 — координаты не определены
data.fias_code Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД)
data.fias_actuality_state Признак актуальности адреса в ФИАС
    0    — актуальный
    1–50 — переименован
    51   — переподчинен
    99   — удален
data.city_area Административный округ (только для Москвы)
«Расширенный» и «Всё включено»
data.beltway_hit Внутри кольцевой?
data.beltway_distance Расстояние от кольцевой в километрах
«Всё включено»
data.flat_area Площадь квартиры
data.square_meter_price Рыночная стоимость м²
data.flat_price Рыночная стоимость квартиры
data.timezone Часовой пояс
data.metro[ ] Список ближайших станций метро (до трёх штук)
└ name — название станции
└ line — название линии
└ distance — расстояние до станции в километрах
Не используются
Зарезервированы для автоматической обработки адресов через API стандартизации
data.qc_complete
data.qc_house
data.qc
data.unparsed_parts

Ограничения

Ищет до улицы включительно, при поиске по коду дома возвращает пустой ответ. Так сделано намеренно: КЛАДР-коды и ФИАС-коды домов постоянно изменяются, поэтому хранить их ненадежно.

Рекомендуем хранить полный адрес текстом, а в качестве идентификатора использовать связку «ФИАС-код улицы + домовая часть отдельно». Подробности в статье о проблемах ФИАС.

Стоимость

Метод бесплатный до 10 тысяч запросов в день. Больше — в составе годовой подписки на Подсказки.

ajax-spinner

Зарегистрируйтесь, чтобы подключить подсказки

до 10 тыс запросов бесплатно

чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти