smartystreets_ruby_sdk 5.6.2 → 5.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24accdde90fe66c1a462c9ece15627be7dcbc37e51123137feac05a416922c95
-  data.tar.gz: 5be1d1cd195ac985df51a35eec48413dbb7fa3d7eca918223568250713630ce0
+  metadata.gz: 22abe39dcfb7e3f3a54c00e23a2e10f74f9517da591eba7e5d683bd85906bdc6
+  data.tar.gz: cc64352a972464666e5b736306bb37e24b10c9304bedebe3bfa607b1b3119315
 SHA512:
-  metadata.gz: d78c51b40c325e407b8845f4b9313f48062cf69c31ed589772633ef51e3ef1c482ea0b3b4d5cd142f872580bf1b43995ce6a60956826e67fa6e0182d9f535dd8
-  data.tar.gz: cc44c44629f4160a080d55fb5583384ebc1fe49dcea0c3b14141865a1e0beb02056f2f6dc1b5933293cf1022bbc7fe22a1b49388503579da32bb34cfc2fd3384
+  metadata.gz: 35615ebe72dc2c2879dbe5280fd97e3c5da730fe07b437ac196b9ceb512d5a2ebc4025a45f3f0a90949ae6b45efac5292004563b3eb4fc2fdd2ed83ef2a05f34
+  data.tar.gz: 71adfc30cc9318b1196f59ed52362ead899056e14df932b49bed7e7a24428bf38cdd59321db316c2539bb4e091a65ceadb4464b2eca2d6b2fdf9608178de3ade

data/README.md

@@ -27,7 +27,3 @@ And then execute:
 Or install it yourself as:
 
     $ gem install smartystreets_ruby_sdk    
-
-
-
-

data/examples/international_example.rb

@@ -14,14 +14,27 @@ class InternationalExample
     # auth_token = ENV['SMARTY_AUTH_TOKEN']
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
-    client = SmartyStreets::ClientBuilder.new(credentials).build_international_street_api_client
+    client = SmartyStreets::ClientBuilder.new(credentials) # .with_licenses(%w(international-fake-license))
+                 .build_international_street_api_client
 
-    lookup = Lookup.new("Rua Padre Antonio D'Angelo 121 Casa Verde, Sao Paulo", 'Brazil')
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/international-street-api
+
+    lookup = Lookup.new()
+    lookup.inputId = 'ID-8675309' # Optional ID from your system
     lookup.geocode = true # Must be expressly set to get latitude and longitude.
+    lookup.organization = 'John Doe'
+    lookup.address1 = "Rua Padre Antonio D'Angelo 121"
+    lookup.address2 = 'Casa Verde'
+    lookup.locality = 'Sao Paulo'
+    lookup.administrative_area = 'SP'
+    lookup.country = 'Brazil'
+    lookup.postal_code = '02516-050'
 
     candidates = client.send(lookup) # The candidates are also stored in the lookup's 'result' field.
 
     first_candidate = candidates[0]
+    puts "Input ID: #{first_candidate.input_id}"
     puts "Address is #{first_candidate.analysis.verification_status}"
     puts "Address precision: #{first_candidate.analysis.address_precision}\n\n"
     puts "First Line: #{first_candidate.address1}"

data/examples/us_autocomplete_example.rb

@@ -15,7 +15,12 @@ class USAutocompleteExample
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
     client = SmartyStreets::ClientBuilder.new(credentials).build_us_autocomplete_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_suggestions = 10
 
     client.send(lookup)
 
@@ -25,8 +30,11 @@ class USAutocompleteExample
       puts suggestion.text
     end
 
+    lookup.add_city_filter('Ogden')
     lookup.add_state_filter('IL')
+    lookup.add_prefer('Ogden, IL')
     lookup.max_suggestions = 5
+    lookup.prefer_ratio = 0.333333
 
     suggestions = client.send(lookup) # The client will also return the suggestions directly
 

data/examples/us_extract_example.rb

@@ -21,7 +21,13 @@ class USExtractExample
            "\r\nLos Vegas, Nevada." \
            "\r\nMeet me at 1 Rosedale Baltimore Maryland, not at 123 Phony Street, Boise Idaho."
 
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-extract-api
+
     lookup = Lookup.new(text)
