Key:ref

From OpenStreetMap Wiki
(Redirected from Key:reference)
Jump to navigation Jump to search
Public-images-osm logo.svg ref
UK traffic sign 2901.svg
Description
Used for reference numbers or codes. Common for roads, highway exits, routes, etc. Edit or translate this description.
Group: References
Used on these elements
may be used on nodesmay be used on waysmay be used on areasmay be used on relations
Wikidata
Status: de facto

"ref" stands for "reference" and is used for reference numbers or codes. Common for roads, highway exits, routes, etc. It is also used for shops and amenities that are numbered officially as part of a retail brand or network respectively.

This key and variations are frequently used to avoid the use of relations.

Key variations

For cycle routes:

There is a wide use of ref:* as a namespace prefix. A selection of frequently used variations is listed here :

key used on description see also taginfo count (25 June 2018)
ref:bag=* Id of Dutch buildings BAGimport 10112655[1]
ref:bic=* heritage=* identifiers for (Spain) Bien de Interés Cultural (BIC) Bienes culturales protegidos by the Spanish Government. 527[2]
ref:cadw=* heritage:operator=cadw id in Cadw's database of scheduled monuments and listed buildings in Wales, United Kingdom [3]
ref:ctb=* highway=bus_stop Signposted on Citybus & NWFB bus stops 1651[4]
ref:De_Lijn=* bus_stop/platform node, route, route_master signposted on bus/tram stops in and around Flanders, Belgium WikiProject_Belgium/De_Lijndata 38318[5]
ref:ERDF:gdo=* line, minor_line or substation Id of French power distribution facilities 1801[6]
ref:fgkz=* Relation:waterway FGKZ reference ID (Germany) 9927[7]
ref:FR:PTT=* exchange or connection_point Id of French telephone copper local loops facilities 617[8]
ref:gnbc=* Relation:waterway, Relation:boundary, place=*, others GNBC reference ID (Canada) About the Canadian Geographical Names Database 52[9]
ref:gnis=* Relation:waterway, Relation:boundary, place=*, others GNIS reference ID (United States) 18[10]
ref:harbour=* landuse=industrial Number of company in harbour on road signage, used e.g. in the Nederlands
ref:IFOPT=* highway=bus_stop/public_transport=platform node international identifier for bus stops and platforms 114301[11] count from 2019-04-20
ref:industrial=* landuse=industrial Number of company in industrial area on road signage, used e.g. in the Nederlands
ref:INSEE=* admin_level=* INSEE code of the French communes 77693[12]
ref:isil=* amenity=library International Standard Identifier for Libraries 1539[13]
ref:kmb=* highway=bus_stop Signposted on KMB & LW bus stops 3199[14]
ref:mhs=* heritage=* id in the French database Mérimée of historic monuments 34120[15]
ref:MMM=* highway=* or emergency=defibrillator or attraction=animal object ID used by Montpellier Méditerranée Métropole, a french local authority Montpellier#Utilisation_du_tag_ref:MMM 278[16]
ref:NBd=* junction=yes or traffic_sign=* Reference number of the Dutch Nationale Bewegwijzeringsdienst (NBd) 99[17]
ref:nid=* heritage=* id in Narodowy Instytut Dziedzictwa historic monuments 10634[18]
ref:nrhp=* heritage=* identifiers for (United States) National Register of Historic Places (NRHP) records 22 NRHP advanced search 3626[19]
ref:rce=* heritage=* id in Rijksdienst voor het Cultureel Erfgoed 4528[20]
ref:regine=* Relation:waterway REGINE reference ID (Norway) 2[21]
ref:ruian=*
ref:ruian:addr=*
ref:ruian:building=*
building=*, addr=* RUIAN building or address reference ID (Czech republic) 565550[22]

2275524[22]

2862196[22]

