Lingua::EN::AddressParse - routines for manipulating geographical addresses
use Lingua::EN::AddressParse; my %args = ( country => 'Australia', auto_clean => 1, force_case => 1 ); my $address = new Lingua::EN::AddressParse(%args); $error = $address->parse("14A MAIN RD. ST JOHNS WOOD NSW 2000"); %my_address = $address->components; $suburb = $my_address{suuburb}; $correct_casing = $address->case_all;
This module takes as input an address or post box in free format text such as,
12/3-5 AUBREY ST VERMONT VIC 3133 "OLD REGRET" WENTWORTH FALLS NSW 2782 AUSTRALIA 2A Low ST. KEW NSW 2123
and attempts to parse it. If successful, the address is broken down into components and useful functions can be performed such as :
converting upper or lower case values to name case (2 Low St. Kew NSW 2123 ) extracting the addresses individual components (2,Low St.,KEW,NSW,2123 ) determining the type of format the address is in ('suburban')
If the address cannot be parsed you have the option of cleaning the address of bad characters, or extracting any portion that was parsed and the portion that failed.
This module can be used for analysing and improving the quality of lists of addresses.
Perl, version 5.005 or higher Lingua::EN::NameParse Parse::RecDescent Locale::SubCountry
perl Makefile.PL make make test make install
Copyright (c) 2000 Kim Ryan. All rights reserved. This program is free software; you can redistribute it and/or modify it under the terms of the Perl Artistic License (see http://www.perl.com/perl/misc/Artistic.html).
AddressParse was written by Kim Ryan <kimaryan@ozemail.com.au> in 2000.
To install Lingua::EN::AddressParse, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Lingua::EN::AddressParse
CPAN shell
perl -MCPAN -e shell install Lingua::EN::AddressParse
For more information on module installation, please visit the detailed CPAN module installation guide.