+    lookup.aggressive = true
+    lookup.addresses_have_line_breaks = false
+    lookup.addresses_per_line = 2
 
     result = client.send(lookup)
 

data/examples/us_reverse_geo_example.rb

@@ -0,0 +1,43 @@
+require 'smartystreets_ruby_sdk/static_credentials'
+require '../lib/smartystreets_ruby_sdk/client_builder'
+require '../lib/smartystreets_ruby_sdk/us_reverse_geo/lookup'
+
+class USReverseGeoExample
+  Lookup = SmartyStreets::USReverseGeo::Lookup
+
+  def run
+    auth_id = 'Your SmartyStreets Auth ID here'
+    auth_token = 'Your SmartyStreets Auth Token here'
+
+    # We recommend storing your secret keys in environment variables instead---it's safer!
+    # auth_id = ENV['SMARTY_AUTH_ID']
+    # auth_token = ENV['SMARTY_AUTH_TOKEN']
+
+    credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
+    client = SmartyStreets::ClientBuilder.new(credentials)
+                 .build_us_reverse_geo_api_client
+
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-reverse-geo-api#http-request-input-fields
+
+    lookup = Lookup.new(40.111111, -111.111111)
+
+    response = client.send(lookup)
+    result = response.results[0]
+
+    coordinate = result.coordinate
+    puts "Latitude: #{coordinate.latitude}"
+    puts "Longitude: #{coordinate.longitude}\n"
+
+    puts "Distance: #{result.distance}\n"
+
+    address = result.address
+    puts "Street: #{address.street}"
+    puts "City: #{address.city}"
+    puts "State Abbreviation: #{address.state_abbreviation}"
+    puts "ZIP Code: #{address.zipcode}"
+    puts "License: #{coordinate.get_license}"
+  end
+end
+
+USReverseGeoExample.new.run

data/examples/us_street_multiple_address_example.rb

@@ -16,14 +16,26 @@ class USStreetMultipleAddressExample
 
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
 
-    client = SmartyStreets::ClientBuilder.new(credentials).build_us_street_api_client
+    client = SmartyStreets::ClientBuilder.new(credentials) # .with_licenses(%w(us-rooftop-geocoding-cloud))
+                 .build_us_street_api_client
     batch = SmartyStreets::Batch.new
 
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-street-api
+
     batch.add(Lookup.new)
+    batch[0].input_id = '8675309'  # Optional ID from your system
+    batch[0].addressee = 'John Doe'
     batch[0].street = '1600 amphitheatre parkway'
-    batch[0].city = 'Mountain view'
-    batch[0].state = 'california'
-    batch[0].match = SmartyStreets::USStreet::MatchType::INVALID
+    batch[0].street2 = 'second star to the right'
+    batch[0].secondary = 'APT 2'
+    batch[0].urbanization = ''  # Only applies to Puerto Rico addresses
+    batch[0].lastline = 'Mountain view, California'
+    batch[0].zipcode = '21229'
+    batch[0].candidates = 3
+    batch[0].match = 'invalid'.freeze # "invalid" is the most permissive match,
+                                      # this will always return at least one result even if the address is invalid.
+                                      # Refer to the documentation for additional Match Strategy options.
 
     batch.add(Lookup.new('1 Rosedale, Baltimore, Maryland')) # Freeform addresses work too.
     batch[1].candidates = 10 # Allows up to ten possible matches to be returned (default is 1).
@@ -56,6 +68,7 @@ class USStreetMultipleAddressExample
         metadata = candidate.metadata
 
         puts "\nCandidate #{candidate.candidate_index} : "
+        puts "Input ID: #{candidate.input_id}"
         puts "Delivery line 1: #{candidate.delivery_line_1}"
         puts "Last line:       #{candidate.last_line}"
         puts "ZIP Code:        #{components.zipcode}-#{components.plus4_code}"

data/examples/us_street_single_address_example.rb

@@ -14,14 +14,26 @@ class USStreetSingleAddressExample
     credentials = SmartyStreets::StaticCredentials.new(auth_id, auth_token)
 
     client = SmartyStreets::ClientBuilder.new(credentials).