ref:sandre=* river ref of the French Sandre agency WikiProject France/Cours d'eau 52151[23]
ref:svhl=* station-keys of Lübecker Stadtverkehr (Germany) Lübeck/Importe 2322[24]
ref:whc=* heritage=* id of the Unesco World Heritage 1464[25]
ref:TECB=* bus_stop/platform node, route, route_master signposted on bus stops in and around Brabant-Wallon, Wallonia, Belgium TEC data import 3602[26]
ref:TECC=* bus_stop/platform node, route, route_master signposted on bus stops in and around Charleroi, Wallonia, Belgium TEC data import 3398[27]
ref:TECH=* bus_stop/platform node, route, route_master signposted on bus stops in and around Hainaut, Wallonia, Belgium TEC data import 5638[28]
ref:TECL=* bus_stop/platform node, route, route_master signposted on bus stops in and around Liège-Verviers, Wallonia, Belgium TEC data import 9316[29]
ref:TECN=* bus_stop/platform node, route, route_master signposted on bus stops in and around Namur, Wallonia, Belgium TEC data import 5357[30]
ref:TECX=* bus_stop/platform node, route, route_master signposted on bus stops in and around Luxembourg (province), Wallonia, Belgium TEC data import 5848[31]
ref:UrbIS=* building=* addr=* Reference Key of Urbis Database for addresses in Brussels Brussels#CIRB_UrbIS 292732[32]
ref:usrn=* Unique Street Reference Number - a primary key use by the National Address Gazeteer in the UK National Address Gazeteer 66847[33]
ref:VHAG=* waterway=* reference codenr. of waterways in Flanders,Belgium Vlaamse Hydrografische Atlas [34]

‡ These keys are specifically encouraged for use by JOSM Waterway relation presets.[35] Depending on the scope of the reference system, they may have uses in other key/tag schemas as well.

Core values

None

User defined values

Any valid syntax value

Examples on relations

States and provinces are often tagged with a postal abbreviation in ref. For example:

  • ref=CA The state of California (type=boundary, admin_level=4, name=California - currently relation 165475)

On road routes, the ref is a bare number, relying on network=* to convey information about the road network:

Similarly, on cycle and walking routes, the ref is a bare number and cycle_network=* indicates the route network:

Bus routes use ref to label the bus route. For example:

  • ref=23 Bus route 23. (type=route, route=bus, name=Shanklin>Newchurch>Newport - currently relation 312207)

Examples on ways

There are no global standards as to whether the refs include spaces, hyphens or other characters. At least when nationally consistent, tag what's on the ground. Some countries use spaces on the signs, others don't. In some countries the usage on the signs varies and guidelines are under discussion.

  • ref=A 1 Default reference (German and French references with a space; e.g. A 1)
  • int_ref=E 15 Internationally referenced as
  • nat_ref=A 1 Nationally referenced as (German and French references with a space; e.g., A 1)
  • reg_ref=A 1 Regionally referenced as (German and French references with a space; e.g., A 1)
  • ncn_ref=54 The number reference for a National Cycle Network. See Cycle_routes
  • ref=A 3;A 7 Default for more than one reference (German and French references with a space; e.g., A 1)

Examples on nodes

A ref on a node generally means a highway exit when combined with highway=motorway_junction:

  • ref=23 US Highway exits are often just a number
  • ref=23B Sometimes exits have been split into A and B exits.

ref is sometimes used on bus stops:

ref is sometimes used to label an entrance into a large parking area. For example a shopping mall may have entrances A - L:

