NAME

Geo::Coder::OpenCage - Geocode addresses with the OpenCage Geocoder API

DESCRIPTION

This module provides an interface to the OpenCage geocoding service.

SYNOPSIS

my $Geocoder = Geo::Coder::OpenCage->new(
    api_key => $my_api_key,
);

my $result = $Geocoder->geocode(location => "Donostia");

METHODS

new

my $Geocoder = Geo::Coder::OpenCage->new(
    api_key => $my_api_key,
);

You can get your API key from http://geocoder.opencagedata.com

geocode

Takes a single named parameter 'location' and returns a result hashref.

my result = $Geocoder->geocode(location => "Mudgee, Australia");

ENCODING

All strings passed to and recieved from Geo::Coder::OpenCage methods are expected to be character strings, not byte strings.

For more information see perlunicode.

AUTHOR

Alex Balhatchet, alex@lokku.com

COPYRIGHT AND LICENSE

Copyright 2014 Lokku Ltd <cpan@lokku.com>

Please check out all our open source work over at https://github.com/lokku and our developer blog: http://devblog.nestoria.com

Thanks!

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