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.

INHERITED METHODS

IO::Async::Notifier

add_child, adopt_future, adopted_futures, can_event, children, configure_unknown, debug_printf, get_loop, invoke_error, invoke_event, loop, make_event_cb, maybe_invoke_event, maybe_make_event_cb, new, notifier_name, parent, remove_child, remove_from_parent

cpanm WebService::Async::SmartyStreets

perl -MCPAN -e shell
install WebService::Async::SmartyStreets