Find Address

POST

/findById/address

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

Находит адрес по идентификатору:

• кадастровый номер (stead_cadnum, house_cadnum или flat_cadnum), только для России;
• ФИАС-код, он же ГАР-код (fias_id), только для России;
• КЛАДР-код (kladr_id), только для России;
• Идентификатор OpenStreetMap (fias_id), только для Беларуси, Казахстана и Узбекистана;
• Идентификатор GeoNames (geoname_id), для всех остальных стран.
  По КЛАДР-коду ищет до улицы, по ФИАС-коду — до квартиры.

Official documentation:

https://dadata.ru/api/find-address/https://confluence.hflabs.ru/pages/viewpage.action?pageId=312016944

Authorizations

ApiKey

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

Type

API Key (header: Authorization)

Request Body

application/json

object

Адрес по коду
See https://dadata.ru/api/find-address/
See https://confluence.hflabs.ru/pages/viewpage.action?pageId=312016944

Любой из идентификаторов адреса:

• ФИАС-код до дома, он же ГАР-код (fias_id), только для России (19.7+)
• ФИАС-код квартиры (flat_fias_id), только для России (21.2+)
• КЛАДР-код до улицы (kladr_id) - только для России
• Идентификатор OpenStreetMap (fias_id) - для Беларуси, Казахстана и Узбекистана (20.7+)
• Идентификатор GeoNames (geoname_id) - для всех остальных стран (20.7+)
• кадастровый номер (stead_cadnum, house_cadnum или flat_cadnum) - только для России (22.5+)

Ищет только по точному совпадению, для частичного совпадения
используйте API suggest (https://dadata.ru/api/suggest/bank/)

• ИНН и КПП начиная с версиии подсказок 20.3+

@example {"query": "5f96fd6b-b3de-451f-b280-8fedf859e683"} // ФИАС
@example {"query": "77000000000292300"} // КЛАДР
@example {"query": "way:208547592"} // OpenStreetMap
@example {"query": "1857910", "language":"en"} // Geonames, вернуть результат на английском

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

Default10

Maximum20

На каком языке вернуть результат (ru / en)

Valid values"RU""EN"

Административное либо муниципальное деление
@default 'ADMINISTRATIVE'
See https://confluence.hflabs.ru/pages/viewpage.action?pageId=1326056589

Valid values"ADMINISTRATIVE""MUNICIPAL"

Default"ADMINISTRATIVE"

Responses

Запрос успешно обработан

Content-Type

application/json

object

Ответ содержит объект с массивом подсказок или в административном (по умолчанию)
или в муниципальном (если передано "division": "MUNICIPAL") делении

Any of

object

Объект с массивом подсказок в административном делении

object[]

Required

Массив подсказок или пустой массив

object

Объект с массивом подсказок в муниципальном делении

object[]

Required

Массив подсказок или пустой массив