smartystreets_ruby_sdk 5.9.0 → 5.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 52fd48c6c51199f3dcd357a5acc5f6bc16a6ea53ed8d5467be6a00bfe5abb864
-  data.tar.gz: faebc7c05c2e636c6c7b0cc687d24970abf7b1a695c8d4d68a03d5a62e8e46c1
+  metadata.gz: 76535338d0306bc77ed2b85bf80c0fb8de67f4c75597fe5680a8d20b79709a12
+  data.tar.gz: 485f697dfc44b1a9bb8589cecd8495f770d3f65e513a29ea2e6a390ac6c03eb4
 SHA512:
-  metadata.gz: b0d0d14bd4b4e8846f588b3743f7fc1fe026d3cb5270935885cde1d371d85bc01342b2a1b8cb62a4220392d064e5a76fb375fe497ee5400b2ccb1d59832a8a45
-  data.tar.gz: 8270d077871bf469999c5a864f58374f78000276ad4cbdcc85cc395d43c40f3d7152a71e4aa7c4ed7e8cd1d0731b24c5031557d417cb30891aedc2033a9d71cc
+  metadata.gz: c822627163eca11ccffd2bde54e08b853f6d782d82e05abbf17ea295bedf0ac7f41a5dba3261dbf3350527910b222031cf94f0ed2103d683fcea00028f55122a
+  data.tar.gz: 730369107a715aa070314d6be7b59603ef10516108954d7d93314418f38b0f4d0f485cb9e8336f4ca085d115dfd1b64092ad5d672e710201dd0e606e8ef58530

data/examples/international_example.rb

@@ -14,7 +14,11 @@ class InternationalExample
     # auth_token = ENV['SMARTY_AUTH_TOKEN']
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
-    client = SmartyStreets::ClientBuilder.new(credentials) # .with_licenses(%w(international-fake-license))
+
+    # The appropriate license values to be used for your subscriptions
+    # can be found on the Subscriptions page of the account dashboard.
+    # https://www.smartystreets.com/docs/cloud/licensing
+    client = SmartyStreets::ClientBuilder.new(credentials).with_licenses(['international-global-plus-cloud'])
                  .build_international_street_api_client
 
     # Documentation for input fields can be found at:

data/examples/us_autocomplete_pro_example.rb

@@ -0,0 +1,48 @@
+require 'smartystreets_ruby_sdk/shared_credentials'
+require '../lib/smartystreets_ruby_sdk/client_builder'
+require '../lib/smartystreets_ruby_sdk/us_autocomplete_pro/lookup'
+
+class USAutocompleteProExample
+  Lookup = SmartyStreets::USAutocompletePro::Lookup
+
+  def run
+    # key = 'Your SmartyStreets Auth ID here'
+    # hostname = 'Your SmartyStreets Auth Token here'
+
+    # We recommend storing your secret keys in environment variables instead---it's safer!
+    key = ENV['SMARTY_AUTH_WEB']
+    referer = ENV['SMARTY_AUTH_REFERER']
+
+    credentials = SmartyStreets::SharedCredentials.new(key, referer)
+
+    # The appropriate license values to be used for your subscriptions
+    # can be found on the Subscriptions page of the account dashboard.
+    # https://www.smartystreets.com/docs/cloud/licensing
+    client = SmartyStreets::ClientBuilder.new(credentials).with_licenses(['us-autocomplete-pro-cloud'])
+                 .build_us_autocomplete_pro_api_client
+
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-autocomplete-api
+
+    lookup = Lookup.new('4770 Lincoln Ave O')
+    lookup.max_results = 10
+    lookup.add_city_filter('Ogden')
+    lookup.add_state_filter('IL')
+    lookup.max_results = 5
+    lookup.prefer_ratio = 3
+
+    suggestions = client.send(lookup) # The client will also return the suggestions directly
+
+    puts
+    puts '*** Result with some filters ***'
+    puts
+
+    suggestions.each do |suggestion|
+      puts "#{suggestion.street_line} #{suggestion.city}, #{suggestion.state}"
+    end
+
+  end
+end
+
+USAutocompleteProExample.new.run
+

