From OpenStreetMap Wiki
(Redirected from Key:level:ref)
Jump to: navigation, search
Available languages — Key:level
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް
Public-images-osm logo.svg level
Osm element key.svg
Floor number of a feature Edit this description in the wiki page. Edit this description in the data item.
Group: Placement
Used on these elements
may be used on nodesmay be used on waysmay be used on areasshould not be used on relations
Useful combination
Status: in use

Level indicates the floor level, can be used for ways, shops and amenities that are tied to a floor level of a multilevel building. See Simple Indoor Tagging for further information.

Highways (and other ways) can be tagged with level when they are essentially bound to a level of a building complex (such as multilevel parking buildings, railway stations or airports).

For typical street and freeway crossings with bridges, layer=* should be used instead.

Roads or other ways passing through buildings should be marked with tunnel=building_passage; they should be only marked with level if there is a strong relation to the corresponding level of the building.


The value of the level=* is numerical and used to denote the vertical order of the floors. Usually, level=0 is the ground floor, level=1 the floor above it and basement floors start with level=-1.

Data users cannot assume that level=0 is always at street level. If the building uses a different floor numbering scheme, the floor at street level may have a different number. For example, in the United States, Russia, Japan and more countries, it is common to denote the first floor as the floor at street level.[1] However, data consumers relying on tagging standards such as Simple Indoor Tagging will expect level numbers to at least be consecutive (i.e. the level above 3 is 4, the level above -1 is 0). If that is not the case for a building, skipped_levels=* may be used on the building outline, or the levels can be tagged as level_ref=* instead (see #Level denominations).

There is also an ongoing discussion on usage of fractional values, e.g. level=0.5 or level=1.5 for mezzanine floors and staircases. See the proposals for more examples.

Level denominations

When a building uses non-numeric or otherwise non-standard floor denominations, as many malls do, it is easier to tag the individual shops on a floor with level:ref=* instead of level=*. For example, the Siam Paragon mall in Bangkok consists of the following floors: B,G,M,1,2,3,4,4A and 5[2]. A shop on level 4A can then be tagged with level:ref=4A .

Note though that when tagging shops exclusively with level:ref=*, the information about which floor is above which other is missing. To consolidate this information, the Simple Indoor Tagging scheme suggests to create an outline for each level, tagged with indoor=level, and add both level=* and level:ref=* to it. This also works the other way round - if only level=* is defined on the individual shops.

Multiple values

level range: level=-1;0 room=yes is a room which goes over (spans) two levels. It's the same room that is accessible on both levels. Often there are doors to each one. If a room is repeated on multiple levels, meaning it's a different room but it looks/functions identical, draw one element for each room or use repeat_on=*.

Similarly a staircase could be tagged with level=-1;0 meaning that it connects the two levels.

Maps rendering this tag

  • ITO World's Layers map renders the level tag mainly to show its incorrect usage on roads.

See also

  • There has been confusion about this part which has been cleared up in a mailing list discussion
  • Directory of Siam Paragon on their website