Поиск адреса по ID

Поиск адреса по ID #

Адрес метода #

POST /idsearch/address

Функциональность #

Позволяет получить точный адрес, используя адресный реестр (FIAS, KLADR и т.д.) и значение (ID) объекта.

Параметры запроса #

ПараметрОписаниеТипПример
queryСтрока для разбора адресаstring947ac692-01e0-4b3e-8bbe-82169a86fd95
typeТип адресного реестра для поиска.
Варианты: UNKNOWN, GAR, FIAS, KLADR, OSM, GA.		stringFIAS
countryCodeКод страны, используется стандарт ISO 3166-1 alpha-2stringRU

Пример данных запроса #

{
  "query": "947ac692-01e0-4b3e-8bbe-82169a86fd95",
  "type": "FIAS",
  "countryCode": "RU"
}

Параметры ответа #

ПараметрОписание
originalВходящая строка с адресом, которая участвовала в стандартизации
addressСтрока с разобранным и стандартизированным адресом
addressFullСтрока с разобранным и стандартизированным адресом вместе с домовой частью
postcodeInПочтовый индекс найденный во входящей строке
postcodeПочтовый индекс определенный по эталонной базе в процессе стандартизации
regionРегион, область. См. описание структуры addressLevel
areaРайон области. См. описание структуры addressLevel
cityГород. См. описание структуры addressLevel
cityAreaРайон города. См. описание структуры addressLevel
settlementНаселенный пункт. См. описание структуры addressLevel
planStructureПланировочная структура (микрорайон). См. описание структуры addressLevel
streetУлица. См. описание структуры addressLevel
houseDetailsДомовая часть адреса. См. описание структуры houseDetails
coordinatesГеографические координаты. См. описание структуры coordinates
countryСтрана. См. описание структуры country
validПризнак корректности адреса
qualityКод качества адреса. См Код качества адреса

Описания структур доступны на странице стандартизации адреса.

Пример данных ответа #

{
  "original": "санкт-петербург гороховая улица, 44",
  "addressFull": "г Санкт-Петербург, ул Гороховая, дом 44",
  "address": "г Санкт-Петербург, ул Гороховая",
  "postcodeIn": "",
  "postcode": "190000",
  "region": {
    "fullName": "г Санкт-Петербург",
    "name": "Санкт-Петербург",
    "type": "г",
    "codes": {
      "fias": "c2deb16a-0330-4f05-821f-1d09c93331e6",
      "ga": "RU0780000000000000000000000",
      "osm": "R337422",
      "gar": "1414662",
      "kladr": "7800000000000"
    }
  },
  "area": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "city": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "cityArea": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "settlement": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "planStructure": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "street": {
    "fullName": "ул Гороховая",
    "name": "Гороховая",
    "type": "ул",
    "codes": {
      "fias": "7daba2d5-ccdd-4a51-b55c-1f73f67fe4a5",
      "ga": "RU0780000000000000000000314",
      "osm": "W218508357",
      "gar": "1418859",
      "kladr": "78000000000031400"
    }
  },
  "houseDetails": {
    "fullName": "дом 44",
    "floor": "",
    "house": "44",
    "case": "",
    "build": "",
    "liter": "",
    "lend": "",
    "block": "",
    "pav": "",
    "flat": "",
    "office": "",
    "kab": "",
    "abon": "",
    "plot": "",
    "sek": "",
    "entr": "",
    "room": "",
    "hostel": "",
    "munit": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "W66319028",
      "gar": "",
      "kladr": ""
    }
  },
  "coordinates": {
    "latitude": 59.92743425,
    "longitude": 30.32504983
  },
  "country": {
    "name": "Россия",
    "alpha2": "RU",
    "alpha3": "RUS",
    "numeric": 643
  },
  "valid": true,
  "quality": {
    "unique": 0,
    "actuality": 0,
    "undefined": 0,
    "level": 8,
    "house": 3,
    "geo": 8
  }
}