Key:addr

addr
Description
The addr tag is the prefix for several addr:* keys to describe addresses
Group: Addresses
Used on these elements
See also
contact=*
Wikidata
Search Wikidata
Status: de facto
Tools for this tag
taginfo · CH · CZ · FR · GB · HU · IE · IN · JP · PL overpass-turbo

The various addr keys are used to provide address information for buildings and facilities. See Addresses for more details on usage.

How to map

If it is a point of interest

Add the required address elements to the object.

If the address applies to an area (e.g. often detached houses, terraced house, buildings including or without associated open areas)

Add at least the following to the polygon that represents the area (building or site, according to validity of address):

• addr:housenumber=*
• addr:street=*

You might consider adding addr:postcode=* on single elements, depending on local mapping practices. Further address tags are optional, since they can usually be determined from the boundary relations (if present and valid).

If the address applies to a point (e.g. entrance, gate)

Add the following to the node representing the point:

• addr:housenumber=*
• addr:street=*

Unless the following are unknown or don't exist, add them as well:

• addr:postcode=*
• addr:city=*

Example on map:

Loading map...

{"tileLayer":"//{s}.tile.openstreetmap.org/{z}/{x}/{y}.png","attribution":"\u0026copy; \u003Ca href=\"http://osm.org/copyright\"\u003EOpenStreetMap\u003C/a\u003E contributors","center":{"lat":52.49832,"lon":13.43601},"zoom":"17","minzoom":"13","maxzoom":"18"}

OpenStreetMap.org/#map=19/52.49832/13.43601

Using addr:country=*, addr:state=*, and addr:province=* are optional, since they can almost always be determined from boundary relations (if present and valid).

If you don't know the extent of the address

Create a node where you expect the address to be valid. If you can estimate an area it might be better to use this rather than a node.

• addr:housenumber=*
• addr:street=*

Unless the following are unknown or don't exist, add them as well:

• addr:postcode=*
• addr:city=*

Using addr:country=*, addr:state=*, and addr:province=* are optional, since they can almost always be determined from boundary relations (if present and valid).

Collection methods

• Rapid Address Collection describes methods of collecting addresses rapidly.

Commonly used subkeys

Key	Value	Element	Comment	Rendering	Photo
Tags for individual houses
addr:housenumber	user defined		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.)
addr:housename	user defined		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		The unit numbers (a range or a list) of the flats or apartments located behind a single entrance door.
addr:conscriptionnumber	user defined		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		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=*.
addr:place	user defined		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		The postal code of the building/area. Some mappers prefer to use boundary=postal_code
addr:city	user defined		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		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		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		The hamlet of the object.
addr:suburb	user defined		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		The subdistrict of the object.
addr:district	user defined		The district of the object.
addr:province	user defined		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		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		How to interpolate the house numbers belonging to the way along the respective street. See detailed description.
addr:interpolation	Number n		Every nth house between the end nodes is represented by the interpolation way.
addr:inclusion	actual/estimate/potential		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.

Detailed subkeys

More detailed information as approved here: Proposed features/addr keys (2011-04)

Key	Value	Element	Comment	Photo	Taginfo
Tags for parts of a building
addr:door	user defined		The door number (or name) of an apartment/flat/office/room. Could also be called differently in some countries (In Austria for example it is sometimes referred to as "Top"). If a room has more than one door, you can tag them separately. See also: room=*
addr:unit	user defined		The number, letter, or name of a single unit or flat that exists within a larger complex. While a big building could have only one entrance, sometimes the way inside divides into different units or staircases, where certain apartments/flats/offices can only be reached through a specific unit. Useful for apartment, suite, or office numbers. Information necessary for postmen, for example.
addr:flats	user defined		A list of flat numbers accessible in a building or behind a door.
addr:floor	Number		The floor an apartment/flat/office is located. This tag is not commonly used. Please have a look at the other discussed alternatives. See also: level=*
addr:block	user defined		The city block, if part of the address. In Japan, very few streets have names, so most housenumbers are associated with the block, not the street. See JA:住所#.E8.A1.97.E5.8C.BA_Block_number_address_system.E3.81.AB.E3.81.A4.E3.81.84.E3.81.A6

Multilingual Addresses

In areas with two or more official languages, addresses can be localized by adding a language code after the usual address keys like:

• addr:street:en=*
• addr:city:en=*

How language codes are selected is described in Multilingual_names.

Addresses without housenumbers

• If there wasn’t a housenumber assigned to the address, you can use nohousenumber=yes

See also

• contact=* - The contact tag is the prefix for several contact:* keys to describe contacts
• 2008 Proposal Proposed_features/House_numbers/Karlsruhe_Schema
• 2011 Proposal Proposed_features/addr_keys_(2011-04)
• 2011 Proposal Proposed_features/addr:place
• 2019/10 Proposal Proposed_features/Addr:milestone for distance based addresses