3.2.2. Rules for adding attributes to administrative divisions

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

Rules for adding attributes to items are found below:

3.2.2.1. 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. CountryLevel 2. RegionLevel 3. District
RussiaRegion, republic, province, autonomous territory, autonomous region, federal cityDistrict, city region
USAStateArea
GermanyStateArea
SpainAutonomous regionProvince
ChinaProvince, autonomous district, city municipalitiesCounty
IndiaState, federal territoryArea, district
BrazilStateMunicipality
AustraliaState, territoryCounty
PolandProvinceMunicipality
EgyptGovernorateMunicipality
IndonesiaProvinceRegion
BelarusRegionDistrict
TurkmenistanCountyDistrict
GeorgiaProvince, autonomous republicDistrict
Note.

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 3.2.2.3. Parent division.

3.2.2.2. Name

For information on entering names, see sections 3.1.3.1. Name types: general rules and 3.1.3.2. 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:

3.2.2.2.1 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.

You can read the rules for writing names of this type in section 3.1.3.1.1. Official.

3.2.2.2.2. For caption on map

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

You can read the rules for writing names of this type in section 3.1.3.1.2. For caption on 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 names itself (without the type) is not sufficient to identify the item.

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

3.2.2.2.3. Previously called

See section 3.1.3.1.5. Previously called.

3.2.2.2.4. Also known as, historical

See section 3.1.3.1.6. Also known as, historical.

3.2.2.2.5. The address contains

Enter this name for administrative divisions if their address names differs from their official names. See also section 3.1.3.1.3. The address contains.

3.2.2.3. Parent division

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.

Because of this, the position of the administrative division in the hierarchy is not wholly determined by the value of attribute 3.2.2.1. Type (level): the same hierarchy level may have divisions with different attribute values (and vice verse, the same type of division may belong to different hierarchy levels).

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 3.2.2.3.7).

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

3.2.2.3.1. 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.

3.2.2.3.2. Region (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.
3.2.2.3.3. District (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).

3.2.2.3.4. 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).

Note.

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.

3.2.2.3.5. City district (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.

3.2.2.3.6. 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. Former localities that were previously inhabited but have since been deserted.

    These items are represented using placemarks (not polygons).

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.

3.2.2.3.7. 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 3.2.1.4.5.

    Note.

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

  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.

3.2.2.4. Center

If an administrative division is not the center, leave the answer that's entered by default in that field: “No”: in accordance with local legislation, the division in question is not the administrative center).

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

  • Countries — capital of the country.

    Note.

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

  • Regions — the administrative center of a region, province, or republic (see section 3.2.2.3. Parent division).
  • District — the administrative center of a district, municipal district, or city region (see section 3.2.2.3. Parent division).

3.2.2.5. City

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

3.2.2.6. 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.

3.2.2.7. Doesn't have an official status

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

  • “Locality”: gardening collective, dachas (village homes), rural settlements, free-standing homes or groups of homes that have proper names, other individual localities that are not included in official registers of localities.

    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.

    For example: Vega Residential Complex, Parus Residential Complex.

Attention.

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.

3.2.2.8. 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).