В России каждый адрес одновременно существует в двух делениях — административном и муниципальном. Например (выделены отличия):
- Самарская обл, г Самара, Железнодорожный р-н, ул Сакко и Ванцетти (административное)
- Самарская обл, г.о. Самара, г Самара, вн.р-н Железнодорожный, ул Сакко и Ванцетти (муниципальное)
Раньше «Подсказки» работали только с административным делением. А начиная с версии 22.4 поддерживают оба деления — административное и муниципальное.
Чтобы получить адрес в муниципальном делении, передайте параметр division = municipal
:
{ "query": "Самара, ул Сакко и Ванцетти, д 24", "division": "municipal" }
В муниципальном делении есть две специфические для него группы полей:
- муниципальный район (
area*
); - муниципальное поселение (
sub_area*
).
Поля внутригородского адм. района (city_district*
) в муниципальном делении отсутствуют.
В административном делении тоже две специфические группы полей:
- адм. район в регионе (
area*
); - адм. район города (
city_district*
);
Поля мун. поселения (sub_area*
) в административном делении отсутствуют.
Пример адреса в мун. делении:
{ "suggestions": [ { "value": "Самарская обл, г Самара, ул Сакко и Ванцетти, д 24", "unrestricted_value": "443082, Самарская обл, г Самара, ул Сакко и Ванцетти, д 24", "data": { "postal_code": "443082", "country": "Россия", "country_iso_code": "RU", "federal_district": null, "region_fias_id": "df3d7359-afa9-4aaa-8ff9-197e73906b1c", "region_kladr_id": "6300000000000", "region_iso_code": "RU-SAM", "region_with_type": "Самарская обл", "region_type": "обл", "region_type_full": "область", "region": "Самарская", "area_fias_id": "f28441ff-b33a-4f9d-8a93-b187c64a2cf0", "area_kladr_id": null, "area_with_type": "г.о. Самара", "area_type": "г.о.", "area_type_full": "городской округ", "area": "Самара", "sub_area_fias_id": "886c118c-9e7f-40a2-8953-e1827980f366", "sub_area_kladr_id": null, "sub_area_with_type": "вн.р-н Железнодорожный", "sub_area_type": "вн.р-н", "sub_area_type_full": "внутригородской район", "sub_area": "Железнодорожный", "city_fias_id": "bb035cc3-1dc2-4627-9d25-a1bf2d4b936b", "city_kladr_id": "6300000100000", "city_with_type": "г Самара", "city_type": "г", "city_type_full": "город", "city": "Самара", "city_area": null, "settlement_fias_id": null, "settlement_kladr_id": null, "settlement_with_type": null, "settlement_type": null, "settlement_type_full": null, "settlement": null, "street_fias_id": "7fc3d80f-044e-48f0-8431-97ea34697f90", "street_kladr_id": "63000001000034300", "street_with_type": "ул Сакко и Ванцетти", "street_type": "ул", "street_type_full": "улица", "street": "Сакко и Ванцетти", "stead_fias_id": null, "stead_cadnum": null, "stead_type": null, "stead_type_full": null, "stead": null, "house_fias_id": "7a23cbd2-4fad-461d-8c99-c5c53f767eba", "house_kladr_id": null, "house_cadnum": null, "house_type": "д", "house_type_full": "дом", "house": "24", "block_type": null, "block_type_full": null, "block": null, "entrance": null, "floor": null, "flat_fias_id": null, "flat_cadnum": null, "flat_type": null, "flat_type_full": null, "flat": null, "flat_area": null, "square_meter_price": null, "flat_price": null, "postal_box": null, "fias_id": "7a23cbd2-4fad-461d-8c99-c5c53f767eba", "fias_code": null, "fias_level": "8", "fias_actuality_state": "0", "kladr_id": "63000001000034300", "geoname_id": "499099", "capital_marker": "2", "okato": "36401364000", "oktmo": "36701305", "tax_office": "6316", "tax_office_legal": "6316", "timezone": null, "geo_lat": "53.193332", "geo_lon": "50.152897", "beltway_hit": null, "beltway_distance": null, "metro": null, "divisions": null, "qc_geo": "0", "qc_complete": null, "qc_house": null, "history_values": null, "unparsed_parts": null, "source": null, "qc": null } } ] }
По умолчанию, без параметра division
, адрес возвращается в административном делении.
Чтобы активировать поддержку муниципального деления, необходимо использовать новый справочник адресов suggestions_eas
вместо старого suggestions_address
. Старый справочник suggestions_address
по-прежнему поддерживается, но в нем работает только административное деление.