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

Поле Поле value содержит адрес одной строкой. Склеивается из полей объекта data:

• data.postal_code (индекс),
• data.country (страна),
• data.region_with_type (регион с типом),
• data.area_with_type (район в регионе с типом),
• data.sub_area_with_type (мун. поселение с типом),
• data.city_with_type (город с типом),
• data.city_district_with_type (адм. район города с типом),
• data.settlement_with_type (населенный пункт с типом),
• data.street_with_type (улица с типом),
• data.stead_type (тип участка),
• data.stead (участок),
• data.house_type (тип дома),
• data.house (дом),
• data.block_type (тип корпуса/строения),
• data.block (корпус/строение),
• data.flat_type (тип квартиры),
• data.flat (квартира),
• data.room_type (тип комнаты),
• data.room (комната).

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

Индекс

...

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

...

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

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

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

...

Район города

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

Параметр restrict_value

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

...