История страницы

Чтобы искать адреса только в определенном регионе или городе, укажите их в параметре locations.

Можно

...

указать

...

массив

...

ограничений. Каждый

...

объект-ограничение

...

в

...

параметре locations может

...

содержать

...

поля kladr_id,

...

fias_id, postal_code, region, area, city, settlement или

...

street.

Ограничение по коду КЛАДР

Сахалинская областьМосква:

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

Ограничение по коду ФИАС

Возможные ограничения:

• region_fias_id – ограничение по ФИАС коду региона

• area_fias_id – ограничение по ФИАС коду области

• city_fias_id – ограничение по ФИАС коду города

• settlement_fias_id – ограничение по ФИАС коду населенного пункта

• street_fias_id – ограничение по ФИАС коду улицы

г ПушкинТольятти:

{
    "query": "Абрикосоваямосковское шоссе",
    "locations": [{
        "region": "Самарская",
        "citycity_fias_id": "Тольятти110d6ad9-0b64-47cf-a2ee-7e935228799c"
    }]
}

Ограничение по названию адресного объекта

МоскваСахалинская область или Камчатский край:

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

г ПушкинНесколько регионов:

{
    "query": "московскоеростов шоссерассветная",
    "locations": [{
        "city_fias_idregion": "110d6ad9-0b64-47cf-a2ee-7e935228799cадыгея"
    }
}

Несколько регионов:

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

Тольятти:

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

Адрес без региона и города

Чтобы адрес одной строкой в ответе (поле value) не содержал регион / город, заданный в ограничении, добавьте параметр restrict_value = true:

...

При этом полный адрес тоже возвращается, в поле unrestricted_value.