X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/eaee87e73decb643939ddf3ce64cd6d6373d71e2..252fe42612f60641abbe44a24e460c989859a148:/docs/api/Reverse.md diff --git a/docs/api/Reverse.md b/docs/api/Reverse.md index 664593d8..56281d06 100644 --- a/docs/api/Reverse.md +++ b/docs/api/Reverse.md @@ -4,7 +4,7 @@ Reverse geocoding generates an address from a latitude and longitude. ## How it works -The reveser geocoding API does not exactly compute the address for the +The reverse geocoding API does not exactly compute the address for the coordinate it receives. It works by finding the closest suitable OSM object and returning its address information. This may occasionally lead to unexpected results. @@ -27,15 +27,15 @@ The main format of the reverse API is https://nominatim.openstreetmap.org/reverse?lat=&lon=& ``` -where `lat` and `lon` are latitude and longitutde of a coordinare in WGS84 +where `lat` and `lon` are latitude and longitude of a coordinate in WGS84 projection. The API returns exactly one result or an error when the coordinate is in an area with no OSM data coverage. -Additional paramters are accepted as listed below. +Additional parameters are accepted as listed below. !!! warning "Deprecation warning" The reverse API used to allow address lookup for a single OSM object by - its OSM id. This use is now deprecated. Use the [Address Lookup API](../Lookup) + its OSM id. This use is now deprecated. Use the [Address Lookup API](Lookup.md) instead. ### Output format @@ -92,7 +92,10 @@ In terms of address details the zoom levels are as follows: 5 | state 8 | county 10 | city - 14 | suburb + 12 | town / borough + 13 | village / suburb + 14 | neighbourhood + 15 | locality 16 | major streets 17 | major and minor streets 18 | building @@ -118,7 +121,7 @@ geometry. Topology is preserved in the result. (Default: 0.0) * `email=` -If you are making large numbers of request please include an appropriate email +If you are making a large number of requests, please include an appropriate email address to identify your requests. See Nominatim's [Usage Policy](https://operations.osmfoundation.org/policies/nominatim/) for more details. @@ -162,7 +165,7 @@ This overrides the specified machine readable format. (Default: 0) "licence":"Data © OpenStreetMap contributors, ODbL 1.0. https:\/\/www.openstreetmap.org\/copyright", "osm_type":"way", "osm_id":"280940520", -"lat":"-34.4391708", + "lat":"-34.4391708", "lon":"-58.7064573", "place_rank":"26", "category":"highway",