NAME

WWW::Scraper::ZIPplus4 - Get ZIP+4 code, given street address, from www.usps.com. Also helps de-duplicate a mailing list.

SYNOPSIS

Simple

use WWW::Scraper(qw(2.25));
use WWW::Scraper::Request::ZIPplus4;

my $ZIPplus4 = new WWW::Scraper(
        'ZIPplus4',
       ,{   'address1' => '1600 Pennsylvannia Ave'
           ,'city'     => 'Washington'
           ,'state'    => 'DC'
           ,'zipcode'  => '20500'
        } );

while ( my $response = $ZIPplus4->next_response() )
{    
    print $response->zipcode()."\n";
}

Complete

use WWW::Scraper(qw(2.25));
use WWW::Scraper::Request::ZIPplus4;

my $ZIPplus4 = new WWW::Scraper( 'ZIPplus4' );

my $request = new WWW::Scraper::Request::ZIPplus4;

# Note: Delivery_Address(), and either Zip_Code(), or City() and State(), are required.
$request->address1('1600 Pennsylvannia Ave');
$request->city('Washington');
$request->state('DC');
$request->zipcode('20500');

$ZIPplus4->scraperRequest($request);
while ( my $response = $ZIPplus4->next_response() )
{    
    for ( qw(address city state zipcode county carrierRoute checkDigit deliveryPoint) ) {
        print "$_: ".${$response->$_()}."\n";
    }
}

DESCRIPTION

This class is an ZIPplus4 specialization of WWW::Scraper. It handles making and interpreting ZIPplus4 searches http://www.ZIPplus4.com.

SPECIAL THANKS

To Klemens Schmid (klemens.schmid@gmx.de), for FormSniffer.

This tool is an excellent compliment to Scraper to almost instantly discover form and CGI parameters for configuring new Scraper modules. It instantly revealed what I was doing wrong in the new ZIPplus4 format one day (after hours of my own clumsy attempts). See FormSniffer at http://www.wap2web.de/formsniffer2.aspx (Win32 only).

AUTHOR and CURRENT VERSION

WWW::Scraper::ZIPplus4 is written and maintained by Glenn Wood, http://search.cpan.org/search?mode=author&query=GLENNWOOD.

COPYRIGHT

Copyright (c) 2001 Glenn Wood All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.