3.2.1. The rules of attribution of administrative units

Use the attribute panel to add attributes to map items belonging to the “Administrative division” category.

Rules for adding attributes to items can be found below. Type (level)

Choose the type (level) of an administrative division from the drop-down list in the upper panel:

Your choices for the type of administrative division will depend on the country you are mapping. Examples of second- and third-level administrative divisions (used in various countries) can be found in the table below:

Level 1. Country Level 2. Region Level 3. District
Russia Region, republic, province, autonomous territory, autonomous region, federal city District, city region
USA State Area
Germany State Area
Spain Autonomous region Province
China Province, autonomous district, city municipalities County
India State, federal territory Area, district
Brazil State Municipality
Australia State, territory County
Poland Province Municipality
Egypt Governorate Municipality
Indonesia Province Region
Belarus Region District
Turkmenistan County District
Georgia Province, autonomous republic District
Turkey Silt District

Administrative divisions at the first level (“Country”) and second level (“Region”) can not be created or edited on Yandex Map Editor. They function solely as items that lower-level administrative divisions can be linked to.

The available types of administrative divisions form a hierarchy: every division includes divisions of an equal or greater level within it. For more information, see Section Parent division. Name

On the assignment of names, see Section Types of names: General rules and Rules for entering all types of names.

Additionally, when you enter values for any of the “Name” attribute types for various types of administrative divisions, you must follow these rules: Official

This name type is mandatory.

The full name of the division that is recognized in that country.

Usually it includes the type of map item.

For the rules of writing names of this type, see Section Official. Caption on map

Use this field if the item's caption on the map should differ from its official name.

See the rules for writing names of this type in Section For the caption on the map.

Caption names typically do not include the map item type unless one of the following exceptions applies:

  • If map items of various sub-types (like a locality and a rural settlement) located nearby have identical proper names.

  • If the proper name itself (without the type) is not sufficient to identify the item.

In these cases, the caption name should include an abbreviated type name. Renaming

See Section Previously called. Synonym, historical

See Section Also known as, historical. As part of the address

Enter this name for administrative divisions if their address name differs from their official names. See also Section3. The address contains. Administrative subordination

The “Parent division” panel indicates the administrative division that is one level above the item you are adding.

This is how the administrative division hierarchy is formed on the map.

Every division (other than those on the highest, country level) should belong either to a division at a higher level or to a division at the same level that encompasses the item in question. If there are several divisions of the latter type, select the one with the smallest area as the parent.

Thus, the position of the administrative unit in the hierarchy is not completely determined by the value of the attribute Type (level): at the same hierarchy level there can be units with different attribute values, and vice versa: units of the same type can be at different levels of the hierarchy.

When administrative divisions of the same type belong to different hierarchy levels, it is referred to as division nesting.

Some items may have two positions in the administrative division hierarchy. For example, Moscow is both a level 4 (locality) and a level 2 (sub-federal unit).

