Просмотреть исходный

В России каждый адрес одновременно существует в двух делениях — административном и муниципальном. Например (выделены отличия):

Самарская обл, г Самара, Железнодорожный р-н, ул Сакко и Ванцетти (административное)
Самарская обл, г.о. Самара, г Самара, вн.р-н Железнодорожный, ул Сакко и Ванцетти (муниципальное)

Раньше «Подсказки» работали только с административным делением. А начиная с версии 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 по-прежнему поддерживается, но в нем работает только административное деление.