- Created by Сергей Константинов, last modified by Антон Жиянов on 13 Dec 2020
Используйте справочник ФИАС только в том случае, если твердо уверены, что вам нужен именно он. Для большинства задач намного лучше подходят подсказки по адресам — они более полные, логичные и удобные. Подсказки по ФИАС нужны, только если вам по какой-то причине важно точное, побуквенное соответствие справочнику адресов налоговой службы.
Если слова «ФИАС» и «планировочная структура» вам ничего не говорят — пожалуйста, не используйте эти подсказки. Используйте подсказки по адресам.
Сервис ФИАС требует специальную лицензию, по умолчанию она выключена. Чтобы включить, напишите в техподдержку.
Запрос
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "query": "москва серпуховская" }' \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/fias
Заголовки
Заголовок | Описание |
---|---|
| Тип данных в запросе: |
| Тип данных в ответе: application/json или application/xml |
| API-ключ в формате: Только для пользователей подсказок DaData.ru |
Параметры
Параметр | Обязательный? | Описание |
---|---|---|
query | да | Запрос, для которого нужно получить подсказки |
count | нет | Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20). |
locations | нет | Ограничение области поиска |
locations_boost | нет | Приоритет города при ранжировании |
| нет | Гранулярные подсказки по адресу |
Ответ
Возвращается список объектов адреса:
Показать
Поле | Тип данных | Описание |
---|---|---|
postal_code | string(10) | Почтовый индекс |
region_fias_id | string(50) | Код ФИАС региона |
region_kladr_id | string(20) | Код КЛАДР региона |
region_with_type | string(150) | Регион с типом |
region_type | string(10) | Тип региона (сокращенный) |
region_type_full | string(50) | Тип региона |
region | string(150) | Регион |
area_fias_id | string(50) | Код ФИАС района в регионе |
area_kladr_id | string(20) | Код КЛАДР района в регионе |
area_with_type | string(150) | Район в регионе с типом |
area_type | string(10) | Тип района в регионе (сокращенный) |
area_type_full | string(50) | Тип района в регионе |
area | string(150) | Район в регионе |
city_fias_id | string(50) | Код ФИАС города |
city_kladr_id | string(20) | Код КЛАДР города |
city_with_type | string(150) | Город с типом |
city_type | string(10) | Тип города (сокращенный) |
city_type_full | string(50) | Тип города |
city | string(150) | Город |
city_district_fias_id | string(50) | Код ФИАС района города |
city_district_kladr_id | string(20) | Код КЛАДР района города |
city_district_with_type | string(150) | Район города с типом |
city_district_type | string(10) | Тип района города (сокращенный) |
city_district_type_full | string(50) | Тип района города |
city_district | string(150) | Район города |
settlement_fias_id | string(50) | Код ФИАС нас. пункта |
settlement_kladr_id | string(20) | Код КЛАДР нас. пункта |
settlement_with_type | string(150) | Населенный пункт с типом |
settlement_type | string(10) | Тип населенного пункта (сокращенный) |
settlement_type_full | string(50) | Тип населенного пункта |
settlement | string(150) | Населенный пункт |
planning_structure_fias_id | string(50) | Код ФИАС планировочной структуры |
planning_structure_kladr_id | string(20) | Код КЛАДР планировочной структуры |
planning_structure_with_type | string(150) | Планировочная структура с типом |
planning_structure_type | string(10) | Тип планировочной структуры (сокращенный) |
planning_structure_type_full | string(50) | Тип планировочной структуры |
planning_structure | string(150) | Планировочная структура |
street_fias_id | string(50) | Код ФИАС улицы |
street_kladr_id | string(20) | Код КЛАДР улицы |
street_with_type | string(150) | Улица с типом |
street_type | string(10) | Тип улицы (сокращенный) |
street_type_full | string(50) | Тип улицы |
street | string(150) | Улица |
house_fias_id | string(50) | Код ФИАС дома |
house_kladr_id | string(20) | Код КЛАДР дома |
house_type | string(10) | Тип дома |
house | string(50) | Дом |
block | string(50) | Корпус |
building_type | string(10) | Тип строения |
building | string(50) | Строение |
cadastral_number | string(100) | Кадастровый номер |
fias_id | string(50) | Код ФИАС:
|
fias_level | string(10) | Уровень адреса по ФИАС:
|
kladr_id | string(20) | Код КЛАДР |
capital_marker | string(10) | Признак центра района или региона:
|
okato | string(20) | Код ОКАТО |
oktmo | string(20) | Код ОКТМО |
tax_office | string(10) | Код ИФНС для физических лиц |
tax_office_legal | string(10) | Код ИФНС для организаций |
fias_code | string(50) | Иерархический код адреса в ФИАС (СС+РРР+ГГГ+ППП+СССС+УУУУ+ДДДД) |
fias_actuality_state | string(10) | Признак актуальности адреса в ФИАС:
|
history_values[ ] | string[](250) | Список исторических названий объекта нижнего уровня. |
Примеры
Запрос
{ "query": "москва серпуховская" }
Ответ:
Показать
{ "suggestions": [ { "value": "г Москва, ул Серпуховская Б.", "unrestricted_value": "г Москва, ул Серпуховская Б.", "data": { "postal_code": null, "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": "601875e2-717a-4c30-a3c4-1fb49e67d93f", "street_kladr_id": "77000000000262500", "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": "601875e2-717a-4c30-a3c4-1fb49e67d93f", "fias_code": "7700000000000002625", "fias_level": "7", "fias_actuality_state": "0", "kladr_id": "77000000000262500", "capital_marker": "0", "okato": null, "oktmo": null, "cadastral_number": null, "tax_office": null, "tax_office_legal": null, "history_values": null, "source": null, "qc": null } }, { "value": "г Москва, пл Серпуховская", "unrestricted_value": "115184, г Москва, пл Серпуховская", "data": { "postal_code": "115184", "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": "6fe35e69-360a-4d75-8061-066a5c9e669c", "street_kladr_id": "77000000000702000", "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": "6fe35e69-360a-4d75-8061-066a5c9e669c", "fias_code": "7700000000000007020", "fias_level": "7", "fias_actuality_state": "0", "kladr_id": "77000000000702000", "capital_marker": "0", "okato": "45286560000", "oktmo": "45376000", "cadastral_number": null, "tax_office": "7705", "tax_office_legal": "7705", "history_values": [ "пл Добрынинская" ], "source": null, "qc": null } } ] }
Запрос:
<req> <query>москва серпуховская</query> </req>
Ответ:
Показать
<SuggestResponse> <suggestions> <value>г Москва, ул Серпуховская Б.</value> <unrestricted_value>г Москва, ул Серпуховская Б.</unrestricted_value> <data> <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>601875e2-717a-4c30-a3c4-1fb49e67d93f</street_fias_id> <street_kladr_id>77000000000262500</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>601875e2-717a-4c30-a3c4-1fb49e67d93f</fias_id> <fias_code>7700000000000002625</fias_code> <fias_level>7</fias_level> <fias_actuality_state>0</fias_actuality_state> <kladr_id>77000000000262500</kladr_id> <capital_marker>0</capital_marker> <okato/> <oktmo/> <cadastral_number/> <tax_office/> <tax_office_legal/> <history_values/> <source/> <qc/> </data> </suggestions> <suggestions> <value>г Москва, пл Серпуховская</value> <unrestricted_value>115184, г Москва, пл Серпуховская</unrestricted_value> <data> <postal_code>115184</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>6fe35e69-360a-4d75-8061-066a5c9e669c</street_fias_id> <street_kladr_id>77000000000702000</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>6fe35e69-360a-4d75-8061-066a5c9e669c</fias_id> <fias_code>7700000000000007020</fias_code> <fias_level>7</fias_level> <fias_actuality_state>0</fias_actuality_state> <kladr_id>77000000000702000</kladr_id> <capital_marker>0</capital_marker> <okato>45286560000</okato> <oktmo>45376000</oktmo> <cadastral_number/> <tax_office>7705</tax_office> <tax_office_legal>7705</tax_office_legal> <history_values>пл Добрынинская</history_values> <source/> <qc/> </data> </suggestions> </SuggestResponse>
- No labels
Overview
Content Tools