NAME

Geo::Coder::Many::PlaceFinder - Yahoo PlaceFinder plugin for Geo::Coder::Many

VERSION

Version 0.02

SYNOPSIS

This module adds Yahoo PlaceFinder support to Geo::Coder::Many.

Use as follows:

    use Geo::Coder::Many;
    use Geo::Coder::PlaceFinder;
    
    my $options = { };
    my $geocoder_many = Geo::Coder::Many->new( $options );
    my $place_finder = Geo::Coder::PlaceFinder->new( appid => 'YOUR_APP_ID' );
    
    my $place_finder_options = {
        geocoder    => $place_finder,
        daily_limit => 50000,
    };
    
    $geocoder_many->add_geocoder( $place_finder_options );
    
    my $location = $geocoder_many->geocode( 
        {
            location => '82 Clerkenwell Road, London, EC1M 5RF'
        }
    );

USAGE POLICY

As of writing, Yahoo PlaceFinder allows up to 50000 requests per day. This may change, so you should check the latest documentation to make sure you aren't going to get blocked.

http://developer.yahoo.com/geo/placefinder/

SUBROUTINES/METHODS

geocode

This is called by Geo::Coder::Many - it sends the geocoding request (via Geo::Coder::PlaceFinder) and extracts the resulting location, returning it in a standard Geo::Coder::Many::Response.

get_name

Returns the name of the geocoder type - used by Geo::Coder::Many