Additionally, sometimes levels can be skipped in the hierarchy. For example, a block (level 7) can have a parent division that is a level 4 “locality” (for more information, see point

There are seven hierarchy levels for administrative divisions on Yandex Map Editor. Follow these rules when working with hierarchies: Country (level 1)

Divisions at this level can not be created or edited on Yandex Map Editor. They function solely as items that lower-level administrative divisions can be linked to. Area (level 2)

Second-level administrative divisions can be nested.

Examples of second-level administrative divisions in various countries can be found in the above table.

Second-level divisions can not be created or edited on Yandex Map Editor. They function solely as items that lower-level administrative divisions can be linked to. Regional area (level 3)

“District” is the general term that refers to districts, provinces, republics, and autonomous areas. Municipal areas of Russia that are divided into urban and rural settlements, city regions in Russia, mayorats in Kazakhstan, and regional districts of various countries all belong to this level.

The parent division for districts is the region (level 2).

Examples of second-level administrative divisions in various countries can be found in the above table.

Level 3 divisions are the parent entities for individual “Localities” (level 4) located on their territories.

Divisions at this hierarchical level can be nested: for all urban/rural settlements (level 3), the parent divisions are the municipal districts they are located in (also level 3). Locality (level 4)

The locality level of the hierarchy includes cities, villages, towns, etc.

This level always includes gardening co-ops and rural (dacha)settlements.

In sparsely populated, sprawling territories that are far from urban areas, this level also includes individual homes that have names. Mark these homes as the Center of the administrative division using placemarks (not polygons).


This level also includes territories of former localities that still have addresses and streets (such as in the Chernobyl zone).

Level 3 (“Districts”) map items are the parent urban/rural areas that these level 4 localities belong to. If there are no urban or rural settlements, then the municipal district or city region that the locality is located on will function as the parent item.

Level 4 items are the parents of level 5 (City districts) and level 7 (Blocks) administrative divisions. Localities within other localities are also classified as Level 7 (Blocks) divisions.

You can nest items at this level: gardening co-ops located on the territories of localities will form a second locality level. For example: city of Penze (4) → Ivushka gardening co-op (4).

Localities on the territories of federal cities are classified according to their own rules. The area of the city (level 5)

City districts have their own hierarchical level separate from that for subdistricts and blocks.

Localities (Level 4) are the parent items for level 5 items.

Nesting is allowed for city districts. Named territory (level 6)

This level of the hierarchy includes:

  1. Unofficial territories within localities that have borders and established informal or historical names (i.e. the name doesn't adhere to any classification system, but is rather a proper name).

  2. Tracts of land that were settled at some point (former localities or agricultural areas) with or without remnants of landmarks.

    Note. Similarly uninhabited areas that still have addresses and streets (such as the Chernobyl zone) are classified as localities (level 4).
  3. Previously inhabited areas where no anthropogenic influence can be discerned via satellite imagery.

    These items are represented using placemarks (not polygons).

  4. Intersections and interchanges with established names (all countries except Turkey).

    Note. If a name is derived from an item's location or names of the roads that are part of the area, this name is not considered an official established name.

    Intersections and at-grade junctions are represented as a placemark with no polygons on the map. For example, “Pyat Uglov” in St. Petersburg:

    Junctions at different grades should be drawn with polygons if they have proper names. The polygon should include the junction and part of its nearby territory if that area historically shares the junction's name. For example:

Enter an “Official” name for these types of territories (even though they don't have official names per se, which their level classification attests to).

Nesting of named territories is not allowed: parent divisions for levels 6 items always have to be located at a higher hierarchy level. Even in cases where the named territory (level 6) is located in an unofficial district that is also a level 6 item, the locality is still the parent item for both of them.

Level 6 items can not have daughter items; addresses and roads can not be linked to them. Blocks (level 7)

This level of the hierarchy includes:

  1. Former villages, farmsteads, towns, and cities that are located on the territories of larger localities whose names are used in addresses.

  2. Former villages, farmsteads, towns, and cities that are located on the territories of larger localities whose names are not used in addresses, but still have standalone structures and can be used as landmarks.

  3. Residential areas, towns, and villages located on the territory of localities that do not have an official status but are referenced as citywide landmarks in official documents and used in transport stop names, media, and advertising (by officially registered mass media organizations and advertising agencies). If you are not sure what an item's type is, give preference to whatever one is used in local government documents.

  4. Architectural planning divisions that have the “subdistrict” or “block” types in their names may be located within localities or outside of them.

  5. Named individual homes and small structures on farms that don't have numbered addresses other than proper names. Also see point


    The exception is named residential buildings and broad, sparsely populated areas, see point

  6. Residential complexes ─ blocks, individual buildings, and groups of buildings that are at least three stories high, usually share a common architectural plan, are fenced off from other buildings in the area, and have their own brand name.

  7. Territories of sports complexes (including ski trails, race tracks, and and athletic fields), recreation areas (resorts, country hotels), industrial parks, factory clusters, and active military cities that contain named passageways and addresses within the item itself.

For level-7 Blocks, enter the administrative division with the smallest territory (other than named territories) that completely encompasses that block. It is the center

If the administrative unit is not the administrative center, leave the default value in the field.: “No” (according to local laws, it is not an administrative center).

If the division in question is the administrative center, then select its hierarchical level from the list:

  • Countries — capital of the country.


    There can only be one locality with the “Center: country” attribute on the territory of a state.

  • Regions — administrative center of the region, province, territory or republic (see Section Parent division).
  • Regional district — the administrative center of the regional district, municipal district, urban district (see section3.2.2.3. Parent division). Is a city

If an administrative division of the “Locality” type is a city, then check the box in the City field. It is a municipality

Check the box in the Municipality field if an administrative division is a “municipality” that has its own address system (i.e. there are no independent official localities within its borders). These municipalities are the parent items for all elements with addresses on their territories (streets, blocks, farmsteads, neighborhoods, individual addresses).

Even though these municipalities are not officially localities, they should be assigned to the “Locality” hierarchy level.

For example, communes in France, quarters in Turkey, etc.

In other cases, do not check the box. Does not have an official status

Check the Has no official status box for administrative divisions of the following types:

  • “Locality”: gardening collectives, village cottages, rural settlements, standalone buildings, or groups of buildings that have proper names, as well as other individual localities that are not included in official localitiy databases.

    For example:

    • Gardening or dacha co-ops and all types of associations, gardening plots, and similar map items — Berezka Gardening Co-op, Rus Co-op

    • All cottage settlements — Ravissant Cottage Settlement

    • Free-standing homes groups of homes that have proper names; fishing villages in the Baltic States, cabins in the Extreme North and similar map items — Slavnoe Settlement, Mirnoe Ancestral Estate, Bovanenkovo Base Camp, 1038 Kilometer Home, 7031 Kilometer Railway Barracks

  • “Block”:

    • All residential complexes
    • blocks that are part of localities with the Has no official status option enabled

    For example: Vega Residential Complex, Parus Residential Complex.


Don't check the Has no official status box for any other administrative divisions.

This includes items of the “named territory” type: by definition these items already have no official status. Population

The term "population" refers to the number of registered inhabitants in a given locality or other administrative division. Use statistics published by state agencies or found on the official sites of local administrative entities to determine what the population of an area is.

Don't fill out the “Population” field for gardening co-ops, or rural (dacha) settlements that do not have permanent registered residents (or for which there is no data available).