Help:Tagging

From OpenGeofiction
Jump to navigation Jump to search

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.

Territory information

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:gdp=* Only use numerical values with no comma separation and decimals offset by a period instead of a comma. Do not include currency symbols. Assume all are in a common international banking standard that is similar to measuring GDP in USD in the real-world. 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
OpenStreetMapW.svg key:language[2] language:official=* Can be used for multiple languages separated by semicolon. Index:Languages
language:regional=* Can be used for multiple languages separated by semicolon. Index:Languages
language:minority=* Can be used for multiple languages separated by semicolon. Index:Languages
OpenStreetMapW.svg Key:name name=* This tagging is used for the name of a territory or other entity as it appears on the map. This tag can be complemented by the use of OpenStreetMapW.svg key:official_name as needed, if the official or formal name is something more specific. Various pages
name:languageName=* For international names or names in other languages, OGF does not use two-letter codes for languages. To include the name of a territory in another language, you must use the full name as defined by consensus language names. For example, a territory called Zyxyz on the map may have additional tagging as name:ingerish=Ziks and name:plevian=Zeccia. Notice in this example how name:en and name:it are not used. Various pages
key:ogf ogf:admin_level=* Custom administrative tag for OGF areas (e.g. for area calculation), equivalent to admin_level for actual administrative units. This tag is to be used on relations in conjunction with at least: land_area=administrative, name=* and type=multipolygon. 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.
  2. OSM does not use the key language for countries or territories, as it is often with the parameter of what language is used in an institution as subkey (language:es=yes). Other subkeys exist on OSM: inscription, physician, teaching, worship. Our use of language here is to provide additional data about language usage within an administrative division.

Biographical information

The OGF map also supports the ability to have custom tagging to provide world-building information that can populate wiki tables. These tags are a little more particular in their usage, as they pertain to people, places, historical events, and other things that otherwise do always visibly show on the map. Usage of these tags should be restricted by notability. For example, a person with no historical impact should not have biographical information contained on the map itself. To get help constructing the tables for your wiki page, feel free to contact Alessa for assistance.

Key values Usage Subkey values Comment
key:bio For use on a single burial site, memorial, or monument to an individual. Do not contain the same biographical information on more than one object. Additionally, not all tags will be used for every individual. Locations:
bio:birthplace=*
bio:deathplace=*
Locations should be done using commas to separate from local to national. (E.g. Wahanta, Clamash, Federal States)
Dates:
bio:birthdate=*
bio:deathdate=*
No required format other than consistency in a territory. For approximate dates use decades or centuries by number (e.g. 1950s or 800s) and clarify in the note option.
Family:
bio:spouse=*
bio:children=*
Separate by commas if more than one in a category. Complex situations, such as multiple marriages and divorces, should be reserved for the wiki, using {{snapshot person}}.
Other parameters:
bio:occupation=*
bio:sex=*
bio:notes=*
Notes are be limited to 128 characters.

Businesses to be included on the international listing

International businesses of note that would like to appear in the international business listing can have specific OGF tags that populate the index page. These tags are a little more particular in their usage, and many are required to properly fill in the data. To include a business, there must be a node, way, or relation tagged as the headquarters. Then, the headquarters must be tagged with headquarters=main. This tagging is the required trigger for the Overpass query that pulls the data every hour. For generic use of the tag, headquarters=yes or headquarters=office should be used. All required tags listed below are needed to properly populate the listing.

Important: Do not tag objects on the map with headquarters=main unless it is supposed to appear on the international business listing.

Key and subkey values Subkey values
OpenStreetMapW.svg key:brand brand=* Required. This is the official branding of the corporation and is searchable in Overpass and what populates the table on the wiki. A headquarters building may be tagged as name=XYZ World Headquarters, but the brand is brand=XYZ. This branding can then be added to any additional object on the map, such as nodes for restaurants and shops. Multiple brands can be included on anything other than the headquarters on OGF with semicolon separation on OGF.
key:economy economy:iclass=* Required. Industry classification or brief description of products and services provided (e.g. "dairy" or "banking and insurance products").
economy:scope=* Required. A single-word description of the planned scope of the company (e.g. national, international, multinational, global).
economy:sector=* Required. Allowable parameters are primary, secondary, tertiary, and quaternary, based on a four-sector economic model.
  • Primary sector involves the retrieval and production of raw-material commodities, such as mining, fishing, and farming.
  • Secondary sector is the creation of goods from raw materials, such as manufacturing, construction, and textiles.
  • Tertiary sector includes services, such as banking, transportation, and shopkeeping (sales or stores).
  • Quaternary sector includes information generation and sharing, such as information technology, media, research and development, and education.
economy:type=* Required. A short description of the type of company (e.g. public, private, state-owned, etc.).
key:headquarters headquarters=main Required. Entries tagged with main will appear on the list, so do not use this tag for other things.
OpenStreetMapW.svg key:is_in is_in:city=*
is_in:country=*
Both are required. These fields should include the location of the headquarters. Even if the headquarters is outside a city, include the locality or nearest city.
OpenStreetMapW.svg key:name name=* Required
key:ogf ogf:logo=* Optional. List the file name for the logo on the wiki. Do not include brackets or File:.
ogf:permission=* Required. This tells users if they can use your business in their territory. Parameters are yes, ask, or no.