The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Geo-Google-Latitude-0.07
/ Geo::Google::Latitude

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); #[]

url

Returns the URL for the Goole Latitude API

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 General Public License (GPL)
  Version 2, June 1991

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