Special uses

  • ref:svhl=* - station-keys of Lübecker Stadtverkehr (Germany) - details look at Lübeck/Importe
  • ref:luebeck=* - internal reference for objects the area of Lübeck
  • ref:bufa=* - 4-digit key of the local German tax and revenue offices (Bundesfinanzamtnummer)
  • ref:vatin=CC12345678 - VAT identification number of companies, use CountryCode (e.g. IT for Italy) and the number
  • official_ref=* - Used in cases where the official administrative reference for a road (or other feature) is not identical with the road signs (or other feature ref), e.g. because they are old, or because the administration doesn't have the money to change the signs.
  • ref=xxxx - Used to mark official company store number assigned to a place. Example (ref=7872) CVS (You'll see a reference tag added to the building)
  • ref:penndot=* - Used for internal state route designations of the Location Referencing System in Pennsylvania.

See also

ref:FR:*=*
WikiProject France/Liste des références nationales
bridge:ref=*
ref:US:EPA=*
United States EPA facilities registration codes

For United States road tagging

Notes

  • For highways shared by more than one route see Relations/Routes or Faq#What shall I do for roads that have multiple values for a tag?. Relations seem to be the preferred method for tagging this.
  • If more than one reference is given, you are recommended to separate them with a semicolon and without a space character, because this is the widely established syntax in Germany and maybe other countries. But note, this syntax is being heavily discussed in Germany. A better approach might be to have a namespace and add the entity that has issued the ref, e.g. ref:foo=x ref:bar=y.
  • Do not confuse this issue with the space that is present in some countries between the letter and the number in a reference itself.
  • When a road has no number, leave this key unused; this makes sure that routing programs do not try to describe the road by a number.

References

  1. https://taginfo.openstreetmap.org/search?q=ref%3Abag
  2. https://taginfo.openstreetmap.org/search?q=ref%3Abic
  3. https://taginfo.openstreetmap.org/search?q=ref%3Acadw
  4. https://taginfo.openstreetmap.org/search?q=ref:ctb
  5. https://taginfo.openstreetmap.org/search?q=ref:De_Lijn
  6. https://taginfo.openstreetmap.org/search?q=ref%3AERDF%3Agdo
  7. https://taginfo.openstreetmap.org/search?q=ref%3Afgkz
  8. https://taginfo.openstreetmap.org/search?q=ref%3AFR%3APTT
  9. https://taginfo.openstreetmap.org/search?q=ref%3Agnbc
  10. https://taginfo.openstreetmap.org/search?q=ref%3Agnis
  11. https://taginfo.openstreetmap.org/search?q=ref:IFOPT
  12. https://taginfo.openstreetmap.org/search?q=ref:insee
  13. https://taginfo.openstreetmap.org/search?q=ref:isil
  14. https://taginfo.openstreetmap.org/search?q=ref:kmb
  15. https://taginfo.openstreetmap.org/search?q=ref%3Amhs
  16. https://taginfo.openstreetmap.org/search?q=ref%3AMMM
  17. https://taginfo.openstreetmap.org/keys/?key=ref%3ANBd
  18. https://taginfo.openstreetmap.org/search?q=ref%3Anid
  19. https://taginfo.openstreetmap.org/search?q=ref%3Anrhp
  20. https://taginfo.openstreetmap.org/search?q=ref%3Arce
  21. https://taginfo.openstreetmap.org/search?q=ref%3Aregine
  22. 22.0 22.1 22.2 https://taginfo.openstreetmap.org/search?q=ref%3Aruian
  23. https://taginfo.openstreetmap.org/search?q=ref%3Asandre
  24. https://taginfo.openstreetmap.org/search?q=ref%3Asvhl
  25. https://taginfo.openstreetmap.org/search?q=ref%3Awhc
  26. https://taginfo.openstreetmap.org/search?q=ref:TECB
  27. https://taginfo.openstreetmap.org/search?q=ref:TECC
  28. https://taginfo.openstreetmap.org/search?q=ref:TECH
  29. https://taginfo.openstreetmap.org/search?q=ref:TECL
  30. https://taginfo.openstreetmap.org/search?q=ref:TECN
  31. https://taginfo.openstreetmap.org/search?q=ref:TECX
  32. https://taginfo.openstreetmap.org/search?q=ref:UrbIS
  33. https://taginfo.openstreetmap.org/search?q=ref%3Ausrn
  34. https://taginfo.openstreetmap.org/search?q=ref:VHAG
  35. https://josm.openstreetmap.de/browser/josm/trunk/data/defaultpresets.xml