Чтобы искать адреса только в определенном регионе или городе, укажите их в параметре locations
.
Можно указать массив ограничений. Каждый объект-ограничение в параметре locations
может содержать поля kladr_id
, fias_id
, postal_code
, region
, area
, city
, settlement или street
.
Сахалинская область:
{ "query": "Ватутина", "locations": [{ "kladr_id": "65" }] } |
Возможные ограничения:
г Пушкин:
{ "query": "московское шоссе", "locations": [{ "city_fias_id": "110d6ad9-0b64-47cf-a2ee-7e935228799c" } } |
Москва:
{ "query": "Ботаническая", "locations": [{ "region": "москва" }] } |
Несколько регионов:
{ "query": "ростов рассветная", "locations": [{ "region": "адыгея" }, { "region": "астраханская" }, { "region": "волгоградская" }, { "region": "калмыкия" }, { "region": "краснодарский" }, { "region": "ростовская" }] } |
Тольятти:
{ "query": "Абрикосовая", "locations": [{ "region": "Самарская", "city": "Тольятти" }] } |
Адрес без региона и города
Чтобы адрес одной строкой в ответе (поле 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
.