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

Поиск адреса по координатам #

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

POST /geosearch/address

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

Позволяет получить точный адрес, используя координаты (широту и долготу), по заданному уровню и радиусу.

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

ПараметрОписаниеТипПример
latitudeШиротаfloat43.494369
longitudeДолготаfloat39.898826
countryCodeКод страны, используется стандарт ISO 3166-1 alpha-2stringRU
addresslevelУровень искомого объекта, по умолчанию ближайший.
Варианты: region, area, city, settlement, planStructure, street, house.		stringhouse
radiusРадиус поиска в метрах, по умолчанию 100. Максимум 1000.int10

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

{
  "latitude": 43.494369,
  "longitude": 39.898826,
  "countryCode": "RU",
  "addresslevel": "house",
  "radius": 10
}

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

ПараметрОписание
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
  }
}