Flickr.Photos

flickr.photos API, searching, managing and access a user's photos. http://www.flickr.com/services/api/

Documentation

addTags :: PhotoID -> [Tag] -> FM ()

Add tags to a photo.

delete :: PhotoID -> FM ()

Delete a photo from flickr.

getAllContexts :: PhotoID -> FM ([Photoset], [PhotoPool])

Returns all visible sets and pools the photo belongs to.

getContactsPhotos :: Maybe Int -> Maybe Bool -> Maybe Bool -> Maybe Bool -> [PhotoInfo] -> FM [Photo]

Fetch a list of recent photos from the calling users' contacts.

getContactsPublicPhotos :: Maybe Int -> Maybe Bool -> Maybe Bool -> Maybe Bool -> [PhotoInfo] -> FM [Photo]

Fetch a list of recent public photos from a users' contacts.

getContext :: PhotoID -> FM (Photo, Photo)

Fetch a list of recent photos from the calling users' contacts.

getCounts :: [DateString] -> [DateString] -> FM [PhotoCount]

Gets a list of photo counts for the given date ranges for the calling user.

getExif :: PhotoID -> Maybe String -> FM [EXIF]

Retrieves a list of EXIFTIFFGPS tags for a given photo. The calling user must have permission to view the photo.

getFavorites :: PhotoID -> FM [(User, Date)]

Returns the list of people who have favorited a given photo.

getInfo :: PhotoID -> Maybe String -> FM PhotoDetails

Get information about a photo. The calling user must have permission to view the photo.

getNotInSet :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe MediaType -> [PhotoInfo] -> FM [Photo]

Returns a list of your photos that are not part of any sets.

getPerms :: PhotoID -> FM Permissions

Get permissions for a photo.

getRecent :: [PhotoInfo] -> FM [Photo]

Returns a list of the latest public photos uploaded to flickr.

getSizes :: PhotoID -> FM [SizeDetails]

Returns the available sizes for a photo. The calling user must have permission to view the photo.

getUntagged :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe MediaType -> [PhotoInfo] -> FM [Photo]

Returns a list of your photos with no tags.

getWithGeoData :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe SortKey -> Maybe MediaType -> [PhotoInfo] -> FM [Photo]

Returns a list of your geo-tagged photos.

getWithoutGeoData :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe SortKey -> Maybe MediaType -> [PhotoInfo] -> FM [Photo]

Returns a list of your photos which haven't been geo-tagged.

recentlyUpdated :: DateString -> [PhotoInfo] -> FM (PhotoContext, [Photo])

Return a list of your photos that have been recently created or which have been recently modified. Recently modified may mean that the photo's metadata (title, description, tags) may have been changed or a comment has been added (or just modified somehow :-)

removeTag :: Tag -> FM ()

Remove a tag from a photo.

search :: Maybe UserID -> SearchConstraints -> [PhotoInfo] -> FM (PhotoContext, [Photo])

Return a list of photos matching some criteria. Only photos visible to the calling user will be returned. To return private or semi-private photos, the caller must be authenticated with read permissions, and have permission to view the photos. Unauthenticated calls will only return public photos.

data SearchConstraints

Constructors

SearchConstraints

Fields

s_tags :: [Tag]

s_tag_mode :: Maybe Bool

s_text :: Maybe String

s_upload :: Maybe DateInterval

s_taken :: Maybe DateInterval

s_license :: Maybe [LicenseID]

s_sort :: Maybe SortKey

s_privacy :: Maybe Privacy

s_bbox :: Maybe BoundingBox

s_accuracy :: Maybe Accuracy

s_safe_search :: Maybe Safety

s_content_type :: Maybe ContentType

s_machine_tags :: [Tag]

s_machine_tag_mode :: Maybe Bool

s_group_id :: Maybe GroupID

s_contacts :: Maybe Bool

s_woe_id :: Maybe WhereOnEarthID

s_place_id :: Maybe PlaceID

s_media :: Maybe MediaType

s_has_geo :: Maybe Bool

s_lat :: Maybe Decimal

s_lon :: Maybe Decimal

s_radius :: Maybe Decimal

s_radius_units :: Maybe String

nullSearchConstraints :: SearchConstraints

setContentType :: PhotoID -> ContentType -> FM ()

Set the content type of a photo.

setDates :: PhotoID -> Maybe DateString -> Maybe DateString -> Maybe DateGranularity -> FM ()

Set one or both of the dates for a photo.

setMeta :: PhotoID -> Title -> Description -> FM ()

Set the meta information for a photo.

setPerms :: PhotoID -> Permissions -> FM ()

Set permissions for a photo.

setSafetyLevel :: PhotoID -> Maybe Safety -> Maybe Bool -> FM ()

Set the safety level of a photo.

setTags :: PhotoID -> [Tag] -> FM ()

Set the tags for a photo.

getPhotoURL :: PhotoDetails -> URLString

locate the URL for the photo..local, non-Flickr, helper function. Returns '<unknown>' if cannot be located.