↑ Все API

API: адрес по коду ФИАС, ГАР, КЛАДР или кадастровому номеру

Находит адрес по идентификатору:

  • кадастровый номер (stead_cadnum, house_cadnum или flat_cadnum), только для России;
  • ФИАС-код, он же ГАР-код (fias_id), только для России;
  • КЛАДР-код (kladr_id), только для России;
  • Идентификатор OpenStreetMap (fias_id), только для Беларуси, Казахстана и Узбекистана;
  • Идентификатор GeoNames (geoname_id), для всех остальных стран.

По КЛАДР-коду ищет до улицы, по ФИАС-коду — до квартиры.

ФИАС-коды домов и квартир иногда меняются, а метод ищет только по актуальным кодам. Поэтому рекомендуем помимо ФИАС-кода сохранять адрес одной строкой — иначе не получится восстановить адрес, когда код изменится.

Как вызвать

Чтобы вызвать метод, и подтвердите почту.

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/address
            
            
{ "query": "9120b43f-2fae-4838-a144-85e43c2bfb29" }

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

Параметры запроса

НазваниеТипОбяз.? По умолч. Описание
querystringТекст запроса
countnumber 10 Количество результатов (максимум — 20)
languagestringruНа каком языке вернуть результат (ru / en)
divisionstringADMINISTRATIVE Административное либо муниципальное деление

Что в ответе

Пример ответа
{
    "suggestions": [{
        "value": "г Москва, ул Снежная",
        "unrestricted_value": "129323, г Москва, ул Снежная",
        "data": {
            "postal_code": "129323",
            "country": "Россия",
            "country_iso_code": "RU",
            "federal_district": "Центральный",
            "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
            "region_kladr_id": "7700000000000",
            "region_iso_code": "RU-MOW",
            "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_flat_count": null,
            "house_type": null,
            "house_type_full": null,
            "house": null,
            "block_type": null,
            "block_type_full": null,
            "block": null,
            "flat_fias_id": 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": null,
            "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.country_iso_codeISO-код страны (двухсимвольный)
data.federal_districtФедеральный округ
data.region_fias_idФИАС-код региона
data.region_kladr_idКЛАДР-код региона
data.region_iso_codeISO-код региона
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.sub_area_fias_idФИАС-код мун. поселения
data.sub_area_kladr_idКЛАДР-код мун. поселения
data.sub_area_with_typeМун. поселение с типом
data.sub_area_typeТип мун. поселения (сокращенный)
data.sub_area_type_fullТип мун. поселения
data.sub_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.stead_fias_idФИАС-код земельного участка
data.stead_kladr_idКЛАДР-код земельного участка
data.stead_type = «уч»
data.stead_type_full = «участок»
data.steadномер земельного участка
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.entrance не заполняется
data.floor не заполняется
data.flat_fias_idФИАС-код квартиры
data.flat_typeТип квартиры (сокращенный)
data.flat_type_fullТип квартиры
data.flatКвартира
data.room_fias_idФИАС-код комнаты
data.room_typeТип комнаты (сокращенный)
data.room_type_fullТип комнаты
data.roomКомната
data.postal_boxАбонентский ящик
data.fias_id

ФИАС-код (он же код ГАР) адреса для России.
Идентификатор OpenStreetMap для Беларуси, Казахстана и Узбекистана.
Для остальных стран — идентификатор объекта в базе GeoNames.

data.fias_code Не заполняется, используйте fias_id
data.fias_level Уровень детализации, до которого адрес найден в ФИАС (ГАР):
  0 — страна
  1 — регион
  3 — район
  4 — город
  5 — район города
  6 — населенный пункт
  7 — улица
  8 — дом
  9 — квартира или комната
 65 — планировочная структура
 75 — земельный участок
 -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_actuality_state Признак актуальности адреса в ФИАС
  0    — актуальный
  1–50 — переименован
  51   — переподчинен
  99   — удален
data.city_areaАдминистративный округ (только для Москвы)
«Расширенный» и «Максимальный»
data.beltway_hitВнутри кольцевой?
data.beltway_distanceРасстояние от кольцевой в километрах
Только «Максимальный»
data.stead_cadnumКадастровый номер земельного участка
data.house_cadnumКадастровый номер дома
data.flat_cadnumКадастровый номер квартиры
data.room_cadnumКадастровый номер комнаты
data.house_flat_countКоличество квартир в доме
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.source не заполняется
data.unparsed_parts не заполняется

Административное и муниципальное деление

Подсказки могут возвращать адрес в административном либо в муниципальном делении. Это регулирует параметр запроса division (виджет / API):

  • administrative — административное;
  • municipal — муниципальное.

Если параметр не задан, используется административное деление.

В муниципальном делении возвращаются поля area* (муниципальный район) и sub_area* (муниципальное поселение). Поля city_district* (административный район города), напротив, скрываются.

В административном делении возвращаются поля area* (административный район региона) и city_district* (административный район города). Поля sub_area* (муниципальное поселение), напротив, скрываются.

Координаты, площадь и стоимость

Координаты есть у 97% домов в Москве, 91% в Санкт-Петербурге, 69% в других городах-миллиониках и 47% по остальной России.

Площадь и стоимость есть у 70% квартир в России.

Источники данных

Федеральная информационная адресная система (ФИАС) Налоговой службы

Справочник индексов Почты России

Gazetteer Data и Postal Code Data от GeoNames

OpenStreetMap

ISO 3166

Примеры вызова

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

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