flickr-0.3.3: Haskell binding to the Flickr API Source code Contents Index

Flickr.Photos Portability portable Stability provisional Maintainer Sigbjorn Finne <sof@forkIO.com>

Description

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

Synopsis

addTags :: PhotoID -> [Tag] -> FM () delete :: PhotoID -> FM () getAllContexts :: PhotoID -> FM ([Photoset], [PhotoPool]) getContactsPhotos :: Maybe Int -> Maybe Bool -> Maybe Bool -> Maybe Bool -> [PhotoInfo] -> FM [Photo] getContactsPublicPhotos :: Maybe Int -> Maybe Bool -> Maybe Bool -> Maybe Bool -> [PhotoInfo] -> FM [Photo] getContext :: PhotoID -> FM (Photo, Photo) getCounts :: [DateString] -> [DateString] -> FM [PhotoCount] getExif :: PhotoID -> Maybe String -> FM [EXIF] getFavorites :: PhotoID -> FM [(User, Date)] getInfo :: PhotoID -> Maybe String -> FM PhotoDetails getNotInSet :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe MediaType -> [PhotoInfo] -> FM [Photo] getPerms :: PhotoID -> FM Permissions getRecent :: [PhotoInfo] -> FM [Photo] getSizes :: PhotoID -> FM [SizeDetails] getUntagged :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe MediaType -> [PhotoInfo] -> FM [Photo] getWithGeoData :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe SortKey -> Maybe MediaType -> [PhotoInfo] -> FM [Photo] getWithoutGeoData :: Maybe DateInterval -> Maybe DateInterval -> Maybe Privacy -> Maybe SortKey -> Maybe MediaType -> [PhotoInfo] -> FM [Photo] recentlyUpdated :: DateString -> [PhotoInfo] -> FM (PhotoContext, [Photo]) removeTag :: Tag -> FM () search :: Maybe UserID -> SearchConstraints -> [PhotoInfo] -> FM (PhotoContext, [Photo]) data SearchConstraints = SearchConstraints { 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 s_is_commons :: Maybe Bool } nullSearchConstraints :: SearchConstraints setContentType :: PhotoID -> ContentType -> FM () setDates :: PhotoID -> Maybe DateString -> Maybe DateString -> Maybe DateGranularity -> FM () setMeta :: PhotoID -> Title -> Description -> FM () setPerms :: PhotoID -> Permissions -> FM () setSafetyLevel :: PhotoID -> Maybe Safety -> Maybe Bool -> FM () setTags :: PhotoID -> [Tag] -> FM () getPhotoURL :: PhotoDetails -> URLString

Documentation

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

Add tags to a photo.

delete :: PhotoID -> FM () Source

Delete a photo from flickr.

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

Returns all visible sets and pools the photo belongs to.

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

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

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

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

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

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

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

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

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

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)] Source

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

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

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] Source

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

getPerms :: PhotoID -> FM Permissions Source

Get permissions for a photo.

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

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

getSizes :: PhotoID -> FM [SizeDetails] Source

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] Source

Returns a list of your photos with no tags.

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

Returns a list of your geo-tagged photos.

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

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

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

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 () Source

Remove a tag from a photo.

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

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 Source

Constructors SearchConstraints 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 s_is_commons :: Maybe Bool

nullSearchConstraints :: SearchConstraints Source

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

Set the content type of a photo.

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

Set one or both of the dates for a photo.

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

Set the meta information for a photo.

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

Set permissions for a photo.

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

Set the safety level of a photo.

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

Set the tags for a photo.

getPhotoURL :: PhotoDetails -> URLString Source

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

Produced by Haddock version 2.6.0