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

...

При этом действуют правила, описанные ниже.

Индекс

Обычно индекс (поле postal_code) не пишется. Но если в списке подсказок получаются полные дубли (обычно такое бывает, если в городе несколько улиц с одинаковым названием), и дописывание района города не помогло разрешить неоднозначность (обычно такое бывает, если район для улиц неизвестен) — то индекс пишется.

Страна

Обычно страна (поле country) не пишется. Но для международных подсказок (если в параметрах запроса явно задано ограничение на страну помимо России) — пишется.

Города-регионы и города-районы

Для городов-регионов (например, Москва) пишется регион (region_with_type), но не одноименный город (city_with_type).

Для городов-районов (например, Одинцово в Московской области) пишется район (area_with_type), но не одноименный город (city_with_type).

Областные и районные центры

Если город — областной центр, регион (region_with_type) не пишется (Новосибирская обл, г Новосибирск → г Новосибирск);

Если город — центр района, район (area_with_type) не пишется (Респ ТатарстанКировская обл, Верхнеуслонский Вятскополянский р-н, село Верхний Услон → Респ Татарстан, село Верхний Услонг Вятские Поляны → Кировская обл, г Вятские Поляны).

Сокращенная запись муниципального деления

Для адресов в муниципальном делении действуют правила, которые записывают адрес в удобочитаемом виде (мун. деление в оригинале очень громоздкое). Примеры:

...

Район города

Обычно район города (в адм. делении это поле city_district_with_type, в мун. делении может быть в area_with_type или в sub_area_with_type) не пишется. Но если в списке подсказок получаются полные дубли (обычно такое бывает, если в городе несколько улиц с одинаковым названием, например улица 8 Марта в Москве) — то район пишется.

Параметр restrict_value

Если в запросе указан параметр restrict_value, то в поле value возвращается только часть адреса, которая подходит под ограничение. Например:

...