mirror of
https://github.com/osm-search/Nominatim.git
synced 2026-02-15 19:07:58 +00:00
117 lines
4.6 KiB
Markdown
117 lines
4.6 KiB
Markdown
## Address lookup
|
|
|
|
Lookup the address of one or multiple OSM objects like node, way or relation.
|
|
|
|
### Parameters
|
|
```
|
|
https://nominatim.openstreetmap.org/lookup?<query>
|
|
```
|
|
|
|
* `format=[xml|json|geojson]`
|
|
|
|
* Output format
|
|
* Defaults to `xml`
|
|
|
|
* `json_callback=<string>`
|
|
|
|
* Wrap json output in a callback function (JSONP) i.e. `<string>(<json>)`
|
|
|
|
* `accept-language=<browser language string>`
|
|
|
|
* Preferred language order for showing search results, overrides the value specified in the "Accept-Language" HTTP header.
|
|
* Either uses standard rfc2616 accept-language string or a simple comma separated list of language codes.
|
|
|
|
* `osm_ids=[N|W|R]<value>,…,[N|W|R]<value`
|
|
* A list of up to 50 specific osm node, way or relations ids to return the addresses for
|
|
|
|
* `addressdetails=[0|1]`
|
|
* defaults to 0
|
|
* Include a breakdown of the address into elements
|
|
|
|
* `email=<valid email address>`
|
|
|
|
* If you are making large numbers of request please include a valid email address or alternatively include your email address as part of the User-Agent string.
|
|
* This information will be kept confidential and only used to contact you in the event of a problem, see [Usage Policy](https://operations.osmfoundation.org/policies/nominatim/) for more details.
|
|
|
|
* `extratags=1`
|
|
* Include additional information in the result if available, e.g. wikipedia link, opening hours.
|
|
|
|
* `namedetails=1`
|
|
* Include a list of alternative names in the results.
|
|
* These may include language variants, references, operator and brand.
|
|
|
|
### Example
|
|
|
|
##### XML
|
|
|
|
[https://nominatim.openstreetmap.org/lookup?osm_ids=R146656,W104393803,N240109189](https://nominatim.openstreetmap.org/lookup?osm_ids=R146656,W104393803,N240109189)
|
|
|
|
```xml
|
|
<lookupresults timestamp="Mon, 29 Jun 15 18:01:33 +0000" attribution="Data © OpenStreetMap contributors, ODbL 1.0. https://www.openstreetmap.org/copyright" querystring="R146656,W104393803,N240109189" polygon="false">
|
|
<place place_id="127761056" osm_type="relation" osm_id="146656" place_rank="16" lat="53.4791466" lon="-2.2447445" display_name="Manchester, Greater Manchester, North West England, England, United Kingdom" class="boundary" type="administrative" importance="0.704893333438333">
|
|
<city>Manchester</city>
|
|
<county>Greater Manchester</county>
|
|
<state_district>North West England</state_district>
|
|
<state>England</state>
|
|
<country>United Kingdom</country>
|
|
<country_code>gb</country_code>
|
|
</place>
|
|
<place place_id="77769745" osm_type="way" osm_id="104393803" place_rank="30" lat="52.5162024" lon="13.3777343363579" display_name="Brandenburg Gate, 1, Pariser Platz, Mitte, Berlin, 10117, Germany" class="tourism" type="attraction" importance="0.443472858361592">
|
|
<attraction>Brandenburg Gate</attraction>
|
|
<house_number>1</house_number>
|
|
<pedestrian>Pariser Platz</pedestrian>
|
|
<suburb>Mitte</suburb>
|
|
<city_district>Mitte</city_district>
|
|
<city>Berlin</city>
|
|
<state>Berlin</state>
|
|
<postcode>10117</postcode>
|
|
<country>Germany</country>
|
|
<country_code>de</country_code>
|
|
</place>
|
|
<place place_id="2570600569" osm_type="node" osm_id="240109189" place_rank="15" lat="52.5170365" lon="13.3888599" display_name="Berlin, Germany" class="place" type="city" importance="0.822149797630868">
|
|
<city>Berlin</city>
|
|
<state>Berlin</state>
|
|
<country>Germany</country>
|
|
<country_code>de</country_code>
|
|
</place>
|
|
</lookupresults>
|
|
```
|
|
|
|
##### JSON with extratags
|
|
|
|
[https://nominatim.openstreetmap.org/lookup?osm_ids=W50637691&format=json](https://nominatim.openstreetmap.org/lookup?osm_ids=W50637691&format=json)
|
|
|
|
```json
|
|
[
|
|
{
|
|
"place_id": "84271358",
|
|
"licence": "Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
|
|
"osm_type": "way",
|
|
"osm_id": "50637691",
|
|
"lat": "52.39955055",
|
|
"lon": "13.04806574678",
|
|
"display_name": "Brandenburger Tor, Brandenburger Straße, Nördliche Innenstadt, Innenstadt, Potsdam, Brandenburg, 14467, Germany",
|
|
"class": "historic",
|
|
"type": "city_gate",
|
|
"importance": "0.221233780277011",
|
|
"address": {
|
|
"address29": "Brandenburger Tor",
|
|
"pedestrian": "Brandenburger Straße",
|
|
"suburb": "Nördliche Innenstadt",
|
|
"city": "Potsdam",
|
|
"state": "Brandenburg",
|
|
"postcode": "14467",
|
|
"country": "Germany",
|
|
"country_code": "de"
|
|
},
|
|
"extratags": {
|
|
"image": "http://commons.wikimedia.org/wiki/File:Potsdam_brandenburger_tor.jpg",
|
|
"wikidata": "Q695045",
|
|
"wikipedia": "de:Brandenburger Tor (Potsdam)",
|
|
"wheelchair": "yes",
|
|
"description": "Kleines Brandenburger Tor in Potsdam"
|
|
}
|
|
}
|
|
]
|
|
```
|