The App Garden |
flickr.places.placesForUser
Return a list of the top 100 unique places clustered by a given placetype for a user.
Authentication
This method requiresauthentication with 'read' permission.
Arguments
api_key(Required)- Your API application key.See here for more details.
place_type_id(Optional)- The numeric ID for a specific place type to cluster photos by.
Valid place type IDs are :- 22: neighbourhood
- 7: locality
- 8: region
- 12: country
- 29: continent
The "place_type" argument has been deprecated in favor of the "place_type_id" argument. It won't go away but it will not be added to new methods. A complete list of place type IDs is available using theflickr.places.getPlaceTypes method. (While optional, you must pass either a valid place type or place type ID.) place_type(Optional)- A specific place type to cluster photos by.
Valid place types are :- neighbourhood (and neighborhood)
- locality
- region
- country
- continent
(While optional, you must pass either a valid place type or place type ID.) woe_id(Optional)- A Where on Earth identifier to use to filter photo clusters. For example all the photos clustered bylocality in the United States (WOE ID23424977).
(While optional, you must pass either a valid Places ID or a WOE ID.) place_id(Optional)- A Flickr Places identifier to use to filter photo clusters. For example all the photos clustered bylocality in the United States (Place ID4KO02SibApitvSBieQ).
(While optional, you must pass either a valid Places ID or a WOE ID.) threshold(Optional)- The minimum number of photos that a place type must have to be included. If the number of photos is lowered then the parent place type for that place will be used.
For example if you only have3 photos taken in the locality of Montreal (WOE ID 3534) but your threshold is set to5 then those photos will be "rolled up" and included instead with a place record for the region of Quebec (WOE ID 2344924). min_upload_date(Optional)- Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp.
max_upload_date(Optional)- Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp.
min_taken_date(Optional)- Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime.
max_taken_date(Optional)- Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime.
Example Response
<placestotal="1"> <placeplace_id="kH8dLOubBZRvX_YZ"woeid="2487956"latitude="37.779"longitude="-122.420"place_url="/United+States/California/San+Francisco"place_type="locality"photo_count="156">San Francisco, California</place></places>
Error Codes
1: Places for user are not available at this time- Places for user have been disabled or are otherwise not available.
2: Required parameter missing- One or more of the required parameters was not included with your request.
3: Not a valid place type- An invalid place type was included with your request.
4: Not a valid Place ID- An invalid Places (or WOE) identifier was included with your request.
5: Not a valid threshold- The threshold passed was invalid.
95: SSL is required- SSL is required to access the Flickr API.
96: Invalid signature- The passed signature was invalid.
97: Missing signature- The call required signing but no signature was sent.
98: Login failed / Invalid auth token- The login details or auth token passed were invalid.
99: User not logged in / Insufficient permissions- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100: Invalid API Key- The API key passed was not valid or has expired.
105: Service currently unavailable- The requested service is temporarily unavailable.
106: Write operation failed- The requested operation failed due to a temporary issue.
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.