Addresses
| |
| Description |
| Used to provide postal information for the building or facility. |
| Tags |
Address tags can be added to isolated nodes, to nodes that are parts of building polygons ( = entrance=*s ) or on building=* polygons.
Contents |
Basic tagging
Addresses can be tagged with addr:housenumber=* and the other addr:* keys.
Special cases
Buildings with multiple house numbers
When a building has more than one house number, use either the numbers separated by commas (e.g., "11,13,15") or specify the range (e.g., "10-95"), and use addr:interpolation=* to describe whether that includes odd, even or all numbers. Consider to create separate connected polygons for buildings with different addresses even if they share walls.
If house numbers are associated with individual entrances, tag those numbers to building=entrance nodes.
Using interpolation
As long as we don't have a node or building outline for each house(number) along a way, it's also possible to use automatic number interpolation. For that, draw a way connecting the existing house numbers and mark it with the type of interpolation as shown in the picture above. Additional tags such as addr:street=* are still added to the objects with the addr:housenumber=* tag, the interpolation way only gets the addr:interpolation=* tag.
For irregular missing house numbers (e.g., missing "13") two ways need to be drawn (e.g., "1-11" and "15-25"). If there is a regular structure to the missing house numbers, for example, every other number is missing from a sequence (example for an odd way: 3401, 3405, 3409, etc.), use a numeric value with addr:interpolation=* to indicate the value to increment between house numbers. (Note: addr:interpolation=odd and addr:interpolation=even are just special cases of addr:interpolation=number, where number is 2, and the beginning node is odd or even, respectively.)
If there is a house number on a single node or single building polygon and that house number also appears as the result of an interpolation, software should handle this case gracefully and favour the individually tagged house number as the real position.
As seen in the example picture above, it's allowed to add nodes that do not have an integer value for their addr:housenumber tag somewhere in an odd/even/all interpolation (e.g., "12b"). Those will be ignored for the interpolation. However, endpoints of the interpolation way always have to follow the given interpolation rule!
You can use the interpolation method "alphabetic" to interpolate the alphabetical characters in the house number. So if you have all the houses from 7a to 7f in a row, you can connect them by a way tagged with addr:interpolation=alphabetic. You can not mix alphabetic interpolation with other interpolation methods. There is a special case for the Latin character set in which the first entry in the sequence is a number, followed by the number plus the letter A. For example, the range 25-25F means that the houses are numbered 25, 25A, 25B … 25F.
Using Address Interpolation for partial surveys
To indicate the accuracy level of a and interpolation you can use the optional tag addr:inclusion=*, to represent what data is missing from a house number survey.
- Not all houses are yet present, but the endpoints of the street are surveyed.
- The endpoints of the street are not known, but a possible range can be estimated.
- house numbers are missing or damaged beyond recognition, so the interval can not be correct.
- Use of US TIGER data to indicate all possible addresses on a block; useful for routing to the nearest block where no survey has been done.
The optional tag addr:inclusion identifies the accuracy of the data.
- addr:inclusion=actual - Represents an accurate survey where calculating every house number from the address interpolation way results in an exact match with physical houses. This is the same meaning as omitting the addr:inclusion tag.
- addr:inclusion=estimate - The address interpolation way may contain numbers that don't actually physically exist for typical reasons of cases 1-3 above. A survey has been performed, and Geo-location calculations will be within several physical house spaces from the actual house.
- addr:inclusion=potential - The complete range of all possible address numbers on a block, although there may not physically be enough room on the block for that range of house numbers. Interpolation data from US TIGER is an example where Geo-location would only be as near as one block.
Tool support
There are visualisations of address and building information available as an ITO Map layer and as a view within Geofabrik's OSM Inspector. These visualisations track building tags, and shows if any address/name data is present. OSM Inspector also provides checks on address interpolation ways. OSM Inspector is restricted to Europe.
OpenLinkMap is a slippy map, making this tag's data available as clickable POIs.
See also
- For some background information about the initial proposal, please refer to Karlsruhe Schema
- The relations "collection", "street" and "associatedStreet" as addition or alternative to addr:street
- is_in as an alternative to addr:city and addr:country
- phone=* / contact:phone=*, fax=* / contact:fax=* and email=* / contact:email=*
- Proposal for additional addr subkeys (unit/floor/door)
- FrontDoor app Co-project with Bing (Microsoft Corporation) to locate houses on aerial photos and feed address data back to OSM.
