NAME

Geo::Coder::PlaceFinder - Geocode addresses with the Yahoo! BOSS PlaceFinder API

VERSION

Version 0.1

SYNOPSIS

Provides a thin Perl interface to the PlaceFinder Geocoding API.

        use Geo::Coder::PlaceFinder;

        my $geocoder = Geo::Coder::PlaceFinder->new(
                consumer_key => 'consumer_key_from_api_dashboard',
                secret_key => 'secret_key_from_api_dashboard'
        );

        my $location = $geocoder->geocode( { location => '701 1st Ave, Sunnyvale, CA 94089, USA' } );

OFFICIAL API DOCUMENTATION

Read more about the API at http://developer.yahoo.com/boss/geo

METHOD

new

Constructs a new Geo::Coder::PlaceFinder object and returns it. Requires PlaceFinder consumer and secret keys as arguments.

  KEY                                   VALUE
  -----------                   --------------------
  consumer_key                  PlaceFinder Consumer Key
  secret_key                    PlaceFinder Secret Key

geocode

Takes a location in a hashref as an argument and returns the lattitude and longitude of the specified location.

AUTHOR

Alistair Francis, http://www.alistairfrancis.com/

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10 or, at your option, any later version of Perl 5 you may have available.