NAME
    Geo::Address::Mail::Standardizer::USPS::AMS - address standardization
    using the United States Postal Service Address Matching System

SYNOPSIS
     my $ms   = new Geo::Address::Mail::Standardizer::USPS::AMS;
     my $addr = new Geo::Address::Mail::US;
     my $res  = $ms->standardize($addr);

     $addr = $res->standardized_address
         or die 'unable to standardize address: ' . $res->error;

AMS PATHS
    by default, the USPS::AMS standardizer assumes AMS paths are configured
    as follows:

     datadir: /usr/share/uspsams
     statedir: /var/lib/uspsams

     AMS: datadir/comm
     DPV: datadir/dpv
     ELOT: datadir/elot
     LACSLink: datadir/lacslink
     SUITELink: datadir/suitelink
     Z4CXLOG.DAT: statedir/Z4CXLOG.DAT

    you may change datadir or statedir via those attributes, but the other
    paths are computed and are immutable.

METHODS
  new
    the Geo::Address::Mail::Standardizer::USPS::AMS constructor accepts two
    arguments:

    datadir (default: /usr/share/uspsams)
        the path to the USPS AMS shared data directory. this directory
        typically contains all of the database files provided with AMS.

    statedir (defaults to /var/lib/uspsams)
        the path to the USPS AMS state directory. this directory is expected
        to contain the Z4CXLOG.DAT date/time file that is written to by AMS.
        i have no idea what its purpose is; AMS won't initialize without it
        though.

  init
    initializes the AMS database. called during construction by the BUILD
    method.

  standardize($address)
    attempt to standardize an address. the standardize method accepts a
    hashref or a Geo::Address::Mail::US object. a results object will be
    returned. see the documentation for
    Geo::Address::Mail::Standardizer::USPS::AMS::Results for details on the
    results object.

AUTHOR
    Mike Eldridge <diz@cpan.org>

COPYRIGHT
    Copyright (c) 2010 Mike Eldridge

LICENSE
    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.