flickrex v0.3.0 Flickr.Photos.Geo
Summary
Functions
Correct the places hierarchy for all the photos for a user at a given latitude, longitude and accuracy.
Get the geo data (latitude and longitude and the accuracy level) for a photo
Get permissions for who may view geo data for a photo
Return a list of photos for the calling user at a specific latitude, longitude and accuracy
Removes the geo data associated with a photo
Indicate the state of a photo’s geotagginess beyond latitude and longitude.
Note : photos passed to this method must already be geotagged (using the flickr.photos.geo.setLocation
method)
Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo
Set the permission for who may view the geo data associated with a photo
Types
Functions
Correct the places hierarchy for all the photos for a user at a given latitude, longitude and accuracy.
Batch corrections are processed in a delayed queue so it may take a few minutes before the changes are reflected in a user’s photos.
This method requires authentication with “write” permission.
Arguments
lat
- (required) The latitude of the photos to be update whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated.lon
- (required) The longitude of the photos to be updated whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated.accuracy
- (required) Recorded accuracy level of the photos to be updated. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. Defaults to 16 if not specified.place_id
- A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)woe_id
- A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)
This method requires authentication with “write” permission.
Arguments
photo_id
- (required) The ID of the photo whose WOE location is being corrected.place_id
- A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)woe_id
- A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)foursquare_id
- (required) The venue ID for a Foursquare location. (If not passed in with correction, any existing foursquare venue will be removed).
Get the geo data (latitude and longitude and the accuracy level) for a photo.
This method does not require authentication.
Arguments
photo_id
- (required) The id of the photo you want to retrieve location data for.extras
- Extra flags.
Get permissions for who may view geo data for a photo.
This method requires authentication with “read” permission.
Arguments
photo_id
- (required) The id of the photo to get permissions for.
Return a list of photos for the calling user at a specific latitude, longitude and accuracy
This method requires authentication with “read” permission.
Arguments
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
- 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.extras
- A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are:description
,license
,date_upload
,date_taken
,owner_name
,icon_server
,original_format
,last_update
,geo
,tags
,machine_tags
,o_dims
,views
,media
,path_alias
,url_sq
,url_t
,url_s
,url_q
,url_m
,url_n
,url_z
,url_c
,url_l
,url_o
per_page
- Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.page
- The page of results to return. If this argument is omitted, it defaults to 1.
Removes the geo data associated with a photo.
This method requires authentication with “write” permission.
Arguments
photo_id
- (required) The id of the photo you want to remove location data from.
Indicate the state of a photo’s geotagginess beyond latitude and longitude.
Note : photos passed to this method must already be geotagged (using the flickr.photos.geo.setLocation
method).
This method requires authentication with “write” permission.
Arguments
photo_id
- (required) The id of the photo to set context data for.context
- (required) 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.
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 at http://www.flickr.com/account/geo/privacy/. If a user has not set this preference, the API method will return an error.
This method requires authentication with “write” permission.
Arguments
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
- 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
- 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”
Set the permission for who may view the geo data associated with a photo.
This method requires authentication with “write” permission.
Arguments
is_public
- (required) 1 to set viewing permissions for the photo’s location data to public, 0 to set it to private.is_contact
- (required) 1 to set viewing permissions for the photo’s location data to contacts, 0 to set it to private.is_friend
- (required) 1 to set viewing permissions for the photo’s location data to friends, 0 to set it to private.is_family
- (required) 1 to set viewing permissions for the photo’s location data to family, 0 to set it to private.photo_id
- (required) The id of the photo to get permissions for.