Geo::Coder::Free::Maxmind - Provides a geocoding functionality using the MaxMind and GeoNames databases
Version 0.03
use Geo::Coder::Free::MaxMind; my $geocoder = Geo::Coder::Free::MaxMind->new(); my $location = $geocoder->geocode(location => 'Ramsgate, Kent, UK');
Geo::Coder::Free::MaxMind provides an interface to free databases.
Refer to the source URL for licencing information for these files: cities.csv is from https://www.maxmind.com/en/free-world-cities-database; admin1.db is from http://download.geonames.org/export/dump/admin1CodesASCII.txt; admin2.db is from http://download.geonames.org/export/dump/admin2Codes.txt;
See also http://download.geonames.org/export/dump/allCountries.zip
To significantly speed this up, gunzip cities.csv and run it through the db2sql script to create an SQLite file.
$geocoder = Geo::Coder::Free::MaxMind->new();
Takes one optional parameter, directory, which tells the library where to find the files admin1db, admin2.db and cities.[sql|csv.gz]. If that parameter isn't given, the module will attempt to find the databases, but that can't be guaranteed
$location = $geocoder->geocode(location => $location); print 'Latitude: ', $location->{'latitude'}, "\n"; print 'Longitude: ', $location->{'longitude'}, "\n"; # TODO: # @locations = $geocoder->geocode('Portland, USA'); # diag 'There are Portlands in ', join (', ', map { $_->{'state'} } @locations);
$location = $geocoder->reverse_geocode(latlng => '37.778907,-122.39732');
To be done.
Does nothing, here for compatibility with other geocoders
Nigel Horne <njh@bandsman.co.uk>
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Lots of lookups fail at the moment.
The MaxMind data only contains cities.
Can't parse and handle "London, England".
VWF, MaxMind and geonames.
Copyright 2017-2018 Nigel Horne.
The program code is released under the following licence: GPL for personal use on a single computer. All other users (including Commercial, Charity, Educational, Government) must apply in writing for a licence for use from Nigel Horne at `<njh at nigelhorne.com>`.
This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com
To install Geo::Coder::Free, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Geo::Coder::Free
CPAN shell
perl -MCPAN -e shell install Geo::Coder::Free
For more information on module installation, please visit the detailed CPAN module installation guide.