Help:Tagging

In terms of tag usage (keys and values), OpenGeofiction attempts to stick to the standards and best practices as extensively documented on the File: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 File:OpenStreetMapW.svg map features and File: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.

• admin_level
• highway
• place

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
File: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.
	economy:hdi=*	Any numerical value between 0 and 1 is permissible.
	economy:note=*	Custom description that may be used to describe elements of the economic ideology but is limited to 64 characters.
File: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	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.
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.
	history:revolution=*	Year of current governance structure, whether it be by new constitution or revolution.
File: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
File:OpenStreetMapW.svg key:language	language:official=*	Can be used for multiple languages separated by semicolon.	Index:Languages
	language:regional=*	Can be used for multiple languages separated by semicolon.
	language:minority=*	Can be used for multiple languages separated by semicolon.
File: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 File: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
	organization:ASUN=*	Association of South Ulethan Nations membership status, with possible parameters member, observer, and partner
	organization:EUOIA=*	East Ulethan Organization of Intergovernmental Associates membership status, with possible parameters member and observer
	organization:EgU=*	Egalian Union membership status, with possible parameters member and observer
	organization:IC=*	Ingerish Commonwealth membership status, with possible parameters member and observer
	organization:HU=*	Hetzer Union membership status, with possible parameters member and observer
	organization:TCC=*	Tarephia Cooperation Council membership status, with possible parameters member and observer
File: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).
File: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.
	timezone:dst=*	Parameters are simply yes and no. Definitions may be defined in the timezone note.
	timezone:note=*	Comment used for display on popup when clicking the map. Will be capped at 50 characters.

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
File: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.
File: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.
File: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.

Aviation tagging

Important: The main territory relation, which the airport or airline HQ is located within, is also used in the construction of these lists. Only "canon" territories are considered (collab, owned, archived). The #Territory information section above should be consulted to ensure this relation is well constructed, especially the ogf:wiki field.

Gobras Worldport (airport), Khaiwoon International Airport, Gobrassian Airlines and Air Khaiwoon can be used as examples for the tagging below.

Airports

For airports to appear in the airports listing they must be well mapped and use some OGF-specific tagging. This tagging is the required trigger for the Overpass query that pulls the data every hour. All required tags listed below are needed to properly populate the listing.

Key/tag		Subkeys
File:OpenStreetMapW.svg aeroway=aerodrome	ref=???	Required. A closed way or relation must be tagged with aeroway=aerodrome, with a unique three character code specified in the ref (preferred) or iata tags. Be sure to not use an already allocated code - check the list at Index:Aviation#Airports first. Where there are duplicates mappers should talk with each other to sort this out. As a general rule, the mapper who first used the code (look at the way/relation history) has priority.
	int_name=* name=*	Required. The name of the airport should be specified using the int_name (for international audience) or name tags.
	serves=* description=*	Optional. The city, or regional area served by the airport should be noted using serves and description can be used to supply additional information (max 100 characters).
	aerodrome:type=*	Optional. The type, or class, of the airport is specified using aerodrome:type. The following three values will result in inclusion in the list: global: Global gateways that have a handful of flights longer than 3000km; only one per country with total population 5–15 million, only two per country with total population 15–30 million, and three or more for countries with a total population greater than 30 million. Countries with less than 5 million people should not include a global airport. international: International airports. regional (default if not specified) Domestic airports without regularly-manned customs facilities. However, any of the following entries will result in the airport being explicitly excluded from the list: public, gliding, airfield, private, military/public, ormilitary
File:OpenStreetMapW.svg aeroway=runway	ref=* length=* width=* surface=*	Required. One or more runways must be mapped as an unclosed way within the aerodrome boundary. Values as per standard OSM usage, with length and width in metres. ref must be present and File:OpenStreetMapW.svg well formed.
File:OpenStreetMapW.svg aeroway=terminal	name=* ref=*	Required. One or more terminals must be mapped within the aerodrome boundary. Either name or ref must be present.
File:OpenStreetMapW.svg aeroway=gate		Optional. Gates may be mapped as nodes adjacent to terminal, within the aerodrome boundary

Airlines

For airline routes to be mapped the headquarters of the airline must first be mapped, this uses the same tagging scheme as #Businesses to be included on the international listing, with the addition of ref.

Key and subkey values		Subkey values
File:OpenStreetMapW.svg key:brand	brand=*	Required. This is the official branding of the airline and is searchable in Overpass and what populates the table on the wiki. A headquarters building may be tagged as name=AirXYZ World Headquarters, but the brand is brand=AirXYZ.
key:economy	economy:iclass=airline	Required.
	economy:scope=*	Required. A single-word description of the planned scope of the company (e.g. national, international, multinational, global).
	economy:sector=tertiary	Required.
	economy:type=*	Required. A short description of the type of company (e.g. public, private, state-owned, etc.).
key:headquarters	headquarters=main	Required.
File:OpenStreetMapW.svg key:is_in	is_in:city=*	Required. The city the headquarters are located within. If the headquarters is outside a city, include the locality or nearest city.
File:OpenStreetMapW.svg key:name	name=*	Required
File:OpenStreetMapW.svg key:ref	ref=*	Required, two character alphanumeric ID for the airline.
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 airline in their territory. Parameters are yes, ask, or no.
File:OpenStreetMapW.svg key:description	description=*	Optional. Brief description.
File:OpenStreetMapW.svg key:colour	colour=#RRGGBB	Optional. Used to indicate the official colour of the airline, for use on the route map. A Web RGB colour code (hex triplet), e.g. #FF0000 for red, should be used.

Airline routes

Airline routes are described by adding entries into the source and destination airports. The permission values for the airport and airlines should be respected, and routes are only extracted for canon territories.

The ↦ measurement tool in the scale helper can be used to visualise great circle path and distance between two points. Ensure distances are realistic and avoid creating Empires in the Sky - see also the guidelines under aeroway=aerodrome in the #Airports section above.

Key/tag		Subkeys
File:OpenStreetMapW.svg aeroway=aerodrome	destination:XX=*	Required. There should be a destination:XX=* for each airline which serves the airport, with the XX being replaced by the unique 2 character airline code. The value should be a semicolon ; separated list of the three character airport codes flown to by this airline from this airport.
	airline:XX=*	Optional. Is this airport a hub or focus city for airline XX.