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

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

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

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

Запрос

Для пользователей подсказок 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/fias

Для пользователей 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/fias

Заголовки

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

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

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

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

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

Параметры

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

Ответ

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

 Показать

ПолеОписание
postal_codeПочтовый индекс
region_fias_idКод ФИАС региона
region_kladr_idКод КЛАДР региона
region_with_typeРегион с типом
region_typeТип региона (сокращенный)
region_type_fullТип региона
regionРегион
area_fias_idКод ФИАС района в регионе
area_kladr_idКод КЛАДР района в регионе
area_with_typeРайон в регионе с типом
area_typeТип района в регионе (сокращенный)
area_type_fullТип района в регионе
areaРайон в регионе
city_fias_idКод ФИАС города
city_kladr_idКод КЛАДР города
city_with_typeГород с типом
city_typeТип города (сокращенный)
city_type_fullТип города
cityГород
city_district_fias_idКод ФИАС района города
city_district_kladr_idКод КЛАДР района города
city_district_with_typeРайон города с типом
city_district_typeТип района города (сокращенный)
city_district_type_fullТип района города
city_districtРайон города
settlement_fias_idКод ФИАС нас. пункта
settlement_kladr_idКод КЛАДР нас. пункта
settlement_with_typeНаселенный пункт с типом
settlement_typeТип населенного пункта (сокращенный)
settlement_type_fullТип населенного пункта
settlementНаселенный пункт
planning_structure_fias_idКод ФИАС планировочной структуры
planning_structure_kladr_idКод КЛАДР планировочной структуры
planning_structure_with_typeПланировочная структура с типом
planning_structure_typeТип планировочной структуры (сокращенный)
planning_structure_type_fullТип планировочной структуры
planning_structureПланировочная структура
street_fias_idКод ФИАС улицы
street_kladr_idКод КЛАДР улицы
street_with_typeУлица с типом
street_typeТип улицы (сокращенный)
street_type_fullТип улицы
streetУлица
house_fias_idКод ФИАС дома
house_kladr_idКод КЛАДР дома
house_typeТип дома
houseДом
blockКорпус
building_typeТип строения
buildingСтроение
cadastral_numberКадастровый номер
fias_idКод ФИАС:
  • HOUSE.HOUSEGUID для домов
  • ADDROBJ.AOGUID для улиц, н/п и вышестоящих объектов.
fias_levelУровень адреса по ФИАС:
  • 1 — регион
  • 3 — район
  • 4 — город
  • 5 — район города
  • 6 — населенный пункт
  • 7 — улица
  • 8 — дом
  • 65 — планировочная структура.
kladr_idКод КЛАДР
capital_markerПризнак центра района или региона:
  • 1 — центр района (Московская обл, Одинцовский р-н, г Одинцово)
  • 2 — центр региона (Новосибирская обл, г Новосибирск)
  • 3 — центр района и региона (Томская обл, г Томск)
  • 4 — центральный район региона (Тюменская обл, Тюменский р-н)
  • 0 — ничего из перечисленного (Московская обл, г Балашиха)
okatoКод ОКАТО
oktmoКод ОКТМО
tax_officeКод ИФНС для физических лиц
tax_office_legalКод ИФНС для организаций
fias_codeИерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД)
fias_actuality_state

Признак актуальности адреса в ФИАС:

  • 0 — актуальный
  • 1–50 — переименован
  • 51 — переподчинен
  • 99 — удален
history_values[ ]

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

Примеры

Запрос

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

либо

{
  "query": "77000000000292300" 
}
 Ответ
{
    "suggestions": [
        {
            "value": "г Москва, ул Трехгорный Вал",
            "unrestricted_value": "123022, г Москва, ул Трехгорный Вал",
            "data": {
                "postal_code": "123022",
                "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": null,
                "city_kladr_id": null,
                "city_with_type": null,
                "city_type": null,
                "city_type_full": null,
                "city": 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,
                "planning_structure_fias_id": null,
                "planning_structure_kladr_id": null,
                "planning_structure_with_type": null,
                "planning_structure_type": null,
                "planning_structure_type_full": null,
                "planning_structure": 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": null,
                "block": null,
                "building_type": null,
                "building": null,
                "fias_id": "5f96fd6b-b3de-451f-b280-8fedf859e683",
                "fias_code": "7700000000000002923",
                "fias_level": "7",
                "fias_actuality_state": "0",
                "kladr_id": "77000000000292300",
                "capital_marker": "0",
                "okato": "45286575000",
                "oktmo": "45380000",
                "cadastral_number": null,
                "tax_office": "7703",
                "tax_office_legal": "7703",
                "history_values": null,
                "source": null,
                "qc": null
            }
        }
    ]
}

Запрос:

<req>
  <query>5f96fd6b-b3de-451f-b280-8fedf859e683</query>
</req>
 Ответ
<SuggestResponse>
    <suggestions>
        <value>г Москва, ул Трехгорный Вал</value>
        <unrestricted_value>123022, г Москва, ул Трехгорный Вал</unrestricted_value>
        <data>
            <postal_code>123022</postal_code>
            <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/>
            <city_kladr_id/>
            <city_with_type/>
            <city_type/>
            <city_type_full/>
            <city/>
            <city_district_fias_id/>
            <city_district_kladr_id/>
            <city_district_with_type/>
            <city_district_type/>
            <city_district_type_full/>
            <city_district/>
            <settlement_fias_id/>
            <settlement_kladr_id/>
            <settlement_with_type/>
            <settlement_type/>
            <settlement_type_full/>
            <settlement/>
            <planning_structure_fias_id/>
            <planning_structure_kladr_id/>
            <planning_structure_with_type/>
            <planning_structure_type/>
            <planning_structure_type_full/>
            <planning_structure/>
            <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/>
            <block/>
            <building_type/>
            <building/>
            <fias_id>5f96fd6b-b3de-451f-b280-8fedf859e683</fias_id>
            <fias_code>7700000000000002923</fias_code>
            <fias_level>7</fias_level>
            <fias_actuality_state>0</fias_actuality_state>
            <kladr_id>77000000000292300</kladr_id>
            <capital_marker>0</capital_marker>
            <okato>45286575000</okato>
            <oktmo>45380000</oktmo>
            <cadastral_number/>
            <tax_office>7703</tax_office>
            <tax_office_legal>7703</tax_office_legal>
            <history_values/>
            <source/>
            <qc/>
        </data>
    </suggestions>
</SuggestResponse>
  • No labels