Nominatim (from Latin, meaning "name") is a tool (reverse geocoding) that can search for data in OSM by name and address and generate a synthetic address for the OSM point. This tool can be found in http://nominatim.openstreetmap.org. Nominatim is also used in the Search Toolbar on the OpenStreetMap home page, and also provides search support for Mapquest Open initiative.
This page provides instructions for use. To learn more about how Nominatim works, see the development overview and this FAQ. There is also a list of language codes and individual country address formats for each country.
Search
Nominatim is indexed for named (or numbered) content in the data set of the OSM, as well as other unnamed subset of features (bars, hotels, churches, etc.).
The search starts from left to right, and if it fails, it is searched from right to left.
Both searches will result: Pilkington Boulevard, Birmingham Birmingham, Pilkington Boulevard
(commas are optional, but adding commas can reduce the complexity of the search and improve search accuracy.) )
The house number has been defined in the area that can be used: 135 Pilkington Boulevard, Birmingham
Special Keywords
Different keywords in the search are translated into specific OSM tags (for example, bar = amenity = pub). Here is a list of such special phrases.
Parameters
Http://nominatim.openstreetmap.org/search?<params> Http://nominatim.openstreetmap.org/search/<query >?<params>
FORMAT=[HTML|XML|JSON|JSONV2] Output format
Json_callback=<string>
Accept-language=<browser language string> Preferred language order for showing search results, overrides the BR Owser value. Either uses standard rfc2616 accept-language string or a simple comma separated list of language codes.
q=<query> query string to search for. Alternatively can entered as:
street=(experimental) alternative query string format for Structured requests. Structured requests is faster and require less server resources. COMBINE with Q=<query> PARAMETER.
Countrycodes=<countrycode>[,<countrycode>][,<countrycode>] ... Limit search results to a specific country (or a list of countries). <countrycode> should is the ISO 3166-1ALPHA2 code, e.g GB for the same kingdom, de for Germany, etc.
Viewbox=<left>,<top>,<right>,<bottom> or viewboxlbrt=<left>,<bottom>,< Right>,<top> the preferred area to find search results
BOUNDED=[0|1] Restrict The results to only items contained with the bounding box. Restricting the results to the bounding box also enables searching by amenity only. For example a search query of just "[pub]" would normally is rejected but with bounded=1 would result in a list of item s matching within the bounding box.
POLYGON=[0|1] Output polygon outlines for items found (deprecated, use one of the polygon_* parameters instead )
ADDRESSDETAILS=[0|1] Include A breakdown of the address into elements
Email=<valid Email address> If You is 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'll is kept confidential and only used to the the event of a problem, see Usage Policy F or more details.
Exclude_place_ids=<place_id,[place_id],[place_id]> If You don't want certain OpenStreetMap objects to appear In the search result, give a comma separated list of the place_id ' s you want to skip.
Limit=<integer> Limit The number of returned results.
Dedupe=[0|1] No explanation yet.
Debug=[0|1] No explanation yet.
Polygon_geojson=1 Output geometry of results in Geojson format.
Polygon_kml=1 Output geometry of results in KML format.
Polygon_svg=1 Output geometry of results in SVG format.
Polygon_text=1 Output Geometry of results as a WKT.
Example
http://nominatim.openstreetmap.org/search?q=135+pilkington+avenue,+birmingham&format=xml&polygon= 1&addressdetails=1 Http://nominatim.openstreetmap.org/search/135%20pilkington%20avenue,%20birmingham?format =xml&polygon=1&addressdetails=1 http://nominatim.openstreetmap.org/search/gb/birmingham/pilkington% 20avenue/135?format=xml&polygon=1&addressdetails=1
<searchresults timestamp= "Sat, Nov 14:42:10 +0000" querystring= "135 Pilkington, Avenue Birmingham" Polygon= "true "> <place place_id=" 1620612 "osm_type=" Node "osm_id=" 452010817 "boundingbox=" 52.548641204834,52.54884338 37891,-1.81612110137939,-1.81592094898224 "polygonpoints=" [['-1.81592098644987 ', ' 52.5487429714954 '],['- 1.81592290792183 ', ' 52.5487234624632 '],...] " lat= "52.5487429714954" lon= " -1.81602098644987" Display_name= "135, Pilkington Avenue, Wylde Green, City of Birmingham, West Midlands (county), B72, Kingdom "class=" Place "type=" House "> Reverse geocoding/Address lookupReverse geocoding generates an address from latitude and longitude. The optional zoom parameter specifies the appropriate zoom level to display the information displayed on the openlayers.
ParametersHttp://nominatim.openstreetmap.org/reverse?<query>
Format=[xml|json] Output format
Json_callback=<string>
Accept-language=<browser language string> Preferred language order for showing search results, overrides the BR Owser value. Either uses standard rfc2616 accept-language string or a simple comma separated list of language codes.
osm_type=[n| w| R] osm_id=<value> A specific OSM node/way/relation to return the address for the use of this in Prefe Rence to Lat/lon where possible
Lat=<value> lon=<value> the location to generate a address for
ZOOM=[0-18] level of detail required where 0 is country and are house/building
ADDRESSDETAILS=[0|1] Include A breakdown of the address into elements
Email=<valid Email address> If You is 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'll is kept confidential and only used to the the event of a problem, see Usage Policy fo R more details.
Examplehttp://nominatim.openstreetmap.org/reverse?format=xml&lat=52.5487429714954&lon=-1.81602098644987& Zoom=18&addressdetails=1
<reversegeocode timestamp= "Fri, Nov 16:33:54 +0000" querystring= "..." > <result place_id= "1620612" Osm_type= "Node" osm_id= "452010817" > 135, Pilkington Avenue, Wylde Green, City of Birmingham, West Midlands (county ), B72, Kingdom </result> <addressparts>
Http://wiki.openstreetmap.org/wiki/Zh-hans:Nominatim
Use Nominatim for OpenStreetMap address search/Resolution