Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

Версия 1 Следующий »

Подсказки по адресу (REST)

URL: {base_path}/suggest/address

Метод: POST

Параметры

ПараметрОбязательный?Описание
queryдаСтрока, для которой нужно получить подсказки
count
нетКоличество возвращаемых подсказок (если не указано, используется значение по умолчанию).
locations
нетОграничение области поиска.

В качестве ответа возвращается список объектов адреса.

Дополнительные возможности

Примеры

JSON

Запрос

{
  "query": "москв серпуховская" 
}

Ответ:

Пример ответа для query=москва%20серпуховская, кодировка UTF-8
{
    "suggestions": [
        {
            "data": {
                "postal_code": "115093",
                "country": "Россия",
                "region_type": "г",
                "region": "Москва",
                "area_type": null,
                "area": null,
                "city_type": null,
                "city": null,
                "settlement_type": null,
                "settlement": null,
                "street_type": "ул",
                "street": "Серпуховская Б.",
                "house_type": null,
                "house": null,
                "kladr_id": "77000000000262500",
                "okato": null
            },
            "value": "Россия г Москва ул Серпуховская Б."
        },
        {
            "data": {
                "postal_code": "115184",
                "country": "Россия",
                "region_type": "г",
                "region": "Москва",
                "area_type": null,
                "area": null,
                "city_type": null,
                "city": null,
                "settlement_type": null,
                "settlement": null,
                "street_type": "пл",
                "street": "Серпуховская",
                "house_type": null,
                "house": null,
                "kladr_id": "77000000000702000",
                "okato": "45286560000"
            },
            "value": "Россия г Москва пл Серпуховская"
        }
  ]
}
XML

Запрос:

<req>
  <query>москв серпуховская</query>
</req>

Ответ:

<SuggestAddressResponse>
    <suggestions>
        <data>
            <postal_code>115093</postal_code>
            <country>Россия</country>
            <region_type>г</region_type>
            <region>Москва</region>
            <area_type/>
            <area/>
            <city_type/>
            <city/>
            <settlement_type/>
            <settlement/>
            <street_type>ул</street_type>
            <street>Серпуховская Б.</street>
            <house_type/>
            <house/>
            <kladr_id>77000000000262500</kladr_id>
            <okato/>
        </data>
        <value>Россия г Москва ул Серпуховская Б.</value>
    </suggestions>
    <suggestions>
        <data>
            <postal_code>115184</postal_code>
            <country>Россия</country>
            <region_type>г</region_type>
            <region>Москва</region>
            <area_type/>
            <area/>
            <city_type/>
            <city/>
            <settlement_type/>
            <settlement/>
            <street_type>пл</street_type>
            <street>Серпуховская</street>
            <house_type/>
            <house/>
            <kladr_id>77000000000702000</kladr_id>
            <okato>45286560000</okato>
        </data>
        <value>Россия г Москва пл Серпуховская</value>
    </suggestions>
</SuggestAddressResponse>
  • Нет меток