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