Подсказки по адресу (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>
Обзор
Инструменты контента