jshirley / geo-coder-any Goto Github PK

NAME
    Geo::Coder::Any - Use flexible (and custom) geocoders

VERSION
    Version 0.01

SYNOPSIS
    Geo::Coder::Any is a processing pipeline for coupling and normalizing
    Geo::Coder modules. Geo::Coder::Google and Geo::Coder::Yahoo support is
    shipped within this module.

        use Geo::Coder::Any;

        my $ga = Geo::Coder::Any->new();
        my $results = $ga->geocode('1600 Pennsylvania Ave Washington DC');

ATTRIBUTES
  steps

    A step is an individual geocoder that will attempt a lookup and returns
    a match or if no match is found it is to return undef.

steps
    This is configured upon creation, such as:

        Geo::Coder::Any->new(
            steps => [ 
                'Google' => { api_key => 'abcdef' },
                'Yahoo'  => { api_key => 'byah'   },
            ]
        );

METHODS
  geocode($address)

    Iterate through the steps (see definition above) until we get a valid
    response.

INTERNAL METHODS
    Here be dragons, you've been warned. =head2 BUILD

    Setup the Geo::Coder::Any object and the steps.

    Construction is:

     Geo::Coder::Any->new(
        steps => [
            'Google' => {
                api_key => 'abcdefghjijklmnopqrstuvwxyz'
            },
            'Yahoo'  => {
                appid => 'wharrrrgarrrrgarrrrgarrrrrbllll'
             },
        ] 
     );

AUTHOR
    J. Shirley `<[email protected]>'

    Devin Austin `<[email protected]>'

BUGS
    Please report any bugs or feature requests to `bug-geo-coder-any at
    rt.cpan.org', or through the web interface at
    http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Geo-Coder-Any. I will be
    notified, and then you'll automatically be notified of progress on your
    bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc Geo::Coder::Any

    You can also look for information at:

    * RT: CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Geo-Coder-Any

    * AnnoCPAN: Annotated CPAN documentation
        http://annocpan.org/dist/Geo-Coder-Any

    * CPAN Ratings
        http://cpanratings.perl.org/d/Geo-Coder-Any

    * Search CPAN
        http://search.cpan.org/dist/Geo-Coder-Any

ACKNOWLEDGEMENTS
COPYRIGHT & LICENSE
    Copyright 2009 The Authors, all rights reserved.

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