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

...

Можно указать массив ограничений. Каждый объект-ограничение в параметре locations может содержать поля kladr_id, fias_id, postal_code, country, region, area, city, settlement или street.

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

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

{
    "query": "Ватутина",
    "locations": [{
        "kladr_id": "65"
    }]
}

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

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

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

...

{
    "query": "московское шоссе",
    "locations": [{
        "city_fias_id": "110d6ad9-0b64-47cf-a2ee-7e935228799c"
    }]
}

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

Москва:

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

...

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

Ограничение по типу объекта

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

• street_type_full — ограничение по полному типу улицы;
• settlement_type_full — типу населенного пункта;
• city_district_type_full — типу района города;
• city_type_full — типу города;
• area_type_full — типу района в регионе;
• region_type_full — типу региона.

...

{
	"query":"башко", 
	"locations": [
		{
			"region_type_full": "республика"
		}
	]
}

Ограничение по стране

По умолчанию подсказываются только адреса в России. Для поиска по всем странам, в запросе нужно передать спецсимвол — звёздочку:

...