NAME

WebService::Async::SmartyStreets - calls the SmartyStreets API and checks for the validity of the address

SYNOPSIS

my $ss = WebService::Async::SmartyStreets->new(
    # Obtain these from your SmartyStreets account page.
    # These will be used for US lookups
    us_auth_id => '...',
    us_token   => '...',
    # For non-US address lookups, you would also need an international token
    international_auth_id => '...',
    international_token   => '...',
);
IO::Async::Loop->new->add($ss);

print $ss->verify(
    city => 'Atlanta',
    country => 'US',
    geocode => 1
)->get->status;

DESCRIPTION

This module provides basic support for the SmartyStreets API.

Note that this module uses Future::AsyncAwait.

verify

Makes connection to SmartyStreets API and parses the response into WebService::Async::SmartyStreets::Address.

my $addr = $ss->verify(%address_to_check)->get;

Takes the following named parameters:

• country - country (required)
• address1 - address line 1
• address2 - address line 2
• organization - name of organization (usually building names)
• locality - city
• administrative_area - state
• postal_code - post code
• geocode - true or false

Returns a Future which should resolve to a valid WebService::Async::SmartyStreets::Address instance.

METHODS - Accessors

METHODS - Internal

get_decoded_data

Calls the SmartyStreets API then decode and parses the response give by SmartyStreets

my $decoded = await get_decoded_data($self, $uri)

Takes the following parameters:

• $uri - URI for endpoint

More information on the response can be seen in SmartyStreets Documentation .

Returns a Future which resolves to an arrayref of WebService::Async::SmartyStreets::Address instances.

configure

Configures the instance.

Takes the following named parameters:

• international_auth_id - auth_id obtained from SmartyStreet
• international_token - token obtained from SmartyStreet
• us_auth_id - auth_id obtained from SmartyStreet
• us_token - token obtained from SmartyStreet

Note that you can provide US, international or both API tokens - if an API token is not available for a "verify" call, then it will return a failed Future.

ua

Accessor for the Net::Async::HTTP instance which will be used for SmartyStreets API requests.