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. rdf * query_geonames Boolean. If true and a photo has geodata (latitude, longitude) associated with it, then the geonames.org database will be queried for a corresponding match. Data will be added as properties of the photo's geo:Point description. For example : -122.025151 16 visbility 37.417839 public PPLX US CA California Santa Clara 2 Default is false. * Boolean. If true, the trynt colour extraction web service will be queried with the URL for the "medium" sized photo. Each colour will be added as it's own description, referenced from the photo's principal description. For example : c0c0c0 654 Default is false. 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_geo_uri(\%data) __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_machinetag_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_geo_triples(\%geo_data) $obj->make_flickrplaces_triples(\%geo_data) $obj->make_geonames_triples(\%geo_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# geoname http://www.geonames.org/onto# 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# trynt http://www.trynt.com# ymaps urn:yahoo:maps $obj->add_namespace($prefix, $namespace) Add a prefix and namespace URI to the list of known namespaces. This method returns a string containing the prefix you should use for the namespace URI passed. If the prefix passed to the method is already reserved for another namespace the method will return the following string: "nfr_" + I $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 2.01 DATE $Date: 2007/09/01 19:11:12 $ 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 : 2fc2c76d7634d1a6446b1898bf5471205ed3d0cb thincvox filtr PPLX US CA 58 State of California San Francisco County feature geonames Original 1944 2592 cameraphone filtr Flash did not fire, auto mode 100/100 100 2592 297/100 1944 5.6 mm 2007-05-30T15:10:01PDT sRGB f/2.8 2007-05-30T15:10:01PDT 4351/1000 0.049 sec (49/1000) 604040 472 000000 4841 san francisco sanfrancisco sanfrancisco Medium 375 500 5405296 cameraphone LOG (2007) 6065-522214395-72157600293655654 2007-05-31T14:54:25 Kittens! 587a68f90c4030a9b0c7d8ca6ff8549a8b40e5cd Aaron Straup Cope straup n95 6065-522214395-72157600295486776 2007-06-01T00:19:05 here kitty, kitty, <a href="http://thincvox.com/audio_recordings/meow.mp3">meow</a> 5405296 process filtr debug geo filtr namespace test visbility Untitled #1180563722 n95 All rights reserved. public 2007-05-30T15:10:01-0700 2007-05-30T15:18:39-0700 5405296 Thumbnail 75 100 -122.401937 visbility 37.794694 16 public filtr 808080 726 a08080 575 000020 499 402020 749 n95 2.0:1180823550 2007-06-02T15:32:30-0700 filtr namespace test 200000 841 Small 180 240 806060 464 camera ph Square 75 75 Large 768 1024 c0a0a0 488 San Francisco United States California San Francisco c0c0c0 1475 namespace test 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-2007 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.