Адрес в ФИАС по идентификатору
⚠️ В большинстве случаев вам нужен не этот метод, а адрес по ФИАС-коду
Находит адрес в справочнике ФИАС по коду КЛАДР или ФИАС.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Пример запроса:
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/fias
// https://github.com/hflabs/dadata-csharp var token = "${API_KEY}"; var api = new SuggestClientAsync(token); var result = await api.FindFias("9120b43f-2fae-4838-a144-85e43c2bfb29"); var address = response.suggestions[0].data;
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/fias"; var token = "${API_KEY}"; var query = "9120b43f-2fae-4838-a144-85e43c2bfb29"; var options = { method: "POST", mode: "cors", headers: { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Token " + token }, body: JSON.stringify({query: query}) } fetch(url, options) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php $token = "${API_KEY}"; $dadata = new \Dadata\DadataClient($token, null); $result = $dadata->findById("fias", "9120b43f-2fae-4838-a144-85e43c2bfb29", 1);
# https://github.com/hflabs/dadata-py from dadata import Dadata token = "${API_KEY}" dadata = Dadata(token) result = dadata.find_by_id("fias", "9120b43f-2fae-4838-a144-85e43c2bfb29")
По КЛАДР-коду ищет до улицы, по ФИАС-коду — до дома. По ФИАС-коду квартиры не ищет.
ФИАС-коды домов иногда меняются, а метод ищет только по актуальным кодам. Поэтому рекомендуем помимо ФИАС-кода дома сохранять адрес одной строкой — иначе не получится восстановить адрес, когда ФИАС-код изменится.
Что в ответе
Пример ответа
{ "suggestions": [ { "value": "г Москва, ул Снежная", "unrestricted_value": "129323, г Москва, ул Снежная", "data": { "postal_code": "129323", "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": "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": null, "block": null, "building_type": null, "building": 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": null, "oktmo": null, "cadastral_number": null, "tax_office": "7716", "tax_office_legal": "7716", "history_values": null, "source": null, "qc": null } } ] }
Название | Описание | |
---|---|---|
value | Адрес одной строкой (как показывается в списке подсказок) | |
unrestricted_value | Адрес одной строкой (полный, с индексом) | |
data.postal_code | Индекс | |
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.planning_structure_fias_id | Код ФИАС план. структуры | |
data.planning_structure_kladr_id | Код КЛАДР план. структуры | |
data.planning_structure_with_type | Планировочная структура с типом | |
data.planning_structure_type | Тип планировочной структуры (сокращенный) | |
data.planning_structure_type_full | Тип планировочной структуры | |
data.planning_structure | Планировочная структура | |
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 | Дом | |
data.block | Корпус | |
data.building_type | Тип строения | |
data.building | Строение | |
data.cadastral_number | Кадастровый номер | |
data.fias_id |
Код ФИАС:
|
|
data.fias_code | Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД) | |
data.fias_level | Уровень адреса по ФИАС:
1 — регион 3 — район 4 — город 5 — район города 6 — населенный пункт 7 — улица 8 — дом 65 — планировочная структура |
|
data.fias_actuality_state | Признак актуальности адреса в ФИАС
0 — актуальный 1–50 — переименован 51 — переподчинен 99 — удален |
|
data.kladr_id | Код КЛАДР | |
data.capital_marker | Признак центра района или региона:
1 — центр района (Московская обл, Одинцовский р-н, г Одинцово) 2 — центр региона (Новосибирская обл, г Новосибирск) 3 — центр района и региона (Томская обл, г Томск) 4 — центральный район региона (Тюменская обл, Тюменский р-н) 0 — ничего из перечисленного (Московская обл, г Балашиха) |
|
data.okato | Код ОКАТО | |
data.oktmo | Код ОКТМО | |
data.tax_office | Код ИФНС для физических лиц | |
data.tax_office_legal | Код ИФНС для организаций | |
data.history_values[ ] | Список исторических названий объекта нижнего уровня. Если подсказка до улицы — это прошлые названия этой улицы, если до города — города. |
|
Не заполняются | ||
data.source | ||
data.qc |
Источник данных: Федеральная информационная адресная система (ФИАС) Налоговой службы.
Примеры вызова
Ограничения
Длина запроса (параметр query
) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 30 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.