Чтобы искать адреса только в определенном регионе или городе, укажите их в параметре locations
.
Можно указать массив ограничений. Каждый объект-ограничение в параметре locations
может содержать поля kladr_id
, postal_code
, region
, area
, city
или settlement
.
Москва:
{ "query": "Ботаническая", "locations": [{ "region": "москва" }] }
Тольятти:
{ "query": "Абрикосовая", "locations": [{ "region": "Самарская", "city": "Тольятти" }] }
Сахалинская область или Камчатский край:
{ "query": "Ватутина", "locations": [{ "kladr_id": "65" }, { "region": "камчатский" }] }
Несколько регионов:
{ "query": "ростов рассветная", "locations": [{ "region": "адыгея" }, { "region": "астраханская" }, { "region": "волгоградская" }, { "region": "калмыкия" }, { "region": "краснодарский" }, { "region": "ростовская" }] }
Адрес без региона и города
Чтобы адрес одной строкой в ответе (поле value
) не содержал регион / город, заданный в ограничении, добавьте параметр restrict_value = true
:
{ "query": "Турчанинов", "locations": [ { "region": "Москва" } ], "restrict_value": true }
Ответ:
{ "suggestions": [ { "value": "Турчанинов пер", "unrestricted_value": "г Москва, Турчанинов пер", "data": { ... } }, { "value": "Турчанинов пер, д 2", "unrestricted_value": "г Москва, Турчанинов пер, д 2", "data": { ... } }, { "value": "Турчанинов пер, д 2А", "unrestricted_value": "г Москва, Турчанинов пер, д 2А", "data": { ... } }, { "value": "Турчанинов пер, д 3 стр 1", "unrestricted_value": "г Москва, Турчанинов пер, д 3 стр 1", "data": { ... } } ] }
При этом полный адрес тоже возвращается, в поле unrestricted_value
.
Обзор
Инструменты контента