Указывается в параметре locations:
Поле | Описание |
---|---|
region | Ограничение по названию региона |
area | района |
city | города |
settlement | населенного пункта |
street | улицы |
Москва:
{ "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
.