NAME

Geo::Google::Latitude - Retrieves a Google Latitude Public Location Badge

SYNOPSIS

  use Geo::Google::Latitude;
  my $gl=Geo::Google::Latitude->new;
  my $id="7832225593622256926"; 
  my $badge=$gl->get($id); #isa L<Geo::Google::Latitude::Badge>
  printf "Time: %s, Lat: %s, Lon: %s\n", $badge->point->datetime,
                                         $badge->point->latlon;

DESCRIPTION

Perl Object Interface to the Google Latitude Public Location Badge. In order to enable Google Latitude on your mobile device, download Google Maps Mobile and set the permission to share to the public.

USAGE

  use Geo::Google::Latitude;

CONSTRUCTOR

new

Returns a Geo::Google::Latitude blessed object. If you need to override the API URL you may do so with the optional url parameter.

  my $gl=Geo::Google::Latitude->new;
  my $gl=Geo::Google::Latitude->new(url=>"http://www.google.com/latitude/apps/badge/api");

METHODS

get

Fetches the Google Latitude Public Location Badge from google.com and returns a Geo::Google::Latitude::Badge object initialized with the returned JSON encoded data.

  my $badge=$gl->get($id); #isa L<Geo::Google::Latitude::Badge>

getList

Returns a list of Geo::Google::Latitude::Badge objects with just one HTTP request.

  my @badge=$gl->getList($id1, $id2, $id3); #()
  my $badge=$gl->getList($id1, $id2, $id3); #[]

LIMITATIONS

The getList method has a limit as to the number of badges that can be returned. But, I have know idea what that upper limit would be. The length of a URL is typically limited to 2048 bytes and the few IDs that I have seen are 20 characters long. So, we should be able to support more than 90 IDs in one URL accounting for overhead and comma separators.

BUGS

Log and send to Geo Perl.

SUPPORT

Try Geo Perl.

AUTHOR

    Michael R. Davis
    CPAN ID: MRDVT
    STOP, LLC
    domain=>michaelrdavis,tld=>com,account=>perl
    http://www.stopllc.com/

COPYRIGHT

This program is free software licensed under the...

        The BSD License

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

SEE ALSO

http://www.google.com/latitude/apps/badge, http://www.ruwenzori.net/code/latitude2brightkite/, LWP::Simple, URI, JSON::XS, GPS::Point, Geo::Google::Latitude::Badge