-                 # with_proxy('localhost', 8080, 'proxyUser', 'proxyPassword'). # Uncomment this line to try it with a proxy
-                 build_us_street_api_client
+        # with_proxy('localhost', 8080, 'proxyUser', 'proxyPassword'). # Uncomment this line to try it with a proxy
+        build_us_street_api_client
+
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-street-api
 
     lookup = SmartyStreets::USStreet::Lookup.new
+    lookup.input_id = '24601'  # Optional ID from your system
+    lookup.addressee = 'John Doe'
     lookup.street = '1600 Amphitheatre Pkwy'
+    lookup.street2 = 'closet under the stairs'
+    lookup.secondary = 'APT 2'
+    lookup.urbanization = ''  # Only applies to Puerto Rico addresses
     lookup.city = 'Mountain View'
     lookup.state = 'CA'
-    lookup.match = SmartyStreets::USStreet::MatchType::INVALID
+    lookup.zipcode = '21229'
+    lookup.candidates = 3
+    lookup.match = 'invalid'.freeze # "invalid" is the most permissive match,
+                                    # this will always return at least one result even if the address is invalid.
+                                    # Refer to the documentation for additional Match Strategy options.
 
     begin
       client.send_lookup(lookup)
@@ -40,6 +52,7 @@ class USStreetSingleAddressExample
     first_candidate = result[0]
 
     puts "Address is valid. (There is at least one candidate)\n"
+    puts "Input ID: #{first_candidate.input_id}"
     puts "ZIP Code: #{first_candidate.components.zipcode}"
     puts "County: #{first_candidate.metadata.county_name}"
     puts "Latitude: #{first_candidate.metadata.latitude}"

data/examples/us_zipcode_multiple_lookup_example.rb

@@ -19,7 +19,11 @@ class USZipcodeMultipleLookupExample
     client = SmartyStreets::ClientBuilder.new(credentials).build_us_zipcode_api_client
     batch = SmartyStreets::Batch.new
 
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-zipcode-api
+
     batch.add(Lookup.new)
+    batch[0].input_id = '01189998819991197253' # Optional ID from your system
     batch[0].zipcode = '12345' # A Lookup may have a ZIP Code, city and state, or city, state, and ZIP Code
 
     batch.add(Lookup.new)

data/examples/us_zipcode_single_lookup_example.rb

@@ -15,9 +15,14 @@ class UsZipcodeSingleLookupExample
 
     client = SmartyStreets::ClientBuilder.new(credentials).build_us_zipcode_api_client
 
+    # Documentation for input fields can be found at:
+    # https://smartystreets.com/docs/cloud/us-zipcode-api
+
     lookup = SmartyStreets::USZipcode::Lookup.new
+    lookup.input_id = 'dfc33cb6-829e-4fea-aa1b-b6d6580f0817'  # Optional ID from your system
     lookup.city = 'Mountain View'
     lookup.state = 'California'
+    lookup.zipcode = '94043'
 
     begin
       client.send_lookup(lookup)
@@ -30,6 +35,8 @@ class UsZipcodeSingleLookupExample
     zipcodes = result.zipcodes
     cities = result.cities
 
+    puts "Input ID: #{result.input_id}"
+
     cities.each do |city|
       puts "\nCity: #{city.city}"
       puts "State: #{city.state}"

data/lib/smartystreets_ruby_sdk.rb

@@ -14,6 +14,7 @@ require 'smartystreets_ruby_sdk/native_serializer'
 require 'smartystreets_ruby_sdk/request'
 require 'smartystreets_ruby_sdk/response'
 require 'smartystreets_ruby_sdk/retry_sender'
+require 'smartystreets_ruby_sdk/license_sender'
 require 'smartystreets_ruby_sdk/shared_credentials'
 require 'smartystreets_ruby_sdk/signing_sender'
 require 'smartystreets_ruby_sdk/static_credentials'
@@ -25,6 +26,7 @@ require 'smartystreets_ruby_sdk/us_street'
 require 'smartystreets_ruby_sdk/us_zipcode'
 require 'smartystreets_ruby_sdk/us_autocomplete'
 require 'smartystreets_ruby_sdk/international_street'
+require 'smartystreets_ruby_sdk/us_reverse_geo'
 
 module SmartyStreets
 end

data/lib/smartystreets_ruby_sdk/client_builder.rb

