Skip to content

Provides a geocoding functionality using https:://postcodes.io

License

Notifications You must be signed in to change notification settings

nigelhorne/Geo-Coder-Postcodes

Repository files navigation

Linux Build Status Windows Build Status Coverage Status CPAN Kritika Analysis Status

NAME

Geo::Coder::Postcodes - Provides a geocoding functionality using https://postcodes.io.

VERSION

Version 0.07

SYNOPSIS

  use Geo::Coder::Postcodes;

  my $geo_coder = Geo::Coder::Postcodes->new();
  my $location = $geo_coder->geocode(location => 'Margate');

DESCRIPTION

Geo::Coder::Postcodes provides an interface to postcodes.io, a free Geo-Coder database covering the towns in the UK.

METHODS

new

$geo_coder = Geo::Coder::Postcodes->new();
my $ua = LWP::UserAgent->new();
$ua->env_proxy(1);
$geo_coder = Geo::Coder::Postcodes->new(ua => $ua);

geocode

$location = $geo_coder->geocode(location => $location);

print 'Latitude: ', $location->{'latitude'}, "\n";
print 'Longitude: ', $location->{'logitude'}, "\n";

ua

Accessor method to get and set UserAgent object used internally. You can call env_proxy for example, to get the proxy information from environment variables:

$geo_coder->ua()->env_proxy(1);

You can also set your own User-Agent object:

use LWP::UserAgent::Throttled;
$geo_coder->ua(LWP::UserAgent::Throttled->new());

reverse_geocode

$location = $geo_coder->reverse_geocode(latlng => '37.778907,-122.39732');

Similar to geocode except it expects a latitude/longitude parameter.

BUGS

Note that this most only works on towns and cities, some searches such as "Margate, Kent, UK" may work, but you're best to search only for "Margate".

AUTHOR

Nigel Horne <njh@bandsman.co.uk>

Based on Geo::Coder::GooglePlaces.

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

Lots of thanks to the folks at postcodes.io.

SEE ALSO

Geo::Coder::GooglePlaces, HTML::GoogleMaps::V3

LICENSE AND COPYRIGHT

Copyright 2017-2022 Nigel Horne.

This program is released under the following licence: GPL2

About

Provides a geocoding functionality using https:://postcodes.io

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages