The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.places.findByLatLon
Return a place ID for a latitude, longitude and accuracy triple.
The flickr.places.findByLatLon method is not meant to be a (reverse) geocoder in the traditional sense. It is designed to allow users to find photos for "places" and will round up to the nearest place type to which corresponding place IDs apply.
For example, if you pass it a street level coordinate it will return the city that contains the point rather than the street, or building, itself.
It will also truncate latitudes and longitudes to three decimal points.
The flickr.places.findByLatLon method is not meant to be a (reverse) geocoder in the traditional sense. It is designed to allow users to find photos for "places" and will round up to the nearest place type to which corresponding place IDs apply.
For example, if you pass it a street level coordinate it will return the city that contains the point rather than the street, or building, itself.
It will also truncate latitudes and longitudes to three decimal points.
Authentication
This method does not require authentication.
Arguments
api_key(Required)- Your API application key. See here for more details.
lat(Required)- The latitude whose valid range is -90 to 90. Anything more than 4 decimal places will be truncated.
lon(Required)- The longitude whose valid range is -180 to 180. Anything more than 4 decimal places will be truncated.
accuracy(Optional)- Recorded accuracy level of the location information. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. The default is 16.
Example Response
<places latitude="37.76513627957266" longitude="-122.42020770907402" accuracy="16" total="1"> <place place_id="Y12JWsKbApmnSQpbQg" woeid="23512048" latitude="37.765" longitude="-122.424" place_url="/United+States/California/San+Francisco/Mission+Dolores" place_type="neighbourhood" place_type_id="22" timezone="America/Los_Angeles" name="Mission Dolores, San Francisco, CA, US, United States" /> </places>
Error Codes
1: Required arguments missing- One or more required parameters was not included with the API request.
2: Not a valid latitude- The latitude argument failed validation.
3: Not a valid longitude- The longitude argument failed validation.
4: Not a valid accuracy- The accuracy argument failed validation.
100: Invalid API Key- The API key passed was not valid or has expired.
105: Service currently unavailable- The requested service is temporarily unavailable.
111: Format "xxx" not found- The requested response format was not found.
112: Method "xxx" not found- The requested method was not found.
114: Invalid SOAP envelope- The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call- The XML-RPC request document could not be parsed.
116: Bad URL found- One or more arguments contained a URL that has been used for abuse on Flickr.