• NAME
• VERSION
• SYNOPSIS
• USAGE POLICY
• SUBROUTINES/METHODS
  • geocode
  • get_name
• AUTHOR
• BUGS
• SUPPORT
• ACKNOWLEDGEMENTS
• LICENSE AND COPYRIGHT

NAME

Geo::Coder::Many::OSM - OpenStreetMap Nominatim plugin for Geo::Coder::Many

VERSION

Version 0.01

SYNOPSIS

This module adds OpenStreetMap Nominatim support to Geo::Coder::Many.

Use as follows:

    use Geo::Coder::Many;
    use Geo::Coder::OSM;
    use Geo::Coder::Many::OSM;
    
    my $options = { };
    my $geocoder_multi = Geo::Coder::Many->new( $options );
    my $osm = Geo::Coder::OSM->new;
    
    my $osm_options = {
        geocoder    => $osm,
    # This limit should not be taken as necessarily valid. Check the Nominatim usage policy.
        daily_limit => 5000,
    };
    
    $geocoder_multi->add_geocoder( $osm_options );
    
    my $location = $geocoder_multi->geocode( { location => '82 Clerkenwell Road, London, EC1M 5RF' } );

USAGE POLICY

Be careful to limit the number of requests you send, or risk being blocked.

See http://wiki.openstreetmap.org/wiki/Nominatim#Usage_Policy for details.

SUBROUTINES/METHODS

geocode

This is called by Geo::Coder::Many - it sends the geocoding request (via Geo::Coder::OSM) 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

AUTHOR

Dan Horgan, <cpan at lokku.com>

BUGS

Please report any bugs or feature requests to bug-geo-coder-multiple-osm at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Geo-Coder-Many-OSM. 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::Many::OSM

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Geo-Coder-Many-OSM

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Geo-Coder-Many-OSM

• CPAN Ratings

  http://cpanratings.perl.org/d/Geo-Coder-Many-OSM

• Search CPAN

  http://search.cpan.org/dist/Geo-Coder-Many-OSM/

ACKNOWLEDGEMENTS

This module is based on the Geo::Coder::Many::* modules that are provided with Geo::Coder::Many. It is, of course, useless without Geo::Coder::Many and Geo::Coder::OSM.

LICENSE AND COPYRIGHT

Copyright 2010 Lokku Ltd.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.