Template:Map Features:addr

From OpenStreetMap Wiki
Jump to navigation Jump to search


This is used to provide postal information for a building or facility. See the pages titled Addresses and addr=* for an introduction on its usage.

Key Value Element Comment Rendering Photo

Tags for individual houses

addr:housenumber user defined node area The house number (may contain letters, dashes or other characters).
Addresses describes ways to tag a single building with multiple addresses.
Please do not only tag addr:housenumber=*, but also add at least addr:street=* or addr:place=* for places without streets (or map the belonging to a street with a relation using associatedStreet relation or street relation.)
Wien Lainzer Str 8a.jpg
addr:housename user defined node area The name of a house.
This is sometimes used in some countries like England instead of (or in addition to) a house number.
addr:flats user defined node The house numbers (range or list) of flats behind a door.
addr:conscriptionnumber user defined node area This special kind of housenumber relates to a settlement instead of a street. Conscription numbers were introduced in the Austrio-Hungarian Empire and are still in use in some parts of Europe, sometimes together with street-related housenumbers which are also called orientation numbers.
addr:street user defined node area The name of the respective street.
A way with highway=* or a square with place=square and the corresponding name should be found nearby. The belonging to a street can alternatively be represented by a associatedStreet relation or street relation. The keys addr:housenumber=* and addr:street=* in principle are the only necessary ones if there are valid border polygons. If you are not sure if it is so, just add addr:city=*, addr:postcode=* and addr:country=*.
Kirkland, WA - double street sign.jpg
addr:place user defined node area This is part of an address which refers to the name of some territorial zone (usually a place=* like island, square or very small village) instead of a street (highway=*). Should not be used together with addr:street=*.
addr:postcode user defined node area The postal code of the building/area. Some mappers prefer to use boundary=postal_code
addr:city user defined node area May not be required if boundary=administrative is used correctly. May or may not be a clone of is_in:city=* (in some places the city in the address corresponds to the post office that serves the area rather than the actual city, if any, in which the building is located)! The name of the city as given in postal addresses of the building/area.
addr:country user defined node area May not be required if boundary=administrative is used correctly. The ISO 3166-1 alpha-2 two letter country code in upper case.
Example: "DE" for Germany, "CH" for Switzerland, "AT" for Austria, "FR" for France, "IT" for Italy.
Caveat: The ISO 3166-1 code for Great Britain is "GB" and not "UK". See also: is_in:country=*
addr:full user defined node area Use this for a full-text, often multi-line, address if you find the structured address fields unsuitable for denoting the address of this particular location. Examples: "Fifth house on the left after the village oak, Smalltown, Smallcountry", or addresses using special delivery names or codes (possibly via an unrelated city name and post code), or PO Boxes.
Beware that these strings can hardly be parsed by software: "1200 West Sunset Boulevard Suite 110A" is still better represented as addr:housenumber=1200 + addr:street=West Sunset Boulevard + addr:flats=Suite 110A.

For countries using hamlet, subdistrict, district, province, state

addr:hamlet user defined node area The hamlet of the object.
Grosvenor Place 2 2008 06 19.jpg
addr:suburb user defined node area If an address exists several times in a city. You have to add the name of the settlement. See Australian definition of suburb.
addr:subdistrict user defined node area The subdistrict of the object.
addr:district user defined node area The district of the object.
addr:province user defined node area The province of the object. For Canada, uppercase two-letter postal abbreviations (BC, AB, ON, QC, etc.) are used. In Russia a synonym addr:region is widely used
addr:state user defined node area The state of the object. For the US, uppercase two-letter postal abbreviations (AK, CA, HI, NY, TX, WY, etc.) are used.

Tags for interpolation ways

addr:interpolation all/even/odd/ alphabetic way How to interpolate the house numbers belonging to the way along the respective street.
See detailed description.
Spořilov, Púchovská, označení domu.jpg
addr:interpolation Number n way Every nth house between the end nodes is represented by the interpolation way.
addr:inclusion actual/estimate/potential way Optional tag to indicate the accuracy level of survey used to create the address interpolation way.
See detailed description.
This section is a wiki template with a default description in English. Editable here.
[Edit] [Purge] Template-info.svg Template documentation

Template for the Addresses table in the Map Features page. Use the default English text or use the template arguments for your translations


All parameters are optional. By default, text is in English.

  • English writers shall write their comments in the template itself (avoiding double edition).
  • Other languages are translated in template arguments, not in the template itself.
  • name = === Section header line ===
  • description = Displayed before the table; optional
Table column headers
  • head:key = Key
  • head:value = Value
  • head:element = Element
  • head:desc = Comment
  • head:render = Rendering
  • head:photo = Photo
Table subsections (row groups)
  • head:subsection = Text of the subsection header row
For each table row for a tag whose key is addr:subkey
  • addr:subkey:key = Key:addr:subkey
  • addr:subkey:value = (subkey name)
  • addr:subkey:desc = (Description)
  • addr:subkey:render =
  • addr:subkey:photo =

Template to copy/paste in translations

</noinclude>{{Map Features:addr
|name         =
|description  =
|addr:key     = 

|head:key     =
|head:value   =
|head:element =
|head:desc    =
|head:render  =
|head:photo   =

|head:house_tags =

|addr:housenumber:value =
|addr:housenumber:desc  =
|addr:conscriptionnumber:value =
|addr:conscriptionnumber:desc  =
|addr:housename:value =
|addr:housename:desc  =
|addr:street:value =
|addr:street:desc  =
|addr:place:value =
|addr:place:desc  =
|addr:postcode:value =
|addr:postcode:desc  =
|addr:city:value =
|addr:city:desc  =
|addr:country:value =
|addr:country:desc  =
|addr:full:value =
|addr:full:desc  =

|head:hamlet_subdistrict_district_province =

|addr:hamlet:value =
|addr:hamlet:desc  =
|addr:suburb:value =
|addr:suburb:desc  =
|addr:subdistrict:value =
|addr:subdistrict:desc  =
|addr:district:value =
|addr:district:desc  =
|addr:province:value =
|addr:province:desc  =
|addr:state:value =
|addr:state:desc  =

|head:interpolation_tags =

|addr:interpolation:value =
|addr:interpolation:desc  =
|addr:interpolation:number:value =
|addr:interpolation:number:desc  =
|addr:inclusion:value =
|addr:inclusion:desc  =