NAME Net::Flickr::RDF - a.k.a RDF::Describes::Flickr SYNOPSIS use Net::Flickr::RDF; use Config::Simple; use IO::AtomicFile; my $cfg = Config::Simple->new("/path/to/my.cfg"); my $rdf = Net::Flickr::RDF->new($cfg); my $fh = IO::AtomicFile->open("/foo/bar.rdf","w"); $rdf->describe_photo({photo_id => 123, secret => 567, fh => \*$fh}); $fh->close(); DESCRIPTION Describe Flickr photos as RDF. This package inherits from *Net::Flickr::API*. OPTIONS Options are passed to Net::Flickr::Backup using a Config::Simple object or a valid Config::Simple config file. Options are grouped by "block". flickr * api_key String. *required* A valid Flickr API key. * api_secret String. *required* A valid Flickr Auth API secret key. * auth_token String. *required* A valid Flickr Auth API token. PACKAGE METHODS __PACKAGE__->new($cfg) Where $cfg is either a valid *Config::Simple* object or the path to a file that can be parsed by *Config::Simple*. Returns a *Net::Flickr::RDF* object. PACKAGE METHODS YOU MAY CARE ABOUT __PACKAGE__->build_photo_uri(\%data) Returns a URL as a string. __PACKAGE__->build_user_tag_uri(\@data) Returns a URL as a string. __PACKAGE__->build_global_tag_uri(\@data) Returns a URL as a string. __PACKAGE__->build_user_uri($user_id) Returns a URL as a string. __PACKAGE__->build_group_uri($group_id) Returns a URL as a string. __PACKAGE__->build_grouppool_uri($group_id) Returns a URL as a string. __PACKAGE__->build_photoset_uri(\%set_data) Returns a URL as a string. __PACKAGE__->prune_triples(\@triples) Removes duplicate triples from *@triples*. Returns an array reference. OBJECT METHODS YOU SHOULD CARE ABOUT $obj->describe_photo(\%args) Valid arguments are : * photo_id Int. *required* * secret String. * fh File-handle. Default is STDOUT. Returns true or false. OBJECT METHODS YOU MAY CARE ABOUT $obj->collect_photo_data($photo_id,$secret) Returns a hash ref of the meta data associated with a photo. If any errors are unencounter an error is recorded via the log method and the method returns undef. $obj->collect_group_data($group_id) Returns a hash ref of the meta data associated with a group. If any errors are unencounter an error is recorded via the log method and the method returns undef. $obj->collect_user_data($user_id) Returns a hash ref of the meta data associated with a user. If any errors are unencounter an error is recorded via the log method and the method returns undef. $obj->collect_photoset_data($photoset_id) Returns a hash ref of the meta data associated with a photoset. If any errors are unencounter an error is recorded via the log method and the method returns undef. $obj->collect_cc_data() Returns a hash ref of the Creative Commons licenses used by Flickr. If any errors are unencounter an error is recorded via the log method and the method returns undef. $obj->collect_comment_data() Returns a hash ref of comments made about a photo. $obj->make_photo_triples(\%data) Returns an array ref (or alist in a wantarray context) of array refs of the meta data associated with a photo (*%data*). $obj->make_user_triples(\%user_data) Returns an array ref (or list in a wantarray context) of array refs of the meta data associated with a user (*%user_data*). $obj->make_tag_triples(\@tag_data) Returns an array ref (or list in a wantarray context) of array refs of the meta data associated with a tag (*@tag_data*). $pkg->make_photoset_triples(\%set_data) Returns an array ref (or list in a wantarray context) of array refs of the meta data associated with a photoset (*%set_data*). $obj->make_group_triples(\%group_data) Returns an array ref (or list in a wantarray context) of array refs of the meta data associated with a group (*%group_data*). $obj->make_grouppool_triples(\%group_data) Returns an array ref (or list in a wantarray context) of array refs of the meta data associated with a group pool (*%group_data*). $obj->make_cc_triples($url) Returns an array ref (or list in a wantarray context) of array refs of the meta data associated with a Creative Commons license (*$url*). $obj->make_comment_triples(\%data) Returns an array ref (or alist in a wantarray context) of array refs of the meta data associated with a photo comment (*%data*). $obj->geodata_from_tags(\%data) Try to parse out geolocative data from a collection of tag data. Returns a hash ref (containing 'lat' and 'long' keys) on success or undef if there were no matches. $obj->namespaces() Returns a hash ref of the prefixes and namespaces used by *Net::Flickr::RDF* The default key/value pairs are : a http://www.w3.org/2000/10/annotation-ns acl http://www.w3.org/2001/02/acls# atom http://www.w3.org/2005/Atom/ cc http://web.resource.org/cc/ dc http://purl.org/dc/elements/1.1/ dcterms http://purl.org/dc/terms/ exif http://nwalsh.com/rdf/exif# exifi http://nwalsh.com/rdf/exif-intrinsic# flickr x-urn:flickr: foaf http://xmlns.com/foaf/0.1/# geo http://www.w3.org/2003/01/geo/wgs84_pos# i http://www.w3.org/2004/02/image-regions# rdf http://www.w3.org/1999/02/22-rdf-syntax-ns# rdfs http://www.w3.org/2000/01/rdf-schema# skos http://www.w3.org/2004/02/skos/core# $obj->namespace_prefix($uri) Return the namespace prefix for *$uri* $obj->uri_shortform($prefix,$name) Returns a string in the form of *prefix*:*property*. The property is the value of $name. The prefix passed may or may be the same as the prefix returned depending on whether or not the user has defined or redefined their own list of namespaces. Unless this package is subclassed the prefix passed to the method is assumed to be one of prefixes in the default list of namespaces. $obj->api_call(\%args) Valid args are : * method A string containing the name of the Flickr API method you are calling. * args A hash ref containing the key value pairs you are passing to *method* If the method encounters any errors calling the API, receives an API error or can not parse the response it will log an error event, via the log method, and return undef. Otherwise it will return a *XML::LibXML::Document* object (if XML::LibXML is installed) or a *XML::XPath* object. $obj->log() Returns a *Log::Dispatch* object. $obj->serialise_triples(\@triples,\*$fh) Print *@triples* as RDF/XML to a filehandle (*$fh*). If no filehandle is defined, prints to STDOUT. $obj->serialize_triples(\@triples,\*$fh) An alias for *serialise_triples* VERSION 1.7 DATE $Date: 2006/05/31 01:02:06 $ AUTHOR Aaron Straup Cope EXAMPLES CONFIG FILES This is an example of a Config::Simple file used to collect RDF data from Flickr [flickr] api_key=asd6234kjhdmbzcxi6e323 api_secret=s00p3rs3k3t auth_token=123-omgwtf4u RDF This is an example of an RDF dump for a photograph backed up from Flickr : -122.417068 visbility 37.7742 2005-08-02T18:12:19-0700 20050802(007).jpg public 2005-08-02T18:16:20-0700 Square 75 75 california 6065-30763528-8400103 2005-08-02T18:52:23 moooaahahaahahmooo b2310525591ca71b1cb9c2e3226dec1765d76c1e karlcow 326 181 97 25 Did you see that this shirt makes me a beautiful breast? 9 205 145 55 Do you want my opinion? There's a love affair going on here… Anyway. Talking non sense. We all know Heather is committed to Flickr. She even only dresses at FlickrApparel. Did they say "No Logo". Doh Dude. Flickr 00d5b413e52b4d7d35dc982102c49e930a0ef631 George Oates George 355 31 103 95 (Yes… I love you heather, you are my dream star) usa california geotagged san francisco sanfrancisco 479d12dec2090705278d8b2af2c50ac2c46b94d4 heather powazek champ heather geotagged Medium 375 500 geolat377742 202 224 50 50 dude! who did this? cameraphone a4d1b5e38db5e2ed4f847f9f09fd51cf59bc0d3f Aaron Straup Cope straup 468 141 22 26 *sigh* usa cameraphone 32 100/100 1250 1280 336/100 960 4.5 mm 2005-08-02T18:12:19PDT sRGB f/3.2 2005-08-02T18:12:19PDT 4321/1000 0.05 sec (263/5260) High gain up 357 193 81 28 eww! sanfrancisco 6065-30763528-8399772 2005-08-02T18:44:52 "you have been note-spammed by a passing mad cow..." :) Small 180 240 geolong122417068 184 164 50 50 Baaaaarp! Thumbnail 75 100 433 103 50 50 (fuck… fuck…) e0d207bb5643d4d7dd60e72d4ce2a94bae0e13b6 Boris Anthony bopuc geolong122417068 aaronland geolat377742 Original 960 1280 342 197 28 33 Is that just one big boob, or...? SEE ALSO Net::Flickr::API RDF::Simple TO DO * Methods for describing more than just a photo; groups, tags, etc. * Update bounding boxes to be relative to individual images * Proper tests Patches are welcome. BUGS Please report all bugs via http://rt.cpan.org/ LICENSE Copyright (c) 2005-2006 Aaron Straup Cope. All Rights Reserved. This is free software. You may redistribute it and/or modify it under the same terms as Perl itself.