Ограничение поиска адреса (REST)

Есть возможность ограничить область поиска определенным регионом или городом. Это может быть удобно, если вы хотите принудительно ограничить пользователей некоторым географическим объектом (или несколькими объектами).

Если вы используете REST API, то ограничения следует передавать непосредственно в запросе, в параметре locations. Это массив объектов, которые будут использоваться для наложения ограничений (ограничения между собой объединяются по ИЛИ). Каждый объект-ограничение может содержать поля kladr_id, postal_code, region, area, city или settlement.

Примеры (JSON)

Ограничивает область поиска Москвой:

{
    "query": "Ботаническая",
    "locations": [{
        "region": "москва"
    }]
}

Ограничивает область поиска городом Тольятти:

{
    "query": "Абрикосовая",
    "locations": [{
        "region": "Самарская",
        "city": "Тольятти"
    }]
}

Ограничивает область поиска двумя регионами — Сахалинской областью или Камчатским краем:

{
    "query": "Ватутина",
    "locations": [{
        "kladr_id": "65"
    }, {
        "region": "камчатский"
    }]
}

Ограничивает поиск несколькими регионами:

{
    "query": "ростов рассветная",
    "locations": [{
        "region": "адыгея"
    }, {
        "region": "астраханская"
    }, {
        "region": "волгоградская"
    }, {
        "region": "калмыкия"
    }, {
        "region": "краснодарский"
    }, {
        "region": "ростовская"
    }]
}