brian d foy > Business-US-USPS-WebTools-1.11 > Business::US::USPS::WebTools::AddressStandardization

Download:
Business-US-USPS-WebTools-1.11.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.11   Source  

NAME ^

Business::US::USPS::WebTools::AddressStandardization - canonicalize a US address

SYNOPSIS ^

        use Business::US::USPS::WebTools::AddressStandardization;

        my $verifier = Business::US::USPS::WebTools::AddressStandardization->new( {
                UserID   => $ENV{USPS_WEBTOOLS_USERID},
                Password => $ENV{USPS_WEBTOOLS_PASSWORD},
                Testing  => 1,
                } );
                
        my $hash = $verifier->verify_address(
                FirmName => '',
                Address1 => '',
                Address2 => '6406 Ivy Lane',
                City     => 'Greenbelt',  
                State    => 'MD',
                Zip5     => '',
                Zip4     => '',
                );

        if( $verifier->is_error )
                {
                warn "Oh No! $verifier->{error}{description}\n";
                }
        else
                {
                print join "\n", map { "$_: $hash->{$_}" } 
                        qw(FirmName Address1 Address2 City State Zip5 Zip4);
                }

DESCRIPTION ^

*** THIS IS ALPHA SOFTWARE ***

This module implements the Address Standardization web service from the US Postal Service. It is a subclass of Business::US::USPS::WebTools.

verify_address( KEY, VALUE, ... )

The verify_address method takes the following keys, which come directly from the USPS web service interface:

        FirmName        The name of the company
        Address1        The suite or apartment
        Address2        The street address
        City            The name of the city
        State           The two letter state abbreviation
        Zip5            The 5 digit zip code
        Zip4            The 4 digit extension to the zip code

It returns an anonymous hash with the same keys, but the values are the USPS's canonicalized address. If there is an error, the hash values will be the empty string, and the error flag is set. Check is with is_error:

        $verifier->is_error;

See the is_error documentation in Business::US::USPS::WebTools for more details on error information.

TO DO ^

SEE ALSO ^

Business::US::USPS::WebTools

The WebTools API is documented on the US Postal Service's website:

http://www.usps.com/webtools/htm/Address-Information.htm

SOURCE AVAILABILITY ^

This source is part of a SourceForge project which always has the latest sources in CVS, as well as all of the previous releases.

        http://sourceforge.net/projects/brian-d-foy/

If, for some reason, I disappear from the world, one of the other members of the project can shepherd this module appropriately.

AUTHOR ^

brian d foy, <bdfoy@cpan.org>

COPYRIGHT AND LICENSE ^

Copyright (c) 2006-2007, brian d foy, All Rights Reserved.

You may redistribute this under the same terms as Perl itself.

syntax highlighting: