Help:Tagging: Difference between revisions

From OpenGeofiction
Jump to navigation Jump to search
(trim)
mNo edit summary
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
In terms of tag usage (keys and values), OGF attempts to stick to the standards and best practices as extensively documented on the [[http://wiki.openstreetmap.org/wiki/Main_Page OSM wiki]]. Below, however we discuss some aspects of tagging that provide additional clarification for use in OpenGeofiction.
In terms of '''tag usage''' (keys and values), [[OpenGeofiction:About|OpenGeofiction]] attempts to stick to the standards and best practices as extensively documented on the {{OSMW|Main_Page|OpenStreetMap wiki}}. Users are encouraged to consult the wiki for the most up-to-date tagging practices and to understand how things render on the map. There are extensive discussions of {{OSMW|Map_Features|map features}} and {{OSMW|How_to_map_a|how to map various elements}}.


The tagging is documented in the OpenStreetMap-Wiki, see [http://wiki.openstreetmap.org/wiki/Map_Features English]|[http://wiki.openstreetmap.org/wiki/DE:Map_Features German]|[http://wiki.openstreetmap.org/wiki/FR:Map_Features French], this German [http://wiki.openstreetmap.org/wiki/DE:How_to_map_a How to map a ...] page is very useful, too.
OpenGeofiction uses some custom tagging, however, as a means of administrating the site and for further world-building. Below, we discuss some aspects of tagging that provide additional clarification for use in OpenGeofiction.


= Special OGF tags =
==Country-specific Tagging==
OpenGeoFiction represents physical features on the ground [https://wiki.openstreetmap.org/wiki/Map_Features using standard OSM tags] attached to its basic data structures: nodes, ways and relations.
Even on OpenStreetMap, there are varying standards for how things such as administrative boundaries, highways, and railroads are mapped depending on region or individual country. Similarly, different territories on OpenGeofiction also feature different definitions for what is rendered. For example, a way tagged <code>highway=tertiary</code> in one territory may have very different attributes from one in another. Here are a collection of tags and how they are defined by the mappers of various territories.
However, in some cases, OGF might use its own tags to make situations more clear or to simplify maintenance.
These tags are listed here.


== Confirmed by the admin team ==
*To assign territory information (only relation)
:'''"type" = "boundary" + "boundary" = "administrative" + "ogf:id" = ''VALUE'''''
= Country-specific Tagging =
Certain tags in the OSM database, especially those related to territory administration, but also things like highways or railways, are not really held to specific standards in OSM, but rather vary from country to country.
Thus it can be hard to know what standard to apply when we create our countries in OGF, too. Below is a collection of some of these problematic tags, with values being used in some of our OGF countries by various mappers.
=== Keys with OGF-specific usages ===
* ''[[Help:Tagging/admin_level|admin_level]]''
* ''[[Help:Tagging/admin_level|admin_level]]''
* ''[[Help:Tagging/highway|highway]]''
* ''[[Help:Tagging/place|place]]''
* ''[[Help:Tagging/place|place]]''
* ''[[Help:Tagging/highway|highway]]''
* ''... etc.''
{{Incomplete list}}
= Rendering =
Below we have attempted to document the real rendering based on tagging in different situations for OGF in the standard-style. In each case, if a given zoom-level is stated, the same rendering result is seen at higher zoom-levels unless otherwise stated.
The items are tested, but there may be errors. If you see one, please correct it here or mention on the [[Help_talk:Tagging|discussion-page]].
{{Incomplete list}}
=== Beach, desert, heath and sand ===
this simple tags for areas without plants (or only few) as  '''natural = beach''' or '''desert''' or '''heath''' or '''sand''' (all visible beginning at level 10) shows
* beach = light yellow area with black point-raster
* desert = light brown area
* heath = light oliv area
* sand = plain yellow area
=== Cemeteries ===
Cemeteries global are visible at zoom 10 as darker green area
*  '''landuse = cemetery'''  = shows at zoom 14 ("500 m") a darker green area with gravestones
*  '''landuse = cemetery'''  and  '''religion = jewish'''  = at zoom 14 a darker green area with the jewish hexagon ("David star")
*  '''landuse = cemetery'''  and  '''religion = christian'''  = at zoom 14 a darker green area with cross
* 2nd or 3rd tag as  '''name = Xyz'''  = is shown at zoom 15 ("300 m")
=== Green grass ===
If you tag  '''landuse = meadow, landuse = grass, leisure = common, leisure = garden, landuse = recreation_ground, landuse = conservation'''  or  '''landuse = village_green'''  = in all this cases you see a light green area (colour #cfeca8). Even if the Podlatch2-editor shows at your editing grey or different green areas, the renderer make his light green, visible at zoom 10.


If you tag '''leisure = recreation_ground''', (instead of landuse = recreation_ground) then the area is not in the green of grass, but in the same darker variante as '''leisure = park'''. If you tag '''natural = grassland''', you get an area in the colour between the green of grass and and the green of park. Both tags are visible at zoom 10 as the others.
==Special OGF tags==
Unlike OpenStreetMap, OpenGeoFiction does not represent a real, physical world; the needs of the site are different. Thus, OpenGeofiction features a collection of additional site-exclusive tags to help facilitate the site's administration and to help users with collaborative world-building. Please note that these tags are ''extensions'' of OpenStreetMap tagging and are ''only designed to be used on OpenGeofiction''.


The tag '''natural = scrub''' makes the next variante of a green, a little bit darker as park, but lighter as the rendering for woods. Visible at zoom 10 too.
Please note that the tags <code>is_in:continent=*</code> and <code>ogf:id=*</code> '''must''' be included on every territory relation for administrative purposes. Do not remove or change the values of these tags without first having [[OpenGeofiction:Admin team|admin]] approval.


=== Military ===
{| class="wikitable unsortable" style="background: #f9f9ff;"
* '''landuse = military''' = a red striped area at zoom 10
|-
* '''military = barracks''' = a darker red area at zoom 10 - can set alone
! colspan="2" | Key and tag values
*   '''military = danger_area''' = alone drawn you see nothing, inside of ''landuse = military'' this area has a darker red at zoom 10 as the normal military landuse
! Comment
! Map type and page
|-
! style="background: #ddeeff;" | {{OSMW|Key:driving_side|<code>key:driving_side</code>}}
| <code>driving_side=*</code>
| May be added to the territory relation or individual highways to highlight the territory's primary driving side. Permissible parameters:
*Left
*Mixed
*Right
| [[Index:Driving side]]
|-
! rowspan="3" style="background: #ddeeff;" | <code>key:economy</code>
| <code>economy=*</code>
| Parameters are defined here as numerical values. If your territory does not fit cleanly into a specific model, please use one of the multiples of ten for generic or broad definitions.
*20 (Traditional economy, broadly or generically speaking)
*21 (Barter economy)
*22 (Subsistence economy)
*23 (Other currency-less economy)
*30 (Planned economy, broadly or generically speaking)
*31 (Decentralized planned economy)
*32 (Corporatist planned economy)
*33 (Distributist planned economy)
*34 (Participatory planned economy/akin to "Dutch 'polder' model")
*35 (Command planned economy, e.g. "Soviet model")
*40 (Market economy, broadly or generically speaking)
*41 (''Laissez-faire'' or free-market capitalist economy)
*42 (Corporate capitalist market economy)
*44 (Mercantilism)
*45 (Socialist market economy)
*46 (Market feudal economy)
*50 (Mixed economy, broadly or generically speaking)
*51 (Mixed-market economy, e.g. "American model")
*52 (Social market economy, e.g. "Rhenish model")
*53 (Welfare capitalist economy, e.g. "Nordic model")
*54 (State-driven investment economy, e.g. "East Asian model")
*55 (Dirigist economy, e.g. "French model")
*56 (Mixed feudal economy)
*60 (Religious economy, broadly or generically speaking)
*90 (Other economic systems)
| [[Index:World economics]]
|-
| <code>economy:hdi=*</code>
| Any numerical value between 0 and 1 is permissible.
| [[Index:World economics]]
|-
| <code>economy:note=*</code>
| Custom description that may be used to describe elements of the economic ideology but is limited to 64 characters.
| [[Index:World economics]]
|-
! style="background: #ddeeff;" | {{OSMW|Key:gauge|<code>key:gauge</code>}}
| <code>gauge=*</code>
| Although OSM only uses it to tag individual rail lines, it may be added to the territory relation on OGF to highlight national standards. Values that map are presently limited to 1000, 1067, 1435, 1520, 1600, 1668, 1676, and other. Additional values may be added later should demand warrant.
| [[Index:Rail transport]]
|-
! rowspan="2" style="background: #ddeeff;" | <code>key:governance</code><ref>Not to be confused with {{OSMW|key:government|the government key in use for other things}}.</ref>
| <code>governance=*</code>
| Parameters are defined here as numerical values. If your territory does not fit cleanly into a specific model, please use one of the multiples of ten for generic or broad definitions.
*20 (Direct democracy, broadly defined)
*21 (Full presidential democracy)
*22 (Semi-presidential or dual-elective democracy)
*30 (Republic, broadly defined)
*31 (Full presidential democratic republic)
*32 (Semi-presidential republic)
*33 (Parliamentary republic with largely ceremonial head-of-state)
*34 (Parliamentary republic with dependent presidency)
*35 (Religious republic)
*36 (Merchant republic)
*40 (Monarchy or autocracy, broadly defined)
*41 (Parliamentary constitutional monarchies with strong monarch)
*43 (Parliamentary constitutional monarchies with weak or ceremonial monarch)
*45 (Religious autocracy such as bishoprics, caliphates, etc.)
*46 (Diumvirate or triumvirate)
*49 (Dictatorship)
*50 (Aristocracy, broadly defined)
*53 (Parliamentary aristocracy)
*55 (Theocratic rule)
*56 (Feudal aristocracy)
*57 (Oligarchy)
*58 (One-party state)
*59 (Military junta)
*60 (Tribal confederation, broadly defined)
*61 (Chiefdom)
*90 (Other or undefined)
| [[Index:Government]]
|-
| <code>governance:structure=*</code>
| Parameters defined as <code>decentralized</code>, <code>federation</code>, and <code>unitary</code>.
| [[Index:Government]]
|-
! rowspan="3" style="background: #ddeeff;" | <code>key:history</code>
| <code>history:established=*</code>
| Year of establishment, founding, or independence. Must be strictly a single numerical value without symbols or other text.
| [[Index:World history]]
|-
| <code>history:independence_from=*</code>
| List territory from whom it gained independence.
| [[Index:World history]]
|-
| <code>history:revolution=*</code>
| Year of current governance structure, whether it be by new constitution or revolution.
| [[Index:World history]]
|-
! style="background: #ddeeff;" | {{OSMW|Key:is_in|<code>key:is_in</code>}}
| <code>is_in:continent=*</code>
| Permissible parameters: Antarephia, Beginner, East Uletha, Ereva, Kartumia, North Archanta, Orano, Pelanesia, South Archanta, Tarephia, West Uletha. '''Please do not remove or alter.'''
| Various administrative pages
|-
! rowspan="3" style="background: #ddeeff;" | <code>key:ogf</code>
| <code>ogf:area=*</code>
| Custom administrative tag for OGF areas. '''Please do not remove or alter.'''
| Various administrative pages
|-
| <code>ogf:id=*</code>
| Custom tag for OGF territorial identifications. '''Please do not remove or alter.'''
| Various administrative pages
|-
| <code>ogf:wiki=*</code>
| Custom tag for linking to wiki page. Please only include the wiki article name for the territory (e.g. <code>ogf:wiki=Plevia</code>).
| Most multimap pages
|-
! rowspan="6" style="background: #ddeeff;" | <code>key:organization</code>
| <code>organization:AN=*</code>
| [[Assembly of Nations]] membership status, with possible parameters <code>member</code> and <code>no</code>
| [[Index:Intergovernmental organizations]]
|-
| <code>organization:AC=*</code>
| [[Antarephian Coalition]] membership status, with possible parameters <code>member</code> and <code>observer</code>
| [[Index:Intergovernmental organizations]]
|-
| <code>organization:ASUN=*</code>
| [[Association of South Ulethan Nations]] membership status, with possible parameters <code>member</code>, <code>observer</code>, and <code>partner</code>
| [[Index:Intergovernmental organizations]]
|-
| <code>organization:Egalia=*</code>
| [[Egalian Union]] membership status, with possible parameters <code>member</code> and <code>observer</code>
| [[Index:Intergovernmental organizations]]
|-
| <code>organization:IC=*</code>
| [[Ingerish Commonwealth]] membership status, with possible parameters <code>member</code> and <code>observer</code>
| [[Index:Intergovernmental organizations]]
|-
| <code>organization:TCC=*</code>
| [[Tarephia Cooperation Council]] membership status, with possible parameters <code>member</code> and <code>observer</code>
| [[Index:Intergovernmental organizations]]
|-
! rowspan="2" style="background: #ddeeff;" | {{OSMW|Key:power_supply|<code>key:power_supply</code>}}
| <code>power_supply:frequency=*</code>
| Frequency of the common residential utility power in Hertz (Hz). The two used in the real world are 50 and 60.
| [[Index:Mains electricity]]
|-
| <code>power_supply:voltage=*</code>
| Voltage of the common residential utility power in volts (V).
| [[Index:Mains electricity]]
|-
! rowspan="4" style="background: #ddeeff;" | {{OSMW|Key:timezone|<code>key:timezone</code>}}
| <code>timezone=+hh</code>
| Used for any whole number between -12 and 12. Zero needs a plus (+). Each whole number would display a consistent time, with four or six colors being possible and rotating through for ease of style sheet.
| [[Index:Time zones]]
|-
| <code>timezone=+hh:mm</code>
| Used for any offset time zone. One standardized color for all (bulk "other" category) just to show that it is different from hour-based time zones.
| [[Index:Time zones]]
|-
| <code>timezone:dst=*</code>
| Parameters are simply <code>yes</code> and <code>no</code>. Definitions may be defined in the timezone note.
| [[Index:Time zones]]
|-
| <code>timezone:note=*</code>
| Comment used for display on popup when clicking the map. Will be capped at 50 characters.
| [[Index:Time zones]]
|-
| colspan="4" | <references />
|}


=== Motorway in construction ===
[[Category:Help pages]]
Motorways in construction you can see at zoom-level 12 ("3 km"). Therefore both tags are necessary : '''highway = construction''' and '''construction = motorway'''. With the construction-tag other roads as motorways can shown too.

Revision as of 22:44, 25 May 2022

In terms of tag usage (keys and values), OpenGeofiction attempts to stick to the standards and best practices as extensively documented on the OpenStreetMapW.svg OpenStreetMap wiki. Users are encouraged to consult the wiki for the most up-to-date tagging practices and to understand how things render on the map. There are extensive discussions of OpenStreetMapW.svg map features and OpenStreetMapW.svg how to map various elements.

OpenGeofiction uses some custom tagging, however, as a means of administrating the site and for further world-building. Below, we discuss some aspects of tagging that provide additional clarification for use in OpenGeofiction.

Country-specific Tagging

Even on OpenStreetMap, there are varying standards for how things such as administrative boundaries, highways, and railroads are mapped depending on region or individual country. Similarly, different territories on OpenGeofiction also feature different definitions for what is rendered. For example, a way tagged highway=tertiary in one territory may have very different attributes from one in another. Here are a collection of tags and how they are defined by the mappers of various territories.

Special OGF tags

Unlike OpenStreetMap, OpenGeoFiction does not represent a real, physical world; the needs of the site are different. Thus, OpenGeofiction features a collection of additional site-exclusive tags to help facilitate the site's administration and to help users with collaborative world-building. Please note that these tags are extensions of OpenStreetMap tagging and are only designed to be used on OpenGeofiction.

Please note that the tags is_in:continent=* and ogf:id=* must be included on every territory relation for administrative purposes. Do not remove or change the values of these tags without first having admin approval.

Key and tag values Comment Map type and page
OpenStreetMapW.svg key:driving_side driving_side=* May be added to the territory relation or individual highways to highlight the territory's primary driving side. Permissible parameters:
  • Left
  • Mixed
  • Right
 Index:Driving side
key:economy economy=* Parameters are defined here as numerical values. If your territory does not fit cleanly into a specific model, please use one of the multiples of ten for generic or broad definitions.
  • 20 (Traditional economy, broadly or generically speaking)
  • 21 (Barter economy)
  • 22 (Subsistence economy)
  • 23 (Other currency-less economy)
  • 30 (Planned economy, broadly or generically speaking)
  • 31 (Decentralized planned economy)
  • 32 (Corporatist planned economy)
  • 33 (Distributist planned economy)
  • 34 (Participatory planned economy/akin to "Dutch 'polder' model")
  • 35 (Command planned economy, e.g. "Soviet model")
  • 40 (Market economy, broadly or generically speaking)
  • 41 (Laissez-faire or free-market capitalist economy)
  • 42 (Corporate capitalist market economy)
  • 44 (Mercantilism)
  • 45 (Socialist market economy)
  • 46 (Market feudal economy)
  • 50 (Mixed economy, broadly or generically speaking)
  • 51 (Mixed-market economy, e.g. "American model")
  • 52 (Social market economy, e.g. "Rhenish model")
  • 53 (Welfare capitalist economy, e.g. "Nordic model")
  • 54 (State-driven investment economy, e.g. "East Asian model")
  • 55 (Dirigist economy, e.g. "French model")
  • 56 (Mixed feudal economy)
  • 60 (Religious economy, broadly or generically speaking)
  • 90 (Other economic systems)
 Index:World economics
economy:hdi=* Any numerical value between 0 and 1 is permissible. Index:World economics
economy:note=* Custom description that may be used to describe elements of the economic ideology but is limited to 64 characters. Index:World economics
OpenStreetMapW.svg key:gauge gauge=* Although OSM only uses it to tag individual rail lines, it may be added to the territory relation on OGF to highlight national standards. Values that map are presently limited to 1000, 1067, 1435, 1520, 1600, 1668, 1676, and other. Additional values may be added later should demand warrant. Index:Rail transport
key:governance[1] governance=* Parameters are defined here as numerical values. If your territory does not fit cleanly into a specific model, please use one of the multiples of ten for generic or broad definitions.
  • 20 (Direct democracy, broadly defined)
  • 21 (Full presidential democracy)
  • 22 (Semi-presidential or dual-elective democracy)
  • 30 (Republic, broadly defined)
  • 31 (Full presidential democratic republic)
  • 32 (Semi-presidential republic)
  • 33 (Parliamentary republic with largely ceremonial head-of-state)
  • 34 (Parliamentary republic with dependent presidency)
  • 35 (Religious republic)
  • 36 (Merchant republic)
  • 40 (Monarchy or autocracy, broadly defined)
  • 41 (Parliamentary constitutional monarchies with strong monarch)
  • 43 (Parliamentary constitutional monarchies with weak or ceremonial monarch)
  • 45 (Religious autocracy such as bishoprics, caliphates, etc.)
  • 46 (Diumvirate or triumvirate)
  • 49 (Dictatorship)
  • 50 (Aristocracy, broadly defined)
  • 53 (Parliamentary aristocracy)
  • 55 (Theocratic rule)
  • 56 (Feudal aristocracy)
  • 57 (Oligarchy)
  • 58 (One-party state)
  • 59 (Military junta)
  • 60 (Tribal confederation, broadly defined)
  • 61 (Chiefdom)
  • 90 (Other or undefined)
 Index:Government
governance:structure=* Parameters defined as decentralized, federation, and unitary. Index:Government
key:history history:established=* Year of establishment, founding, or independence. Must be strictly a single numerical value without symbols or other text. Index:World history
history:independence_from=* List territory from whom it gained independence. Index:World history
history:revolution=* Year of current governance structure, whether it be by new constitution or revolution. Index:World history
OpenStreetMapW.svg key:is_in is_in:continent=* Permissible parameters: Antarephia, Beginner, East Uletha, Ereva, Kartumia, North Archanta, Orano, Pelanesia, South Archanta, Tarephia, West Uletha. Please do not remove or alter. Various administrative pages
key:ogf ogf:area=* Custom administrative tag for OGF areas. Please do not remove or alter. Various administrative pages
ogf:id=* Custom tag for OGF territorial identifications. Please do not remove or alter. Various administrative pages
ogf:wiki=* Custom tag for linking to wiki page. Please only include the wiki article name for the territory (e.g. ogf:wiki=Plevia). Most multimap pages
key:organization organization:AN=* Assembly of Nations membership status, with possible parameters member and no Index:Intergovernmental organizations
organization:AC=* Antarephian Coalition membership status, with possible parameters member and observer Index:Intergovernmental organizations
organization:ASUN=* Association of South Ulethan Nations membership status, with possible parameters member, observer, and partner Index:Intergovernmental organizations
organization:Egalia=* Egalian Union membership status, with possible parameters member and observer Index:Intergovernmental organizations
organization:IC=* Ingerish Commonwealth membership status, with possible parameters member and observer Index:Intergovernmental organizations
organization:TCC=* Tarephia Cooperation Council membership status, with possible parameters member and observer Index:Intergovernmental organizations
OpenStreetMapW.svg key:power_supply power_supply:frequency=* Frequency of the common residential utility power in Hertz (Hz). The two used in the real world are 50 and 60. Index:Mains electricity
power_supply:voltage=* Voltage of the common residential utility power in volts (V). Index:Mains electricity
OpenStreetMapW.svg key:timezone timezone=+hh Used for any whole number between -12 and 12. Zero needs a plus (+). Each whole number would display a consistent time, with four or six colors being possible and rotating through for ease of style sheet. Index:Time zones
timezone=+hh:mm Used for any offset time zone. One standardized color for all (bulk "other" category) just to show that it is different from hour-based time zones. Index:Time zones
timezone:dst=* Parameters are simply yes and no. Definitions may be defined in the timezone note. Index:Time zones
timezone:note=* Comment used for display on popup when clicking the map. Will be capped at 50 characters. Index:Time zones
  1. ↑ Not to be confused with OpenStreetMapW.svg the government key in use for other things.
Retrieved from "https://wiki.opengeofiction.net/index.php?title=Help:Tagging&oldid=8881"