@@ -4,6 +4,7 @@ require_relative 'status_code_sender'
 require_relative 'signing_sender'
 require_relative 'retry_sender'
 require_relative 'url_prefix_sender'
+require_relative 'license_sender'
 require_relative 'sleeper'
 require_relative 'logger'
 require_relative 'proxy'
@@ -13,6 +14,7 @@ require_relative 'us_zipcode/client'
 require_relative 'us_extract/client'
 require_relative 'us_autocomplete/client'
 require_relative 'international_street/client'
+require_relative 'us_reverse_geo/client'
 
 module SmartyStreets
   # The ClientBuilder class helps you build a client object for one of the supported SmartyStreets APIs.
@@ -24,6 +26,7 @@ module SmartyStreets
     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
+    US_REVERSE_GEO_API_URL = 'https://us-reverse-geo.api.smartystreets.com/lookup'.freeze
 
     def initialize(signer)
       @signer = signer
@@ -34,6 +37,7 @@ module SmartyStreets
       @url_prefix = nil
       @proxy = nil
       @headers = nil
+      @licenses = %w()
       @debug = nil
     end
 
@@ -96,6 +100,14 @@ module SmartyStreets
       self
     end
 
+    # Allows the caller to specify the subscription license (aka "track") they wish to use.
+    #
+    # Returns self to accommodate method chaining.
+    def with_licenses(licenses)
+      @licenses.concat licenses
+      self
+    end
+
     # Enables debug mode, which will print information about the HTTP request and response to $stdout.
     #
     # Returns self to accommodate method chaining.
@@ -131,6 +143,11 @@ module SmartyStreets
       USZipcode::Client.new(build_sender, @serializer)
     end
 
+    def build_us_reverse_geo_api_client
+      ensure_url_prefix_not_null(US_REVERSE_GEO_API_URL)
+      USReverseGeo::Client.new(build_sender, @serializer)
+    end
+
     # </editor-fold>
 
     def build_sender
@@ -146,6 +163,8 @@ module SmartyStreets
 
       sender = RetrySender.new(@max_retries, sender, SmartyStreets::Sleeper.new,SmartyStreets::Logger.new) if @max_retries > 0
 
+      sender = LicenseSender.new(sender, @licenses)
+
       URLPrefixSender.new(@url_prefix, sender)
     end
 

data/lib/smartystreets_ruby_sdk/international_street/analysis.rb

@@ -1,14 +1,16 @@
+require_relative 'changes'
 module SmartyStreets
   module InternationalStreet
     # See "https://smartystreets.com/docs/cloud/international-street-api#analysis"
     class Analysis
 
-      attr_reader :max_address_precision, :verification_status, :address_precision
+      attr_reader :max_address_precision, :verification_status, :address_precision, :changes
 
       def initialize(obj)
         @verification_status = obj.fetch('verification_status', nil)
         @address_precision = obj.fetch('address_precision', nil)
         @max_address_precision = obj.fetch('max_address_precision', nil)
+        @changes = Changes.new(obj.fetch('changes', {}))
       end
     end
   end

data/lib/smartystreets_ruby_sdk/international_street/candidate.rb

@@ -1,6 +1,7 @@
 require_relative 'components'
 require_relative 'metadata'
 require_relative 'analysis'
+require_relative 'rootlevel'
 
 module SmartyStreets
   module InternationalStreet
@@ -8,27 +9,14 @@ module SmartyStreets
     # candidates if the address was ambiguous.
     #
     # See "https://smartystreets.com/docs/cloud/international-street-api#root"
-    class Candidate
-      attr_reader :metadata, :address3, :address11, :address2, :address12, :address1, :address10,
-                  :address9, :address8, :address7, :organization, :address6, :address5, :address4, :components, :analysis
+    class Candidate < RootLevel
+      attr_reader :metadata, :components, :analysis
 
       def initialize(obj)
