/ 
Geo-Address-Parser-0.03
/ Geo::Address::Parser

NAME

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

VERSION

Version 0.03

METHODS

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.

new(country => $code)

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

FORMAL SPECIFICATION

[COUNTRY]

GeoAddressParserNew
====================
country? : COUNTRY
supported : ℙ COUNTRY
parser! : Parser

supported = {US, UK, CA, AU, NZ}
country? ∈ supported
parser! = parserFor(country?)

parse($text)

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

  • name

  • street

  • city

  • region

  • country

FORMAL SPECIFICATION

[TEXT, COUNTRY, FIELD, VALUE]

GeoAddressParserState
======================
country : COUNTRY
parser : COUNTRY ↛ (TEXT ↛ FIELD ↛ VALUE)

GeoAddressParserParse
======================
ΔGeoAddressParserState
text? : TEXT
result! : FIELD ↛ VALUE

text? ≠ ∅
country ∈ dom parser
result! = (parser(country))(text?)
result!("country") = 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.