Подсказки адреса #
Метод быстрого подбора адреса из ранжированного по схожести, списка. Минимальное количество букв необходимых для начала поиска – 3.
Адрес метода #
POST /suggest/address
Функциональность #
- очищает входящие данные от лишних символов для стандартизации адреса
- по части адреса выводит список возможных адресов, отсортированный по релевантности
Параметры запроса #
| Параметр | Описание |
|---|---|
| query | Строка для подсказки и разбора адреса |
| countryCode | Код страны, в которой происходит поиск адреса, в формате ISO 3166 (https://www.iso.org/iso-3166-country-codes.html) |
| count | Максимальное количество адресов которые предлагаются в ответе |
| scopes | Ограничение сектора поиска адреса. См. описание структуры scopes |
Вложенные структуры #
Описание структуры scopes
#
| Параметр | Описание |
|---|---|
| fias | Код в базе ФИАС |
| ga | GaCode - глобальный адресный код |
| kladr | Код в базе КЛАДР |
| postcode | Почтовый индекс определенный по эталонной базе в процессе стандартизации |
| name | Город |
| regionName | Регион, область |
| streetName | Улица |
| coordinates | Координаты. См. описание структуры coordinates |
Описание структуры coordinates
#
| Параметр | Описание |
|---|---|
| latitude | Широта |
| longitude | Долгота |
| radius | Радиус поиска в метрах |
Пример данных запроса #
{
"query": "котлас куз",
"countryCode": "RU",
"count": 10,
"scopes": [
{
"fias": "cfa3b599-159c-49f9-992e-3aa64c675ad6",
"ga": "RU0290080000000000000000000",
"osm": "",
"gar": "447206",
"kladr": "2900800000001",
"postcode": "165300",
"name": "Котлас",
"regionName": "Архангельская",
"streetName": "Кузнецова",
"coordinates": {
"latitude": 61.2431,
"longitude": 46.6537,
"radius": 100
}
}
]
}
Параметры ответа #
| Параметр | Описание |
|---|---|
| suggestions | Массив объектов, структура которых совпадает с ответом Метода стандартизации адресов |
Пример данных ответа #
{
"suggestions": [
{
"addressFull": "г Москва, Варшавское ш",
"address": "г Москва, Варшавское ш",
"postcode": "117105",
"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": "8fc06b0b-5de3-4a72-9e6f-9e0647a37a66",
"ga": "RU0770000000000000000000476",
"osm": "W25056568",
"gar": "1405985",
"kladr": "77000000000047600"
}
},
"houseDetails": {
"fullName": "",
"floor": "",
"house": "",
"case": "",
"build": "",
"liter": "",
"lend": "",
"block": "",
"pav": "",
"flat": "",
"office": "",
"kab": "",
"abon": "",
"plot": "",
"sek": "",
"entr": "",
"room": "",
"hostel": "",
"munit": "",
"codes": null
},
"coordinates": {
"latitude": 55.646,
"longitude": 37.6203
},
"country": {
"name": "Россия",
"alpha2": "RU",
"alpha3": "RUS",
"numeric": 643
},
"timezone": "UTC+3"
},
{
"addressFull": "г Москва, 2-й Варшавский проезд",
"address": "г Москва, 2-й Варшавский проезд",
"postcode": "115201",
"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": ""
}
},
"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": "2-й Варшавский проезд",
"name": "2-й Варшавский",
"type": "проезд",
"codes": {
"fias": "b89718e1-8b56-4ba8-8383-5c7b596aee6c",
"ga": "RU0770000000000000000000475",
"osm": "W30706715",
"gar": "1404889",
"kladr": "77000000000047500"
}
},
"houseDetails": {
"fullName": "",
"floor": "",
"house": "",
"case": "",
"build": "",
"liter": "",
"lend": "",
"block": "",
"pav": "",
"flat": "",
"office": "",
"kab": "",
"abon": "",
"plot": "",
"sek": "",
"entr": "",
"room": "",
"hostel": "",
"munit": "",
"codes": null
},
"coordinates": {
"latitude": 55.6442,
"longitude": 37.63
},
"country": {
"name": "Россия",
"alpha2": "RU",
"alpha3": "RUS",
"numeric": 643
},
"timezone": "UTC+3"
}
]
}