METHODS

new

Create a new object for the Tagzania API class.

  my $tagobj = new WebService::Tagzania::API() ;

query

Perform a query to the Tagzania API. Accepts a reference to a hash with the required query arguments.

  my $rh_params = {
    'start'  => 0,
    'number' => 10,
    'minlng' => -9.25,
    'minlat' => 35.35,
    'maxlng' => 4.55,
    'maxlat' => 43.80,
  } ;

  my $response = $tagobj->query( $rh_params ) ;
  

The required parameters are :

  start  => defined the element number of which to start from
  number => defined the number of total results to return
  minlng, maxlng, minlat, maxlat => coordinates of bounding box of location to query

  The Tagzania API returns well-formed XML. This will be present in the
  '_content' key of the response.

execute_query

internal function

NAME

WebService::Tagzania::API - Tagzania API Interface

SYNOPSIS

  use WebService::Tagzania::API;
  my $tagobj = new WebService::Tagzania::API() ;
  
  my $rh_params = {
    'start'  => 0,
    'number' => 200,
    'minlng' => -9.25,
    'minlat' => 35.35,
    'maxlng' => 4.55,
    'maxlat' => 43.80,
  } ;

  my $results = $api->query( $rh_params ) ;
  
  my $content = $results->{_content} ;
  
  # do something with the XML inside $content

DESCRIPTION

Tagzania is all about tags and places. Tagzania lets you create custom maps, add points of interest on them and share them with other users, all in an extremely easy fashion. This module provides a Perl OO-ish wrapper around the Tagzania.com API.

BUGS

None. That I know of ;)

AUTHOR

    Spiros Denaxas
    CPAN ID: SDEN
    Lokku Ltd
    s [dot] denaxas [@] gmail [dot]com
    http://idaru.blogspot.com
    http://www.nestoria.co.uk 

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO

WebService::Tagzania::Request, WebService::Tagzania::Response, http://www.tagzania.com