NAME

Geo::Address::Parser - Lightweight country-aware address parser from flat text

VERSION

Version 0.02

SYNOPSIS

use Geo::Address::Parser;

my $parser = Geo::Address::Parser->new(country => 'US');

my $result = $parser->parse("Mastick Senior Center, 1525 Bay St, Alameda, CA");

DESCRIPTION

This module extracts address components from flat text input. It supports lightweight parsing for the US, UK, Canada, Australia, and New Zealand, using country-specific regular expressions.

METHODS

new(country => $code)

Creates a new parser for a specific country (US, UK, CA, AU, NZ).

parse($text)

Parses a flat string and returns a hashref with the following fields:

  • name

  • street

  • city

  • region

  • country

LICENCE AND COPYRIGHT

Copyright 2025 Nigel Horne.

Usage is subject to licence terms.

The licence terms of this software are as follows:

  • Personal single user, single computer use: GPL2

  • All other users (including Commercial, Charity, Educational, Government) must apply in writing for a licence for use from Nigel Horne at the above e-mail.