-        @organization = obj.fetch('organization', nil)
-        @address1 = obj.fetch('address1', nil)
-        @address2 = obj.fetch('address2', nil)
-        @address3 = obj.fetch('address3', nil)
-        @address4 = obj.fetch('address4', nil)
-        @address5 = obj.fetch('address5', nil)
-        @address6 = obj.fetch('address6', nil)
-        @address7 = obj.fetch('address7', nil)
-        @address8 = obj.fetch('address8', nil)
-        @address9 = obj.fetch('address9', nil)
-        @address10 = obj.fetch('address10', nil)
-        @address11 = obj.fetch('address11', nil)
-        @address12 = obj.fetch('address12', nil)
         @components = Components.new(obj.fetch('components', {}))
         @metadata = Metadata.new(obj.fetch('metadata', {}))
         @analysis = Analysis.new(obj.fetch('analysis', {}))
+        super(obj)
       end
     end
   end

data/lib/smartystreets_ruby_sdk/international_street/changes.rb

@@ -0,0 +1,15 @@
+require_relative 'rootlevel'
+require_relative 'components'
+
+module SmartyStreets
+  module InternationalStreet
+    class Changes < RootLevel
+      attr_reader :components
+
+      def initialize(obj)
+        @components = Components.new(obj.fetch('components', {}))
+        super(obj)
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/international_street/client.rb

@@ -26,6 +26,7 @@ module SmartyStreets
       def build_request(lookup)
         request = SmartyStreets::Request.new
 
+        add_parameter(request, 'input_id', lookup.input_id)
         add_parameter(request, 'country', lookup.country)
         add_parameter(request, 'geocode', lookup.geocode.to_s)
         add_parameter(request, 'language', lookup.language)

data/lib/smartystreets_ruby_sdk/international_street/lookup.rb

@@ -14,13 +14,13 @@ module SmartyStreets
     #     When set to language_mode.LATIN, the results will always be provided using a Latin character set.
     class Lookup
 
-      attr_accessor :freeform, :locality, :postal_code, :address3, :address2, :inputId, :address1,
+      attr_accessor :input_id, :freeform, :locality, :postal_code, :address3, :address2, :inputId, :address1,
                     :geocode, :administrative_area, :country, :organization, :language, :address4, :result
 
       def initialize(freeform=nil, country=nil)
         @result = []
 
-        @inputId = nil
+        @input_id = nil
         @country = country
         @geocode = nil
         @language = nil

data/lib/smartystreets_ruby_sdk/international_street/rootlevel.rb

@@ -0,0 +1,25 @@
+module SmartyStreets
+  module InternationalStreet
+    class RootLevel
+      attr_reader :input_id, :organization, :address1, :address2, :address3, :address4, :address5, :address6, :address7,
+                  :address8, :address9, :address10, :address11, :address12
+
+      def initialize(obj)
+        @input_id = obj.fetch('input_id', nil)
+        @organization = obj.fetch('organization', nil)
+        @address1 = obj.fetch('address1', nil)
+        @address2 = obj.fetch('address2', nil)
+        @address3 = obj.fetch('address3', nil)
+        @address4 = obj.fetch('address4', nil)
+        @address5 = obj.fetch('address5', nil)
+        @address6 = obj.fetch('address6', nil)
+        @address7 = obj.fetch('address7', nil)
+        @address8 = obj.fetch('address8', nil)
+        @address9 = obj.fetch('address9', nil)
+        @address10 = obj.fetch('address10', nil)
+        @address11 = obj.fetch('address11', nil)
+        @address12 = obj.fetch('address12', nil)
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/license_sender.rb

@@ -0,0 +1,15 @@
+module SmartyStreets
+  class LicenseSender
+    def initialize(inner, licenses)
+      @inner = inner
+      @licenses = licenses
+    end
+
+    def send(request)
+      if @licenses.length > 0
+        request.parameters['license'] = @licenses.join(',')
+      end
+      @inner.send(request)
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/us_extract/result.rb

@@ -13,7 +13,7 @@ module SmartyStreets
         @addresses = []
 
         addresses.each {|address|
-          @addresses.push(Address.new(address))
+          @addresses.push(SmartyStreets::USExtract::Address.new(address))
         }
       end
     end

data/lib/smartystreets_ruby_sdk/us_reverse_geo.rb

@@ -0,0 +1,12 @@
+require_relative './us_reverse_geo/address'
+require_relative './us_reverse_geo/client'
+require_relative './us_reverse_geo/coordinate'
+require_relative './us_reverse_geo/lookup'
+require_relative './us_reverse_geo/result'
+require_relative './us_reverse_geo/us_reverse_geo_response'
+
+module SmartyStreets
+  module USReverseGeo
+  end
+end
+

