Changes for version 0.51 - 2026-10-21

  • Bug Fixes
    • geocode() no longer hangs when OpenAddresses is configured and a location that matches the built-in alternatives table isn't found, such as "Chirton, Tyne and Wear, England". The hang came in with 0.50
    • An alternative is not tried again while it is already being tried, so an entry whose replacement still matches it cannot recurse forever
    • The alternatives table is read as written: "Borough of North Tyneside" is no longer looked up as "Borough, of, North, Tyneside" first
    • Error is now a runtime prerequisite; Geo::Coder::Free::Utils, which every user loads, has always needed it
  • Enhancements
    • Config::Auto is no longer needed
    • The US states and counties lists that createdatabase.PL imports are now in the distribution; before, a build from CPAN silently skipped them
  • Documentation
    • LIMITATIONS no longer describes the alternatives loop missing a match on a repeated call; it walks a sorted list of keys and always finds it
  • Tests
    • t/transaction.t checks that an alternative which finds nothing returns, and that the same input finds the same alternative every time

Documentation

Modules

Geocoding using free, locally-hosted databases
Site-independent configuration file for the Versatile Web Framework
driver for http://download.geonames.org/export/dump/admin1CodesASCII.txt
driver for http://download.geonames.org/export/dump/admin2Codes.txt
driver for https://www.maxmind.com/en/free-world-cities-database
driver for http://results.openaddresses.io/
interface to data from http://results.openaddresses.io/
Driver for /tmp/vwf.log
Geocode using user-curated local data
Provides a geocoding functionality using the MaxMind and GeoNames databases
process-level memory of lookups that found nothing
The provenance keys that every Geo::Coder::Free result carries
Random subroutines for Geo::Coder::Free

Provides

in lib/Geo/Coder/Free/Allow.pm
in lib/Geo/Coder/Free/Display.pm
in lib/Geo/Coder/Free/Display/index.pm
in lib/Geo/Coder/Free/Display/meta_data.pm
in lib/Geo/Coder/Free/Display/query.pm