Page tree
Skip to end of metadata
Go to start of metadata

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

Доступен только через API (jQuery-плагин не поддерживается).

Запрос

Для пользователей подсказок DaData.ru:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/address

Для пользователей standalone-подсказок:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/address

Заголовки

ЗаголовокОписание
Content-Type

Тип данных в запросе: application/json или application/xml

Accept
Тип данных в ответе: application/json или application/xml
Authorization

API-ключ в формате: Token ВАШ_КЛЮЧ

Только для пользователей подсказок DaData.ru

Параметры

ПараметрОбязательный?Описание
queryдаКод КЛАДР или ФИАС, по которому нужно получить подсказку

Ответ

Возвращает объект адреса, который соответствует искомому коду:

 Показать

ПолеОписание
valueАдрес одной строкой (как показывается в списке подсказок)
unrestricted_valueАдрес одной строкой (полный, от региона)
data.postal_codeИндекс
data.countryСтрана
data.federal_districtФедеральный округ (начиная с версии 19.5)
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.source

Для организаций — адрес как в ЕГРЮЛ.
Для банков — адрес как в справочнике БИК.
В остальных случаях — пустое.

data.history_values[ ]

Список исторических названий объекта нижнего уровня.
Если подсказка до улицы — это прошлые названия этой улицы, если до города — города.

Дополнительные поля, заполняются в зависимости от тарифа

Заполняются при выборе конкретной подсказки или через метод API findById. До этого они пустые.
Все тарифы
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

Ближайшие станции метро (не более 3 станций в радиусе 5 км):

— название станции

— название линии

— расстояние до станции в километрах

Не используются

Зарезервированы для автоматической обработки адресов через API стандартизации

data.qc_completeКод пригодности к рассылке
data.qc_houseКод проверки дома
data.qcКод проверки
data.unparsed_partsНераспознанная часть адреса

Примеры

Запрос

{
  "query": "5f96fd6b-b3de-451f-b280-8fedf859e683" 
}

либо

{
  "query": "77000000000292300" 
}
 Ответ
 {
  "suggestions": [
    {
      "value": "г Москва, ул Трехгорный Вал",
      "unrestricted_value": "г Москва, Пресненский р-н, ул Трехгорный Вал",
      "data": {
        "postal_code": "123022",
        "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": "Центральный",
        "city_district_fias_id": null,
        "city_district_kladr_id": null,
        "city_district_with_type": "Пресненский р-н",
        "city_district_type": "р-н",
        "city_district_type_full": "район",
        "city_district": "Пресненский",
        "settlement_fias_id": null,
        "settlement_kladr_id": null,
        "settlement_with_type": null,
        "settlement_type": null,
        "settlement_type_full": null,
        "settlement": null,
        "street_fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
        "street_kladr_id": "77000000000292300",
        "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": "5f96fd6b-b3de-451f-b280-8fedf859e683",
        "fias_level": "7",
        "kladr_id": "77000000000292300",
        "capital_marker": "0",
        "okato": "45286575000",
        "oktmo": "45380000",
        "tax_office": "7703",
        "tax_office_legal": null,
        "timezone": null,
        "geo_lat": "55.760395",
        "geo_lon": "37.5609378",
        "beltway_hit": null,
        "beltway_distance": null,
        "qc_geo": "2",
        "qc_complete": null,
        "qc_house": null,
        "unparsed_parts": null,
        "qc": null
      }
    }
  ]
}

Запрос:

<req>
  <query>5f96fd6b-b3de-451f-b280-8fedf859e683</query>
</req>
 Ответ
<SuggestResponse>
    <suggestions>
        <value>г Москва, ул Трехгорный Вал</value>
        <unrestricted_value>г Москва, Пресненский р-н, ул Трехгорный Вал</unrestricted_value>
        <data>
            <postal_code>123022</postal_code>
            <country>Россия</country>
            <region_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</region_fias_id>
            <region_kladr_id>7700000000000</region_kladr_id>
            <region_with_type>г Москва</region_with_type>
            <region_type>г</region_type>
            <region_type_full>город</region_type_full>
            <region>Москва</region>
            <area_fias_id/>
            <area_kladr_id/>
            <area_with_type/>
            <area_type/>
            <area_type_full/>
            <area/>
            <city_fias_id>0c5b2444-70a0-4932-980c-b4dc0d3f02b5</city_fias_id>
            <city_kladr_id>7700000000000</city_kladr_id>
            <city_with_type>г Москва</city_with_type>
            <city_type>г</city_type>
            <city_type_full>город</city_type_full>
            <city>Москва</city>
            <city_area>Центральный</city_area>
            <city_district_fias_id/>
            <city_district_kladr_id/>
            <city_district_with_type>Пресненский р-н</city_district_with_type>
            <city_district_type>р-н</city_district_type>
            <city_district_type_full>район</city_district_type_full>
            <city_district>Пресненский</city_district>
            <settlement_fias_id/>
            <settlement_kladr_id/>
            <settlement_with_type/>
            <settlement_type/>
            <settlement_type_full/>
            <settlement/>
            <street_fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</street_fias_id>
            <street_kladr_id>77000000000292300</street_kladr_id>
            <street_with_type>ул Трехгорный Вал</street_with_type>
            <street_type>ул</street_type>
            <street_type_full>улица</street_type_full>
            <street>Трехгорный Вал</street>
            <house_fias_id/>
            <house_kladr_id/>
            <house_type/>
            <house_type_full/>
            <house/>
            <block_type/>
            <block_type_full/>
            <block/>
            <flat_type/>
            <flat_type_full/>
            <flat/>
            <flat_area/>
            <square_meter_price/>
            <flat_price/>
            <postal_box/>
            <fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</fias_id>
            <fias_level>7</fias_level>
            <kladr_id>77000000000292300</kladr_id>
            <capital_marker>0</capital_marker>
            <okato>45286575000</okato>
            <oktmo>45380000</oktmo>
            <tax_office>7703</tax_office>
            <tax_office_legal/>
            <timezone/>
            <geo_lat>55.760395</geo_lat>
            <geo_lon>37.5609378</geo_lon>
            <beltway_hit/>
            <beltway_distance/>
            <qc_geo>2</qc_geo>
            <qc_complete/>
            <qc_house/>
            <unparsed_parts/>
            <qc/>
        </data>
    </suggestions>
</SuggestResponse>
  • No labels