NAME

Geo::libpostal - Perl bindings for libpostal

SYNOPSIS

use Geo::libpostal qw/parse_address expand_address/;

# normalize an address
my @addresses = expand_address('Quatre-vingt-douze Ave des Champs-Élysées');

# parse addresses into their components
my %address = parse_address('The Book Club 100-106 Leonard St Shoreditch London EC2A 4RH, United Kingdom');

# %address contains:
# (
#   'road'         => 'leonard st',
#   'postcode'     => 'ec2a 4rh',
#   'house'        => 'the book club',
#   'house_number' => '100-106',
#   'suburb'       => 'shoreditch',
#   'country'      => 'united kingdom',
#   'city'         => 'london'
# );

WARNING

libpostal uses setup() and teardown() functions - you may see delays in start and end of your program due to this.

Currently this module just loads the default libpostal config.

SEE ALSO

libpostal is required.

AUTHOR

© 2016 David Farrell

LICENSE

See LICENSE