data/examples/us_reverse_geo_example.rb

@@ -14,7 +14,11 @@ class USReverseGeoExample
     # auth_token = ENV['SMARTY_AUTH_TOKEN']
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
-    client = SmartyStreets::ClientBuilder.new(credentials)
+
+    # The appropriate license values to be used for your subscriptions
+    # can be found on the Subscriptions page of the account dashboard.
+    # https://www.smartystreets.com/docs/cloud/licensing
+    client = SmartyStreets::ClientBuilder.new(credentials).with_licenses(['us-reverse-geocoding-cloud'])
                  .build_us_reverse_geo_api_client
 
     # Documentation for input fields can be found at:
@@ -36,6 +40,7 @@ class USReverseGeoExample
     puts "City: #{address.city}"
     puts "State Abbreviation: #{address.state_abbreviation}"
     puts "ZIP Code: #{address.zipcode}"
+    puts "License: #{coordinate.get_license}"
   end
 end
 

data/examples/us_street_multiple_address_example.rb

@@ -16,7 +16,10 @@ class USStreetMultipleAddressExample
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
 
-    client = SmartyStreets::ClientBuilder.new(credentials) # .with_licenses(%w(us-rooftop-geocoding-cloud))
+    # The appropriate license values to be used for your subscriptions
+    # can be found on the Subscriptions page of the account dashboard.
+    # https://www.smartystreets.com/docs/cloud/licensing
+    client = SmartyStreets::ClientBuilder.new(credentials).with_licenses(['us-rooftop-geocoding-cloud'])
                  .build_us_street_api_client
     batch = SmartyStreets::Batch.new
 

data/examples/us_street_single_address_example.rb

@@ -13,7 +13,10 @@ class USStreetSingleAddressExample
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
 
-    client = SmartyStreets::ClientBuilder.new(credentials).
+    # The appropriate license values to be used for your subscriptions
+    # can be found on the Subscriptions page of the account dashboard.
+    # https://www.smartystreets.com/docs/cloud/licensing
+    client = SmartyStreets::ClientBuilder.new(credentials).with_licenses(['us-rooftop-geocoding-cloud'])
         # with_proxy('localhost', 8080, 'proxyUser', 'proxyPassword'). # Uncomment this line to try it with a proxy
         build_us_street_api_client
 

data/lib/smartystreets_ruby_sdk.rb

@@ -25,6 +25,7 @@ require 'smartystreets_ruby_sdk/us_extract'
 require 'smartystreets_ruby_sdk/us_street'
 require 'smartystreets_ruby_sdk/us_zipcode'
 require 'smartystreets_ruby_sdk/us_autocomplete'
+require 'smartystreets_ruby_sdk/us_autocomplete_pro'
 require 'smartystreets_ruby_sdk/international_street'
 require 'smartystreets_ruby_sdk/us_reverse_geo'
 

data/lib/smartystreets_ruby_sdk/client_builder.rb

@@ -15,6 +15,7 @@ require_relative 'us_extract/client'
 require_relative 'us_autocomplete/client'
 require_relative 'international_street/client'
 require_relative 'us_reverse_geo/client'
+require_relative 'us_autocomplete_pro/client'
 
 module SmartyStreets
   # The ClientBuilder class helps you build a client object for one of the supported SmartyStreets APIs.
@@ -23,6 +24,7 @@ module SmartyStreets
   class ClientBuilder
     INTERNATIONAL_STREET_API_URL = 'https://international-street.api.smartystreets.com/verify'.freeze
     US_AUTOCOMPLETE_API_URL = 'https://us-autocomplete.api.smartystreets.com/suggest'.freeze
+    US_AUTOCOMPLETE_PRO_API_URL = 'https://us-autocomplete-pro.api.smartystreets.com/lookup'.freeze
     US_EXTRACT_API_URL = 'https://us-extract.api.smartystreets.com/'.freeze
     US_STREET_API_URL = 'https://us-street.api.smartystreets.com/street-address'.freeze
     US_ZIP_CODE_API_URL = 'https://us-zipcode.api.smartystreets.com/lookup'.freeze
@@ -128,6 +130,11 @@ module SmartyStreets
       USAutocomplete::Client.new(build_sender, @serializer)
     end
 
+    def build_us_autocomplete_pro_api_client
+      ensure_url_prefix_not_null(US_AUTOCOMPLETE_PRO_API_URL)
+      USAutocompletePro::Client.new(build_sender, @serializer)
+    end
+
     def build_us_extract_api_client
       ensure_url_prefix_not_null(US_EXTRACT_API_URL)
       USExtract::Client.new(build_sender, @serializer)

data/lib/smartystreets_ruby_sdk/international_street/client.rb

@@ -50,8 +50,10 @@ module SmartyStreets
       def convert_candidates(raw_candidates)
         candidates = []
 
-        raw_candidates.each do |candidate|
-          candidates.push(Candidate.new(candidate))
+        unless raw_candidates.nil?
+          raw_candidates.each do |candidate|
+            candidates.push(Candidate.new(candidate))
+          end
         end
 
         candidates

data/lib/smartystreets_ruby_sdk/shared_credentials.rb

@@ -6,7 +6,7 @@ module SmartyStreets
     end
 
     def sign(request)
-      request.parameters['auth-id'] = @id
+      request.parameters['key'] = @id
       request.referer = @host_name
     end
   end

data/lib/smartystreets_ruby_sdk/us_autocomplete_pro.rb

@@ -0,0 +1,10 @@
+require_relative './us_autocomplete_pro/lookup'
+require_relative './us_autocomplete_pro/geolocation_type'
+require_relative './us_autocomplete_pro/suggestion'
+require_relative './us_autocomplete_pro/client'
+
+module SmartyStreets
+  module USAutocompletePro
+  end
+end
+

data/lib/smartystreets_ruby_sdk/us_autocomplete_pro/client.rb

@@ -0,0 +1,77 @@
+require_relative '../request'
+require_relative '../exceptions'
+require_relative 'geolocation_type'
+require_relative 'suggestion'
+
+module SmartyStreets
+  module USAutocompletePro
+    # It is recommended to instantiate this class using ClientBuilder.build_us_autocomplete_pro_api_client
+    class Client
+      def initialize(sender, serializer)
+        @sender = sender
+        @serializer = serializer
+      end
+
+      # Sends a Lookup object to the US Autocomplete Pro API and stores the result in the Lookup's result field.
+      def send(lookup)
+        if not lookup or not lookup.search
+          raise SmartyStreets::SmartyError, 'Send() must be passed a Lookup with the prefix field set.'
+        end
+
+        request = build_request(lookup)
+
+        response = @sender.send(request)
+
+        raise response.error if response.error
+
+        result = @serializer.deserialize(response.payload)
+        suggestions = convert_suggestions(result.fetch('suggestions', []))
+        lookup.result = suggestions
+      end
+
+
+      def build_request(lookup)
+        request = Request.new
+
+        add_parameter(request, 'search', lookup.search)
+        add_parameter(request, 'max_results', lookup.max_results.to_s)
+        add_parameter(request, 'include_only_cities', build_filter_string(lookup.city_filter))
+        add_parameter(request, 'include_only_states', build_filter_string(lookup.state_filter))
+        add_parameter(request, 'include_only_zip_codes', build_filter_string(lookup.zip_filter))
+        add_parameter(request, 'exclude_states', build_filter_string(lookup.exclude_states))
+        add_parameter(request, 'prefer_cities', build_filter_string(lookup.prefer_cities))
+        add_parameter(request, 'prefer_states', build_filter_string(lookup.prefer_states))
+        add_parameter(request, 'prefer_zip_codes', build_filter_string(lookup.prefer_zip_codes))
+        add_parameter(request, 'prefer_ratio', lookup.prefer_ratio.to_s)
+        if lookup.prefer_zip_codes or lookup.zip_filter
+          request.parameters['prefer_geolocation'] = GeolocationType::NONE
+        else
+          add_parameter(request, 'prefer_geolocation', lookup.prefer_geolocation)
+        end
+        add_parameter(request, 'selected', lookup.selected)
+
+        request
+      end
+
+      def build_filter_string(filter_list)
+        filter_list ? filter_list.join(',') : nil
+      end
+
+      def convert_suggestions(suggestion_hashes)
+        converted_suggestions = []
+        return converted_suggestions if suggestion_hashes.nil?
+
+        suggestion_hashes.each do |suggestion|
+          converted_suggestions.push(USAutocompletePro::Suggestion.new(suggestion))
+        end
+
+        converted_suggestions
+      end
+
+      def add_parameter(request, key, value)
+        request.parameters[key] = value unless value.nil? or value.empty?
+      end
+    end
+  end
+end
+

data/lib/smartystreets_ruby_sdk/us_autocomplete_pro/geolocation_type.rb

@@ -0,0 +1,8 @@
+module SmartyStreets
+  module USAutocompletePro
+    module GeolocationType
+      CITY = 'city'
+      NONE = 'none'
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/us_autocomplete_pro/lookup.rb

@@ -0,0 +1,61 @@
+require_relative '../json_able'
+
+module SmartyStreets
+  module USAutocompletePro
+    # In addition to holding all of the input data for this lookup, this class also will contain the result
+    # of the lookup after it comes back from the API.
+    #
+    # See "https://smartystreets.com/docs/cloud/us-autocomplete-api#http-request-input-fields"
+    class Lookup < JSONAble
+
+      attr_accessor :result, :search, :max_results, :city_filter, :state_filter, :zip_filter,
+                    :exclude_states, :prefer_cities, :prefer_states, :prefer_zip_codes, :prefer_ratio, :prefer_geolocation, :selected
+
+      def initialize(search=nil, max_results=nil, city_filter=nil, state_filter=nil, zip_filter=nil,
+                     exclude_states=nil, prefer_cities=nil, prefer_states=nil, prefer_zips=nil, prefer_ratio=nil,
+                     prefer_geolocation=nil, selected=nil)
+        @result = []
+        @search = search
+        @max_results = max_results
+        @city_filter = city_filter ? city_filter : []
+        @state_filter = state_filter ? state_filter : []
+        @zip_filter = zip_filter ? zip_filter : []
+        @exclude_states = exclude_states ? exclude_states : []
+        @prefer_cities = prefer_cities ? prefer_cities : []
+        @prefer_states = prefer_states ? prefer_states : []
+        @prefer_zip_codes = prefer_zips ? prefer_zips : []
+        @prefer_ratio = prefer_ratio
+        @prefer_geolocation = prefer_geolocation
+        @selected = selected
+      end
+
+      def add_city_filter(city)
+        @city_filter.push(city)
+      end
+
+      def add_state_filter(state)
+        @state_filter.push(state)
+      end
+
+      def add_zip_filter(zip)
+        @zip_filter.push(zip)
+      end
+
+      def add_state_exclusion(state)
+        @exclude_states.push(state)
+      end
+
+      def add_preferred_city(city)
+        @prefer_cities.push(city)
+      end
+
+      def add_preferred_state(state)
+        @prefer_states.push(state)
+      end
+
+      def add_preferred_zip(zip)
+        @prefer_zip_codes.push(zip)
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/us_autocomplete_pro/suggestion.rb

@@ -0,0 +1,18 @@
+module SmartyStreets
+  module USAutocompletePro
+    # See "https://smartystreets.com/docs/cloud/us-autocomplete-api#http-response"
+    class Suggestion
+
+      attr_reader :street_line, :secondary, :city, :state, :zipcode, :entries
+
+      def initialize(obj)
+        @street_line = obj.fetch('street_line', nil)
+        @secondary = obj.fetch('secondary', nil)
+        @city = obj.fetch('city', nil)
+        @state = obj.fetch('state', nil)
+        @zipcode = obj.fetch('zipcode', nil)
+        @entries = obj.fetch('entries', 0)
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/us_reverse_geo/coordinate.rb

@@ -10,6 +10,15 @@ module SmartyStreets
         @accuracy = obj.fetch('accuracy', nil)
         @license = obj.fetch('license', nil)
       end
+
+      def get_license()
+        case @license
+        when 1
+          return "SmartyStreets Proprietary"
+        else
+          return "SmartyStreets"
+        end
+      end
     end
   end
 end

data/lib/smartystreets_ruby_sdk/us_street/analysis.rb

@@ -3,19 +3,22 @@ module SmartyStreets
     # See "https://smartystreets.com/docs/cloud/us-street-api#analysis"
     class Analysis
       attr_reader :lacs_link_code, :active, :footnotes, :lacs_link_indicator, :dpv_match_code, :is_suite_link_match,
-                  :is_ews_match, :dpv_footnotes, :cmra, :vacant
+                  :is_ews_match, :dpv_footnotes, :cmra, :vacant, :no_stat, :match_mode, :match_details
 
       def initialize(obj)
         @dpv_match_code = obj['dpv_match_code']
         @dpv_footnotes = obj['dpv_footnotes']
         @cmra = obj['dpv_cmra']
         @vacant = obj['dpv_vacant']
+        @no_stat = obj['dpv_no_stat']
         @active = obj['active']
         @is_ews_match = obj['ews_match']
         @footnotes = obj['footnotes']
         @lacs_link_code = obj['lacslink_code']
         @lacs_link_indicator = obj['lacslink_indicator']
         @is_suite_link_match = obj['suitelink_match']
+        @match_mode = obj['match_mode']
+        @match_details = obj['match_details']
       end
     end
   end

data/lib/smartystreets_ruby_sdk/version.rb

@@ -1,3 +1,3 @@
 module SmartyStreets
-  VERSION = '5.9.0' # DO NOT EDIT (this is updated by a build job when a new release is published)
+  VERSION = '5.11.1' # DO NOT EDIT (this is updated by a build job when a new release is published)
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartystreets_ruby_sdk
 version: !ruby/object:Gem::Version
-  version: 5.9.0
+  version: 5.11.1
 platform: ruby
 authors:
 - SmartyStreets SDK Team
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-10-29 00:00:00.000000000 Z
+date: 2021-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -92,6 +92,7 @@ files:
 - docker-compose.yml
 - examples/international_example.rb
 - examples/us_autocomplete_example.rb
+- examples/us_autocomplete_pro_example.rb
 - examples/us_extract_example.rb
 - examples/us_reverse_geo_example.rb
 - examples/us_street_multiple_address_example.rb
@@ -134,6 +135,11 @@ files:
 - lib/smartystreets_ruby_sdk/us_autocomplete/geolocation_type.rb
 - lib/smartystreets_ruby_sdk/us_autocomplete/lookup.rb
 - lib/smartystreets_ruby_sdk/us_autocomplete/suggestion.rb
+- lib/smartystreets_ruby_sdk/us_autocomplete_pro.rb
+- lib/smartystreets_ruby_sdk/us_autocomplete_pro/client.rb
+- lib/smartystreets_ruby_sdk/us_autocomplete_pro/geolocation_type.rb
+- lib/smartystreets_ruby_sdk/us_autocomplete_pro/lookup.rb
+- lib/smartystreets_ruby_sdk/us_autocomplete_pro/suggestion.rb
 - lib/smartystreets_ruby_sdk/us_extract.rb
 - lib/smartystreets_ruby_sdk/us_extract/address.rb
 - lib/smartystreets_ruby_sdk/us_extract/client.rb