data/lib/smartystreets_ruby_sdk/us_reverse_geo/address.rb

@@ -0,0 +1,16 @@
+module SmartyStreets
+  module USReverseGeo
+    # See "https://smartystreets.com/docs/cloud/us-reverse-geo-api#address"
+    class Address
+      attr_reader :street, :city, :state_abbreviation, :zipcode
+
+      def initialize(obj)
+        @street = obj['street']
+        @city = obj['city']
+        @state_abbreviation = obj['state_abbreviation']
+        @zipcode = obj['zipcode']
+      end
+    end
+  end
+end
+

data/lib/smartystreets_ruby_sdk/us_reverse_geo/client.rb

@@ -0,0 +1,38 @@
+require_relative '../request'
+require_relative 'us_reverse_geo_response'
+
+module SmartyStreets
+  module USReverseGeo
+    # It is recommended to instantiate this class using ClientBuilder.build_us_reverse_geo_api_client()
+    class Client
+      def initialize(sender, serializer)
+        @sender = sender
+        @serializer = serializer
+      end
+
+      # Sends a Lookup object to the US Reverse Geo API and stores the result in the Lookup's response field.
+      def send(lookup)
+        request = build_request(lookup)
+
+        response = @sender.send(request)
+
+        raise response.error if response.error
+
+        lookup.response = Response.new(@serializer.deserialize(response.payload))
+      end
+
+      def build_request(lookup)
+        request = SmartyStreets::Request.new
+
+        add_parameter(request, 'latitude', lookup.latitude)
+        add_parameter(request, 'longitude', lookup.longitude)
+
+        request
+      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_reverse_geo/coordinate.rb

@@ -0,0 +1,25 @@
+module SmartyStreets
+  module USReverseGeo
+    # See "https://smartystreets.com/docs/cloud/us-reverse-geo-api#coordinate"
+    class Coordinate
+      attr_reader :latitude, :longitude, :accuracy, :license
+
+      def initialize(obj)
+        @latitude = obj.fetch('latitude', nil)
+        @longitude = obj.fetch('longitude', nil)
+        @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_reverse_geo/lookup.rb

@@ -0,0 +1,21 @@
+module SmartyStreets
+  module USReverseGeo
+    # 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.
+    #
+    # Note: Lookups must have certain required fields set with non-blank values.
+    # These can be found at the URL below.
+    #
+    # See "https://smartystreets.com/docs/cloud/us-reverse-geo-api#http-request-input-fields"
+
+    class Lookup
+
+      attr_accessor :latitude, :longitude, :response
+
+      def initialize(latitude, longitude)
+        @latitude = sprintf('%.8f', latitude)
+        @longitude = sprintf('%.8f', longitude)
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/us_reverse_geo/result.rb

@@ -0,0 +1,20 @@
+require_relative 'coordinate'
+require_relative 'address'
+
+module SmartyStreets
+  module USReverseGeo
+    # A result is a possible match for an geocode that was submitted. A lookup can have multiple results.
+    #
+    # See "https://smartystreets.com/docs/cloud/us-reverse-geo-api#result"
+    class Result
+      attr_reader :address, :coordinate, :distance
+
+      def initialize(obj)
+        @address = Address.new(obj.fetch('address', {}))
+        @coordinate = Coordinate.new(obj.fetch('coordinate', {}))
+        @distance = obj['distance']
+      end
+    end
+  end
+end
+

data/lib/smartystreets_ruby_sdk/us_reverse_geo/us_reverse_geo_response.rb

@@ -0,0 +1,17 @@
+require_relative 'result'
+
+module SmartyStreets
+  module USReverseGeo
+    class Response
+      attr_reader :results
+
+      def initialize(obj)
+        @results = []
+
+        obj['results'].each do |result|
+          @results.push(Result.new(result))
+        end
+      end
+    end
+  end
+end

data/lib/smartystreets_ruby_sdk/us_street/candidate.rb

@@ -6,10 +6,11 @@ module SmartyStreets
   module USStreet
     # See "https://smartystreets.com/docs/cloud/us-street-api#metadata"
     class Candidate
