Proposed features/Destination details
|Additional subkeys for the destination key|
|Tagging:||destination:ref, destination:symbol, destination:country, destination:lang=*|
|Definition:||Additional subkeys to the established key destination=* to provide further details|
|This proposal is currently set to "inactive" because no further discussion is going on. Nevertheless, all keys proposed here are in widespread use.|
Currently the key destination=* describes the direction of the highway by using the name of the city the highway is heading to. Additional sub-keys should be introduced to provide further information like the reference of the road ahead, the country the road is heading to or a special symbol like for an airport.
- 1 Rationale
- 2 Tagging
- 3 Examples
- 4 Common questions
- 5 Comments
- 6 See also
In order to present accurate and precise instructions, a navigational device needs information about the road it should lead the driver to. The established key destination=* only describes the name of a city or place.
The photo on the right shows a typical signpost on a motorway. Beside the name of major cities it also displays:
- the reference of the roads: A5, S1 and A2
- the countries the roads are heading to: CZ, SK, H, SLO, I
- a symbol of an aeroplane, identifying the road which is leading to the nearest airport
Just like the key destination=*, all sub-keys should be put on the first way after the junction. On the way before the junction those keys should (additionally!) only be used if their values are lane-dependent, and then the suffix :lanes has to be added.
All the sub-keys should only be used to specify information that can be seen on signposts, road markings or similar.
The key destination:ref=* should be used to specify the reference of the roads directly ahead as indicated on signposts, road markings or similar. The value of this key should be equal to the value of the key ref=* of these roads.
The key destination:ref:lanes=* (or destination:ref:lanes:forward=* and destination:ref:lanes:backward=*) should be used to specify the reference of the lanes directly ahead as indicated on signposts, road markings or similar. The value of this key should be equal to the value of the key ref=* these lanes lead to.
The key destination:ref:to=* should be used to specify the reference of a major highway ahead, as indicated on signposts, road markings or similar. This is a common practice in the United States on motorway destination signs, see . The value of this key should NOT be equal to the value of the key ref=* of these roads, because a destination:ref:to=*'s reference road will never directly connect to the slip road indicated on the sign; it is provided as a means of navigational assistance to the driver.
The key destination:int_ref=* should be used to specify the international reference of the roads ahead ahead as indicated on signposts, road markings or similar. The value of this key should be equal to the value of the key int_ref=* of these roads.
The key destination:symbol=* should be used to indicate that a special symbol/icon is present on a signpost, visible as road marking or similar.
|Tag||Symbol examples||United States||Canada||France||Leading to|
|destination:symbol=aerialway||a skylift, aerialway, or overhead tramway|
|destination:symbol=centre||the centre of the city|
|destination:symbol=info||information services or tourist information|
|destination:symbol=car_shuttle_train||a station for a Car shuttle train|
|destination:symbol=railroad_freight_terminal||a railroad freight terminal for trucks, where trucks (or only their freight containers) are loaded onto/unloaded from a train|
|destination:symbol=train_station||a train station for passenger traffic|
|destination:symbol=subway||a subway / tram / lightrail station|
|destination:symbol=interchange||a motorway interchange|
|destination:symbol=food||a restaurant or food services|
|destination:symbol=fuel||a general fuel station|
|destination:symbol=fuel_cng||a fuel station that offers CNG|
|destination:symbol=fuel_diesel||a fuel station that offers diesel|
|destination:symbol=fuel_e85||a fuel station that offers E85|
|destination:symbol=fuel_ev||a fuel station that offers EV|
|destination:symbol=parking||a (significant) parking space|
|destination:symbol=parking_truck||a truck parking area|
|destination:symbol=covered_parking||a (significant) covered parking space|
|destination:symbol=park_and_ride||a park and ride space|
|destination:symbol=phone||a public payphone|
|destination:symbol=police||a police station|
|destination:symbol=industrial||a industrial area or business park|
|destination:symbol=ferry||a pier for ferries|
|destination:symbol=soccer_stadium||a soccer stadium|
|destination:symbol=TDD||a TDD (Telecommunication Device for the Deaf)|
|destination:symbol=wifi||a public wifi spot|
|more to come...|
In some countries the names of cities are written in more than one language. The name(s) in the official language should be put into the destination=*. Those in different languages should be put into destination:lang:<language code>=*. Possible values for language code are - as usually - ISO 639.1 codes.
In many countries with non-Latin alphabet names are sometimes shown in Latin alphabet additionally. In such case the actual language of the name written in Latin may not be clear. It is recommended to choose the most widely used language in the world, in which the name is written exactly as shown on the signpost; in many cases this will be English (language code: en).
If a signpost contains a street name, use this tag.
If the street is displayed in multiple languages, use a language qualifier as described in the header Consider this example:
The destination tagging for this signpost would be:
- destination:street:fr=Rue Regent Sud
- destination:street:en=Regent Street South
- destination:ref=101 South
- destination=New Maryland
It is not yet settled whether destination:street:fr=* or destination:street:lang:fr=* should be used. On the Canadian mailing list the first one was proposed, but the latter fits better to existing tags (e.g. destination:lang:fr=* and avoids ambiguities (Is ':to' a language name or not?)
|On this sign the cities the road is heading to are written in two different languages.|
|This sign also contains the country the road is heading to.|
|A symbol for the centre of the city is present.|
|A symbol for the ferry to England is present.|
|A symbol for the industrial zone is present.|
|destination=Bodegraven;Alphen a/d Rijn;Leiden
|Symbols for the parking, fuel, restaurant and hotel are present.|
|The word 'Randweg' (bypass) is part of the destination:ref tagging.|
|Symbols for the hospital and the industrial zone are present.|
|Symbols for the soccer stadium and the industrial zone are present.|
|destination=Centraal Station;Rotterdam (A4);Utrecht;Amsterdam (A4)
|A symbol for the covered parking is present.|
|For the "left" road:
|A symbol for the next motorway is present.|
|The following example is based on the lanes-extension and should be used before the junction.|
|A symbol for the park & ride is present.|
|Alternative tagging for (near) photorealistic view of signposts using different tags. Please comment on this.|
|A symbol for the commercial zone is present.|
destination_ref vs. dest_ref vs. destination:ref
At the time of this proposal the keys destination_ref=* and dest_ref=* have been already used for the purpose of the proposed destination:ref=*. Both keys are not documented (and quite a lot of destination_ref tags are from me). As the usage numbers currently are not too high (about 400-500 each) I still recommend to use the key destination:ref=* instead to introduce a consistent tagging scheme with all the other sub-keys. Please use the Discussion page to comment on this.
Update on Dec 12th 2012: This issue is more or less obsolete: current usage numbers are 1381 (destination:ref) vs. 263 (destination_ref) vs 219 (dest_ref).
Update un Dec 14th 2013: Issue is obsolete. Both dest_ref=* and destination_ref=* are no longer used for ways. (destination_ref=* is still being used several times for Relation:destination sign and should be changed to ref=* in that context, but that will have to be discussed and solved there and not here.)
destination:sign vs. destination:symbol
Please use the Discussion page for this.
- A summary of all destination-related tags that are in use, independent of their status
- OSM Destination Signs - Rendering of signs based on destination=* and Relation:destination_sign.
- CheckAutopista – Rendering and check of destination=*, destination:ref=*, destination:int_ref=* and destination:symbol=* for motorway exits.
- destination:symbol=* (German wiki page)