Подсказки адреса

Подсказки адреса #

Метод быстрого подбора адреса из ранжированного по схожести, списка. Минимальное количество букв необходимых для начала поиска – 3.

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

POST /suggest/address

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

  • очищает входящие данные от лишних символов для стандартизации адреса
  • по части адреса выводит список возможных адресов, отсортированный по релевантности

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

ПараметрОписание
queryСтрока для подсказки и разбора адреса
countryCodeКод страны, в которой происходит поиск адреса, в формате ISO 3166 (https://www.iso.org/iso-3166-country-codes.html)
countМаксимальное количество адресов которые предлагаются в ответе

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

{
  "query": "москва варш",
  "countryCode": "RU",
  "count": 5
}

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

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