The App Garden |
flickr.photos.geo.setLocation
Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo.Before users may assign location data to a photo they must define who, by default, may view that information. Users can edit this preference athttp://www.flickr.com/account/geo/privacy/. If a user has not set this preference, the API method will return an error.
Authentication
This method requiresauthentication with 'write' permission.
Note: This method requires an HTTP POST request.
Arguments
api_key(Required)- Your API application key.See here for more details.
photo_id(Required)- The id of the photo to set location data for.
lat(Required)- The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated.
lon(Required)- The longitude whose valid range is -180 to 180. Anything more than 6 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. Defaults to 16 if not specified.
context(Optional)- Context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to indicate that a photo was taken "indoors" or "outdoors".
The current list of context IDs is :- 0, not defined.
- 1, indoors.
- 2, outdoors.
The default context for geotagged photos is 0, or "not defined"
Example Response
This method has no specific response - It returns an empty success response if it completes without error.
Error Codes
1: Photo not found- The photo id was either invalid or was for a photo not viewable by the calling user.
2: Required arguments missing.- Some or all of the required arguments were not supplied.
3: Not a valid latitude.- The latitude argument failed validation.
4: Not a valid longitude.- The longitude argument failed validation.
5: Not a valid accuracy.- The accuracy argument failed validation.
6: Server error.- There was an unexpected problem setting location information to the photo.
7: User has not configured default viewing settings for location data.- Before users may assign location data to a photo they must define who, by default, may view that information. Users can edit this preference athttp://www.flickr.com/account/geo/privacy/
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.