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