-      attr_reader :input_index, :candidate_index, :addressee, :delivery_line_1, :delivery_line_2, :delivery_point_barcode,
+      attr_reader :input_id, :input_index, :candidate_index, :addressee, :delivery_line_1, :delivery_line_2, :delivery_point_barcode,
                   :last_line, :metadata, :components, :analysis
 
       def initialize(obj)
+        @input_id = obj['input_id']
         @input_index = obj['input_index']
         @candidate_index = obj['candidate_index']
         @addressee = obj['addressee']

data/lib/smartystreets_ruby_sdk/us_street/client.rb

@@ -48,6 +48,7 @@ module SmartyStreets
         obj.each do |lookup|
           converted_lookup = {}
 
+          converted_lookup['input_id'] = lookup.input_id
           converted_lookup['street'] = lookup.street
           converted_lookup['street2'] = lookup.street2
           converted_lookup['secondary'] = lookup.secondary

data/lib/smartystreets_ruby_sdk/us_zipcode/result.rb

@@ -5,11 +5,12 @@ module SmartyStreets
   module USZipcode
     # See "https://smartystreets.com/docs/cloud/us-zipcode-api#root"
     class Result
-      attr_reader :reason, :input_index, :cities, :zipcodes, :status
+      attr_reader :reason, :input_id, :input_index, :cities, :zipcodes, :status
 
       def initialize(obj)
         @status = obj['status']
         @reason = obj['reason']
+        @input_id = obj['input_id']
         @input_index = obj['input_index']
         @cities = obj.fetch('city_states', [])
         @zipcodes = obj.fetch('zipcodes', [])

data/lib/smartystreets_ruby_sdk/version.rb

@@ -1,3 +1,3 @@
 module SmartyStreets
-  VERSION = '5.6.2' # DO NOT EDIT (this is updated by a build job when a new release is published)
+  VERSION = '5.9.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.6.2
+  version: 5.9.1
 platform: ruby
 authors:
 - SmartyStreets SDK Team
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-03-05 00:00:00.000000000 Z
+date: 2020-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -93,6 +93,7 @@ files:
 - examples/international_example.rb
 - examples/us_autocomplete_example.rb
 - examples/us_extract_example.rb
+- examples/us_reverse_geo_example.rb
 - examples/us_street_multiple_address_example.rb
 - examples/us_street_single_address_example.rb
 - examples/us_zipcode_multiple_lookup_example.rb
@@ -106,12 +107,15 @@ files:
 - lib/smartystreets_ruby_sdk/international_street.rb
 - lib/smartystreets_ruby_sdk/international_street/analysis.rb
 - lib/smartystreets_ruby_sdk/international_street/candidate.rb
+- lib/smartystreets_ruby_sdk/international_street/changes.rb
 - lib/smartystreets_ruby_sdk/international_street/client.rb
 - lib/smartystreets_ruby_sdk/international_street/components.rb
 - lib/smartystreets_ruby_sdk/international_street/language_mode.rb
 - lib/smartystreets_ruby_sdk/international_street/lookup.rb
 - lib/smartystreets_ruby_sdk/international_street/metadata.rb
+- lib/smartystreets_ruby_sdk/international_street/rootlevel.rb
 - lib/smartystreets_ruby_sdk/json_able.rb
+- lib/smartystreets_ruby_sdk/license_sender.rb
 - lib/smartystreets_ruby_sdk/logger.rb
 - lib/smartystreets_ruby_sdk/native_sender.rb
 - lib/smartystreets_ruby_sdk/native_serializer.rb
@@ -136,6 +140,13 @@ files:
 - lib/smartystreets_ruby_sdk/us_extract/lookup.rb
 - lib/smartystreets_ruby_sdk/us_extract/metadata.rb
 - lib/smartystreets_ruby_sdk/us_extract/result.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo/address.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo/client.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo/coordinate.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo/lookup.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo/result.rb
+- lib/smartystreets_ruby_sdk/us_reverse_geo/us_reverse_geo_response.rb
 - lib/smartystreets_ruby_sdk/us_street.rb
 - lib/smartystreets_ruby_sdk/us_street/analysis.rb
 - lib/smartystreets_ruby_sdk/us_street/candidate.rb
@@ -173,7 +184,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: An official library for the SmartyStreets APIs