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

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

  • до улицы включительно по кодам КЛАДР и ФИАС;
  • до дома по коду ФИАС.
 Click here to expand...

в подсказках 19.7 и ниже – до улицы включительно, при поиске по кодам дома возвращает пустой ответ

Ищет только по актуальным адресам. Поиск выполняется по точному совпадению идентификатора, не по вхождению

Доступен только через 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Адрес одной строкой (полный, от региона), включая (с версии 19.10) почтовый индекс
data.postal_codeИндекс
data.countryСтрана
data.country_iso_codeДвухсимвольный код страны ISO 3166 (начиная с версии 19.7)
data.federal_districtФедеральный округ (начиная с версии 19.5)
data.region_fias_idКод ФИАС региона
data.region_kladr_idКод КЛАДР региона
data.region_iso_codeКод региона ISO 3166 (начиная с версии 19.7)
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