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

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

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

POST /idsearch/address

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

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

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

ПараметрОписаниеТипПример
queryСтрока для разбора адресаstring0361c9ca-1703-4535-b11a-6fbd372448e1
typeТип адресного реестра для поиска.
Варианты: UNKNOWN, GAR, FIAS, KLADR, OSM, GA.		stringFIAS
countryCodeКод страны, используется стандарт ISO 3166-1 alpha-2stringRU

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

{
  "query": "0361c9ca-1703-4535-b11a-6fbd372448e1",
  "type": "FIAS",
  "countryCode": "RU"
}

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

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

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

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

{
  "original": "0361c9ca-1703-4535-b11a-6fbd372448e1",
  "addressFull": "г Москва, ул Профсоюзная, дом 42, корпус 1, квартира 242",
  "address": "г Москва, ул Профсоюзная",
  "postcodeIn": "",
  "postcode": "117335",
  "region": {
    "fullName": "г Москва",
    "name": "Москва",
    "type": "г",
    "codes": {
      "fias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
      "ga": "RU0770000000000000000000000",
      "osm": "R102269",
      "gar": "1405113",
      "kladr": "7700000000000"
    }
  },
  "area": {
    "fullName": "",
    "name": "",
    "type": "",
    "codes": {
      "fias": "",
      "ga": "",
      "osm": "",
      "gar": "",
      "kladr": ""
    }
  },
  "municipal": {
    "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": "9a661426-e65c-4223-af4d-aa5e95b7caac",
      "ga": "RU0770000000000000000002392",
      "osm": "W30750376",
      "gar": "1401987",
      "kladr": "77000000000239200"
    }
  },
  "houseDetails": {
    "fullName": "дом 42, корпус 1, квартира 242",
    "house": "42",
    "case": "1",
    "build": "",
    "liter": "",
    "lend": "",
    "constr": "",
    "stead": "",
    "flat": "242",
    "office": "",
    "room": "",
    "kab": "",
    "place": "",
    "entr": "",
    "floor": "",
    "block": "",
    "pav": "",
    "sek": "",
    "abon": "",
    "munit": "",
    "codes": {
      "fias": "2d960636-942f-48bd-8362-b39fea91a3e4",
      "ga": "",
      "osm": "",
      "gar": "56965994",
      "kladr": ""
    },
    "apartmentCodes": {
      "fias": "0361c9ca-1703-4535-b11a-6fbd372448e1",
      "ga": "",
      "osm": "",
      "gar": "56968181",
      "kladr": ""
    },
    "additional": {
      "houseIsMultiFlat": true,
      "houseFlatCount": "143",
      "houseCadnum": "77:06:0003009:1025",
      "apartmentCadnum": "77:06:0003009:2561"
    }
  },
  "coordinates": {
    "latitude": 55.674565,
    "longitude": 37.55814
  },
  "country": {
    "name": "Россия",
    "alpha2": "RU",
    "alpha3": "RUS",
    "numeric": 643
  },
  "valid": true,
  "quality": {
    "unique": 0,
    "actuality": 0,
    "undefined": 0,
    "level": 9,
    "house": 3,
    "geo": 8
  },
  "timezone": "UTC+3",
  "undefinedParts": "",
  "metro": []
}