If you're interested in the English version of this spec, let us know on the GitHub.

fias

---

Подсказки по ФИАС

POST

/suggest/fias

Ищет адреса строго по ФИАС. Нужны только если вам по какой-то причине важно точное, побуквенное соответствие справочнику адресов налоговой службы. В остальных случаях используйте Подсказки по адресу (/suggest/address).

Authorizations

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Type

API Key (header: Authorization)

Request Body

application/json

object

Параметры запроса к API "Подсказки по ФИАС"

See https://dadata.ru/api/suggest/fias/
See https://confluence.hflabs.ru/pages/viewpage.action?pageId=967835937
See https://confluence.hflabs.ru/pages/viewpage.action?pageId=967835953

Текст запроса.
@maxLength 300

Max Length300

Максимальное количество результатов.
@minimum 1
@maximum 20
@default 10

Minimum1

Maximum20

Default10

object[]

Приоритет города или региона при ранжировании.
Передавайте код КЛАДР (kladr_id). Можно указать несколько кодов.

See https://confluence.hflabs.ru/pages/viewpage.action?pageId=968425529

object

Гранулярные подсказки по ФИАС – "левая" граница.

Доступные границы:

• region - Регион
• area - Район
• city - Город
• settlement - Населенный пункт
• planning_structure - Планировочная структура
• street - Улица
• house - Дом

See https://confluence.hflabs.ru/pages/viewpage.action?pageId=968425521

Возможные значения:

• region - Регион
• area - Район
• city - Город
• settlement - Населенный пункт
• planning_structure - Планировочная структура
• street - Улица
• house - Дом

Valid values"region""area""city""settlement""planning_structure""street""house"

object

Гранулярные подсказки по ФИАС – "правая" граница.

Доступные границы:

• region - Регион
• area - Район
• city - Город
• settlement - Населенный пункт
• planning_structure - Планировочная структура
• street - Улица
• house - Дом

See https://confluence.hflabs.ru/pages/viewpage.action?pageId=968425521

Возможные значения:

• region - Регион
• area - Район
• city - Город
• settlement - Населенный пункт
• planning_structure - Планировочная структура
• street - Улица
• house - Дом

Valid values"region""area""city""settlement""planning_structure""street""house"

object[]

Ограничение сектора поиска адреса.

Чтобы искать адреса только в определенном регионе, городе, районе и т.д.,
укажите их в параметре locations.
Можно указать несколько ограничений, но не более 10.

Адрес без региона и города:
Чтобы адрес одной строкой в ответе (поле value) не содержал регион / город, заданный в ограничении,
добавьте в запрос параметр restrict_value = true.

See https://confluence.hflabs.ru/pages/viewpage.action?pageId=967835974

Ограничение по КЛАДР-коду. Например:

• 63 — Самарская обл.
• 63000001 — г. Самара
• 6300000100000 — г. Самара (полный код)

Не рекомендуем использовать для объектов ниже города:

• не слишком надежно для населенных пунктов (КЛАДР-коды н/п довольно часто меняются);
• не работает для план. структур (они появились после того, как была придумана иерархия КЛАДР, и не вписываются в нее);
• очень ненадежно для улиц (КЛАДР-коды улиц часто меняются);
• не работает для домов.

Рекомендуем использовать fias_id - ограничение по ФИАС-коду.

Ограничение по ФИАС-коду.

Например: "fias_id": "110d6ad9-0b64-47cf-a2ee-7e935228799c" - Санкт-Петербург, г Пушкин

Ограничение по fias_id дома не поддерживается

Ограничение по ФИАС-коду региона. Лучшая альтернатива - fias_id.

Ограничение по ФИАС-коду административного района. Лучшая альтернатива - fias_id.

Ограничение по ФИАС-коду города. Лучшая альтернатива - fias_id.

Ограничение по ФИАС-коду населённого пункта. Лучшая альтернатива - fias_id.

Ограничение по ФИАС-коду планировочной структуры. Лучшая альтернатива - fias_id.

• не задокументировано для API адресов, только для API ФИАС, но работает

Ограничение по ФИАС-коду улицы. Лучшая альтернатива - fias_id.

Ограничение по названию региона

Ограничение по названию административного района

Ограничение по названию города

Ограничение по названию района города

• не задокументировано для API адресов, только для API ФИАС, но работает

Ограничение по названию населённого пункта

Ограничение по названию планировочной структуры

• не задокументировано для API адресов, только для API ФИАС, но работает

Ограничение по названию улицы

Ограничение по полному типу региона, например: республика

Ограничение по полному типу адм. района в регионе. Например: улус

Ограничение по полному типу города. Например: поселок городского типа

Ограничение по полному типу района города.

• не задокументировано для API адресов, только для API ФИАС, но работает

Ограничение по полному типу населенного пункта. Например: деревня

Ограничение по полному типу планировочной структуры. Например: территория снт

• не задокументировано для API адресов, только для API ФИАС, но работает

Ограничение по полному типу улицы. Например: проспект

Используется совместно с ограничениями (параметр locations), чтобы адрес в ответе
(поле value) не содержал регион / город / район и т.д., заданный в ограничении.

See https://confluence.hflabs.ru/pages/viewpage.action?pageId=967835974#:~:text=Адрес%20без%20региона%20и%20города