NAME

Scrape::USPS::ZipLookup::Address - U.S. postal addresses.

SYNOPSIS

  use Scrape::USPS::ZipLookup;
  use Scrape::USPS::ZipLookup::Address;

  my $addr = Scrape::USPS::ZipLookup::Address->new({
    'Delivery Address' => $address,
    'City'             => $city,
    'State'            => $state,
    'Zip Code'         => $zip
  };

  my $zlu = Scrape::USPS::ZipLookup->new();

  my @matches = $zlu->std_addr($addr);

  if (@matches) {
    printf "\n%d matches:\n", scalar(@matches);
    foreach my $match (@matches) {
      print "-" x 39, "\n";
      print $match->to_dump;
      print "\n";
    }
    print "-" x 39, "\n";
  }
  else {
    print "No matches!\n";
  }

DESCRIPTION

Results from Scrape::USPS::ZipLookup calls are of this type.

FIELDS

Basic information:

* firm
* urbanization
* delivery_address
* city
* state
* zip_code

Detailed information (see the U.S. Postal Service web site for definitions at http://zip4.usps.com/zip4/pu_mailing_industry_def.htm):

* carrier_route
* county
* delivery_point
* check_digit
* lac_indicator
* elot_sequence
* elot_indicator
* record_type
* pmb_designator
* pmb_number
* default_address
* early_warning
* valid

TERMS OF USE

BE SURE TO READ AND FOLLOW THE UNITED STATES POSTAL SERVICE TERMS OF USE PAGE AT http://www.usps.gov/disclaimer.html. IN PARTICULAR, NOTE THAT THEY DO NOT PERMIT THE USE OF THEIR WEB SITE'S FUNCTIONALITY FOR COMMERCIAL PURPOSES. DO NOT USE THIS CODE IN A WAY THAT VIOLATES THE TERMS OF USE.

The author believes that the example usage given above does not violate these terms, but sole responsibility for conforming to the terms of use belongs to the user of this code, not the author.

AUTHOR

Gregor N. Purdy, gregor@focusresearch.com.