Кадастр
Поиск объектов недвижимости по кадастровому номеру. suggest понимает полный номер, квартальный префикс (77:01:0001005 — объекты квартала по мере ввода) и сплошные цифры без разделителей; find возвращает точный объект по полному номеру. Ответ — кадастровый объект: адрес и данные ГКО (тип, площадь, этажность, год постройки, материал стен, кадастровая стоимость, даты).
Тарификация — за запрос из пакета (4 коп/запрос, пакеты — в личном кабинете), в дневной лимит подсказок не входит. Доступен только по секретному ключу (серверные вызовы). Кадастровый номер в обычных адресных подсказках и прямой ввод кадастрового номера в /v1/suggest/address — на тарифе «Бизнес».
Необязательные флаги в теле запроса: include_codes: true добавляет к каждому объекту числовые коды-классификаторы (type_code, purpose_code, wall_material_code, cost_unit_code и др.); include_detail: true — реквизиты документа об утверждении стоимости (approval_doc). suggest также принимает locations/locations_boost для гео-предпочтения и понимает текст адреса (подсказки только среди объектов с кадастровым номером).
POST /v1/suggest/cadastre // по мере ввода: полный номер / квартал / сплошные цифры
POST /v1/find/cadastre // точный объект по полному номеру
// тело одинаково для обоих методов
{
"query": "77:01:0001005:1022",
"count": 5
}
// suggest также понимает:
"77:01:0001005" // квартальный префикс → объекты квартала
"770100010051022" // сплошные цифры — двоеточия не обязательныТочный объект по номеру · find/cadastre
POST /v1/find/cadastre
{ "query": "77:01:0001005:1024" }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные объекты недвижимости. |
| suggestions[].cadastral_num | string | Кадастровый номер объекта. |
| suggestions[].value | string | Адрес объекта (краткая форма). |
| suggestions[].full | string | Адрес объекта с индексом (полная форма). |
| suggestions[].address_note | string | Оригинальный текст адреса из ЕГРН с пространственным контекстом (ориентир, «примыкает к…», «в N м от…»). Присутствует только у объектов без обычного адреса (например, участки, заданные относительно ориентира); для обычных адресов поле отсутствует. |
| suggestions[].level | string | Уровень адреса (house, flat и т.п.). |
| suggestions[].federal_district | string | Федеральный округ. |
| suggestions[].type | string | Тип объекта: Здание, Помещение, Сооружение, Земельный участок и т.п. |
| suggestions[].assignation | string | Назначение объекта (например, «Нежилое здание»). |
| suggestions[].object_name | string | Наименование объекта; null, если не задано. |
| suggestions[].area | number | Площадь объекта, м². |
| suggestions[].floors | integer | Число надземных этажей. |
| suggestions[].underground_floors | integer | Число подземных этажей. |
| suggestions[].year_built | integer | Год постройки. |
| suggestions[].year_commissioned | integer | Год ввода в эксплуатацию. |
| suggestions[].wall_material | string | Материал стен (например, «Кирпичные»). |
| suggestions[].cost | number | Кадастровая стоимость объекта, ₽. |
| suggestions[].cost_per_unit | number | Кадастровая стоимость за м², ₽. |
| suggestions[].cost_date | string | Дата определения стоимости (ГГГГ-ММ-ДД). |
| suggestions[].cost_approval_date | string | Дата утверждения стоимости. |
| suggestions[].cadastral_block | string | Кадастровый квартал. |
| suggestions[].parent_parcel_num | string | Кадастровый номер родительского участка. |
| suggestions[].registered_at | string | Дата постановки на кадастровый учёт. |
| suggestions[].cancelled_at | string | Дата снятия с учёта; null — объект действующий. |
| suggestions[].purpose | string | Назначение объекта (для зданий и помещений; для участков — вид разрешённого использования). |
| suggestions[].cost_unit | string | Единица измерения кадастровой стоимости. |
| suggestions[].cost_application_date | string | Дата начала применения кадастровой стоимости. |
| suggestions[].fias_guid | string | Идентификатор адреса объекта в ФИАС (GUID). |
| suggestions[].match | number | Релевантность совпадения 0..1 (по точному кадастровому номеру — 1.0). |