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

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

POST /geosearch/address

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

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

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

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

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

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

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

Параметр	Описание
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": "Москва, Профсоюзная улица, 42к1, 242",
  "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": null,
    "additional": null
  },
  "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": []
}