Поиск кадастрового номера по структурированному адресу

Для работы с методами API необходима Авторизация.

Запрос

Для получения кадастрового номера пользователю необходимо направить запрос /realty/v1/location/cadastre/suggest методом POST

В теле запроса должен быть расположен JSON, содержащий описание структурированного уровня адресного объекта до дома или квартиры.

Адресный объект в базе ФИАС содержит следующие адресные уровни:

  • region - регион ОН - является обязательным значением для индетификации адреса, должен содежать:

    • name - наименование региона Новосибирская область

  • autonomousCounty - автономная область ОН, элемент должен содежать:

    • name - наименование автономии Республика Крым

  • district - район расположения ОН, элемент должен содежать:

    • name - наименование района Ханты-Мансийский

  • city - город расположения ОН, элемент должен содежать:

    • name - наименование города Екатеринбург

  • settlement - населенный пункет ОН, содежит:

    • name - наименование населенного пункта село Базьяны

  • street - улица, описание которой содежит:

    • name - наименование улицы Ленина

  • house - описание дома состоит из 3х уровней детализации:

    • number - номер дома 5
    • buildingNumber - номера здания (корпус) 1
    • sructureNumber - номера строения (литера) А

  • room - описание помещения помещения состоит из

    • number - номер офиса/квартиры 120

Пример запроса

POST /v1/cadastre/suggest
Content-Type: application/json

{
 "region": {
   "name": "Новосибирский"
 },
 "city": {
   "name": "Новосибирск"
 },
 "street" : {
   "name" : "Татьяны Снежиной"
 },
 "house" : {
   "number" : "39",
 },
 "room" : {
   "number" : "120"
 }
}

Ответ

Ответ содержит массив объектов, советующих заданным в запросе параметрам.

Параметр Описание
objectId Код объекта
subjectId Код субъекта
regionId Код региона
settlementId Код населенного пунка
srcObject Код типа объекта
objectCn Кадастровый номер
street Название улицы
house Описание дома
apartment Номер помещения
addressNotes Неструктурированное описание адреса

Пример ответа

HTTP/1.0 200 OK
Content-Type: application/json

 [
  {
    "objectId":"54:35:0:5911",
    "subjectId":150000000000,
    "regionId":150401000000,
    "settlementId":150401379000,
    "srcObject":1,
    "regionKey":154,
    "objectCn":"54:35:000000:5911",
    "street":"ТАТЬЯНЫ СНЕЖИНОЙ|УЛ",
    "house":"39||",
    "apartment":"120",
    "addressNotes":"г Новосибирск, ул Татьяны Снежиной, д. 39, 120"
  },
  {
    "objectId":"54:35:0:5013",
    "subjectId":150000000000,
    "regionId":150401000000,
    "settlementId":150401379000,
    "srcObject":1,
    "regionKey":154,
    "objectCn":"54:35:000000:5013",
    "street":"ТАТЬЯНЫ СНЕЖИНОЙ|УЛ",
    "house":"39/1||",
    "apartment":"120",
    "addressNotes":"г Новосибирск, ул Татьяны Снежиной, д. 39/1, 120"
  }
]
Возможные HTTP-коды возврата:
  • 400 - один из параметров запроса был указан в неверном формате,
  • 200 - выполнение запроса завершилось успешно.