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_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_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->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.95
DATE
    $Date: 2006/11/18 16:25:26 $
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.