WebService::SmartyStreets
version 0.0105
use WebService::SmartyStreets; my $ss = WebService::SmartyStreets->new( auth_id => 'abc123', auth_token => 'zyx456', ); $ss->verify_address(...);
This module provides bindings for the SmartyStreets API.
Instantiates a new WebService::SmartyStreets client object.
my $ss = WebService::SmartyStreets->new( auth_id => $auth_id, auth_token => $auth_token, timeout => $retries, # optional retries => $retries, # optional );
Parameters
auth_id
Required
A valid SmartyStreets auth id for your account.
auth_token
A valid SmartyStreets auth token for your account.
timeout
Optional
The number of seconds to wait per request until timing out. Defaults to 10.
10
retries
The number of times to retry requests in cases when SmartyStreets returns a 5xx response. Defaults to 0.
0
Validates an address given.
Request:
verify_address( street => '370 Townsend St', city => 'San Francisco', state => 'CA', zipcode => '94107', );
Response:
[{ street => '370 Townsend St', city => 'San Francisco', state => 'CA', zipcode => '94107-1607', }]
Exceptions:
WebService::SmartyStreets::Exception::AddressNotFound
Address Not Found.
WebService::SmartyStreets::Exception::AddressMissingInformation
The address you entered was found but more information is needed to match to a specific address.
Please report any bugs or feature requests on the bugtracker website https://github.com/aanari/WebService-SmartyStreets/issues
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
Ali Anari <ali@anari.me>
Naveed Massjouni <naveedm9@gmail.com>
This software is copyright (c) 2014 by Ali Anari.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install WebService::SmartyStreets, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::SmartyStreets
CPAN shell
perl -MCPAN -e shell install WebService::SmartyStreets
For more information on module installation, please visit the detailed CPAN module installation guide.