smartystreets_ruby_sdk 5.19.0 → 5.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51cb2a009b7e285e29d6f6fb5e689a365105c69b1ee91988708a54277c646e36
-  data.tar.gz: 2125742bceda76772db7d941461247cc4a30d4bb09a70092d58b51f8857b5281
+  metadata.gz: feea3fd221e9e87912c8d35bd636b8c295ae0415ef20cc45880b330d1199ce3f
+  data.tar.gz: e0d8168d70e4edf32906f49ec0cb39b1f7890804a7067e80cf7538e1db1ba24c
 SHA512:
-  metadata.gz: 4c24e7dd98c9b13c60567a41f6b41e111cde5dfc65b730541eabca7eb68b9b24d1f67b81165205aa52db00fca1c58efcde3473fe74c2530b77d52ab8230da809
-  data.tar.gz: 9c5ca611177e645518e1dc4dffdc4762a8580dfc1a8a51c0fdd62c0b00a24962c2ef91b5d2e9e73e13760c6c0766c045f205f8bc00d5fa069ad3815dd71bb7b4
+  metadata.gz: 17120bcc323bd9dd58ce32520fdfe8993afaf352dd595bbc2316a33cddd5e8ab44b4c2728b807488ab601be72e68a4627b5ea3a5b4a5825bb9843e0ffeb2e0eb
+  data.tar.gz: a9535cac7038a34e74101d551781368d883c9aafd12ef9b5dbe52d37c158cf8d3253cb179a1ce2a872cb928660a40c599e92a163ee3e7f1d4a0fbfcc165d64d7

data/examples/us_enrichment_example.rb

@@ -1,6 +1,7 @@
 require '../lib/smartystreets_ruby_sdk/static_credentials'
 require '../lib/smartystreets_ruby_sdk/shared_credentials'
 require '../lib/smartystreets_ruby_sdk/client_builder'
+require '../lib/smartystreets_ruby_sdk/us_enrichment/lookup'
 
 class USEnrichmentAddressExample
   def run
@@ -24,9 +25,35 @@ class USEnrichmentAddressExample
     client = SmartyStreets::ClientBuilder.new(credentials).
              build_us_enrichment_api_client
     result = nil
+
+    # Create a new lookup instance to search with address components
+    lookup = SmartyStreets::USEnrichment::Lookup.new
+
+    lookup.street = "56 Union Ave"
+    lookup.city = "Somerville"
+    lookup.state = "NJ"
+    lookup.zipcode = "08876"
+
+    # Or, create a freeform lookup to search using a single line address
+    freeform_lookup = SmartyStreets::USEnrichment::Lookup.new
+    freeform_lookup.freeform = "56 Union Ave Somerville NJ 08876"
+
+    
+
     begin
-      result = client.send_property_financial_lookup("765613032")
-    #   result = client.send_property_principal_lookup("765613032")
+      # Send a lookup with a smarty key using the line below
+      result = client.send_property_principal_lookup("325023201")
+
+      # Uncomment the following lines to perform other types of lookups:
+      # result = client.send_property_principal_lookup(lookup) # Using address components
+      # result = client.send_property_principal_lookup(freeform_lookup) # Using freeform address
+       
+      # Access the other Enrichment datasets using the below functions. All of these functions can take a lookup or a smartykey
+      # result = client.send_property_financial_lookup("325023201")
+      # result = client.send_geo_reference_lookup("325023201")
+      # result = client.send_secondary_lookup("325023201")
+      # result = client.send_secondary_count_lookup("325023201")
+
     rescue SmartyStreets::SmartyError => err
       puts err
       return

data/lib/smartystreets_ruby_sdk/us_enrichment/client.rb

@@ -19,40 +19,89 @@ module SmartyStreets
                 @serializer = serializer
             end
 
-            def send_property_financial_lookup(smarty_key)
-                __send(USEnrichment::Property::Financial::Lookup.new(smarty_key))
+            def send_property_financial_lookup(lookup)
+                if (lookup.instance_of? String)
+                    __send(USEnrichment::Property::Financial::Lookup.new(lookup))
+                elsif (lookup.instance_of? USEnrichment::Lookup)
+                    lookup.data_set = 'property'
+                    lookup.data_sub_set = 'financial'
+                    __send(lookup)
+                end
             end
 
-            def send_property_principal_lookup(smarty_key)
-                __send(USEnrichment::Property::Principal::Lookup.new(smarty_key))
+            def send_property_principal_lookup(lookup)
+                if (lookup.instance_of? String)
+                    __send(USEnrichment::Property::Principal::Lookup.new(lookup))
+                elsif (lookup.instance_of? USEnrichment::Lookup)
+                    lookup.data_set = 'property'
+                    lookup.data_sub_set = 'principal'
+                    __send(lookup)
+                end
             end
 
-            def send_geo_reference_lookup(smarty_key)
-                __send(USEnrichment::GeoReference::Lookup.new(smarty_key))
+            def send_geo_reference_lookup(lookup)
+                if (lookup.instance_of? String)
+                    __send(USEnrichment::GeoReference::Lookup.new(lookup))
+                elsif (lookup.instance_of? USEnrichment::Lookup)
+                    lookup.data_set = 'geo-reference'
+                    lookup.data_sub_set = nil
+                    __send(lookup)
+                end
             end
 
-            def send_secondary_lookup(smarty_key)
-                __send(USEnrichment::Secondary::Lookup.new(smarty_key))
+            def send_secondary_lookup(lookup)
+                if (lookup.instance_of? String)
+                    __send(USEnrichment::Secondary::Lookup.new(lookup))
+                elsif (lookup.instance_of? USEnrichment::Lookup)
+                    lookup.data_set = 'secondary'
+                    lookup.data_sub_set = nil
+                    __send(lookup)
+                end
             end
 
-            def send_secondary_count_lookup(smarty_key)
-                __send(USEnrichment::Secondary::Count::Lookup.new(smarty_key))
+            def send_secondary_count_lookup(lookup)
+                if (lookup.instance_of? String)
+                    __send(USEnrichment::Secondary::Count::Lookup.new(lookup))
+                elsif (lookup.instance_of? USEnrichment::Lookup)
+                    lookup.data_set = 'secondary'
+                    lookup.data_sub_set = 'count'
+                    __send(lookup)
+                end
             end
 
-            def send_generic_lookup(smarty_key, data_set, data_sub_set = nil)
-                __send(USEnrichment::Lookup.new(smarty_key, data_set, data_sub_set))
+            def send_generic_lookup(lookup, data_set, data_sub_set = nil)
+                if (lookup.instance_of? String)
+                    __send(USEnrichment::Lookup.new(lookup, data_set, data_sub_set))
+                elsif (lookup.instance_of? USEnrichment::Lookup)
+                    lookup.data_set = data_set
+                    lookup.data_sub_set = data_sub_set
+                    __send(lookup)
+                end
             end
 
             def __send(lookup)
                 smarty_request = Request.new
 
                 return if lookup.nil?
-
-                if (lookup.data_sub_set.nil?)
-                    smarty_request.url_components = '/' + lookup.smarty_key + '/' + lookup.data_set
+                if (lookup.smarty_key.nil?)
+                    if (lookup.data_sub_set.nil?)
+                        smarty_request.url_components = '/search/' + lookup.data_set
+                    else
+                        smarty_request.url_components = '/search/' + lookup.data_set + '/' + lookup.data_sub_set
+                    end
+                    add_parameter(smarty_request, 'freeform', lookup.freeform)
+                    add_parameter(smarty_request, 'street', lookup.street)
+                    add_parameter(smarty_request, 'city', lookup.city)
+                    add_parameter(smarty_request, 'state', lookup.state)
+                    add_parameter(smarty_request, 'zipcode', lookup.zipcode)
                 else
-                    smarty_request.url_components = '/' + lookup.smarty_key + '/' + lookup.data_set + '/' + lookup.data_sub_set
+                    if (lookup.data_sub_set.nil?)
+                        smarty_request.url_components = '/' + lookup.smarty_key + '/' + lookup.data_set
+                    else
+                        smarty_request.url_components = '/' + lookup.smarty_key + '/' + lookup.data_set + '/' + lookup.data_sub_set
+                    end
                 end
+                
 
                 response = @sender.send(smarty_request)
                 results = @serializer.deserialize(response.payload)
@@ -83,6 +132,10 @@ module SmartyStreets
                 end
                 output
             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_enrichment/lookup.rb

@@ -1,12 +1,18 @@
+require_relative '../json_able'
 module SmartyStreets
   module USEnrichment
-    class Lookup
-      attr_reader :smarty_key, :data_set, :data_sub_set
+    class Lookup < JSONAble
+      attr_accessor :smarty_key, :data_set, :data_sub_set, :freeform, :street, :city, :state, :zipcode
               
-      def initialize(smarty_key, data_set, data_sub_set)
+      def initialize(smarty_key=nil, data_set=nil, data_sub_set=nil, freeform=nil, street=nil, city=nil, state=nil, zipcode=nil)
         @smarty_key = smarty_key
         @data_set = data_set
         @data_sub_set = data_sub_set
+        @freeform = freeform
+        @street = street
+        @city = city
+        @state = state
+        @zipcode = zipcode
       end
     end
   end

data/lib/smartystreets_ruby_sdk/version.rb

@@ -1,3 +1,3 @@
 module SmartyStreets
-  VERSION = '5.19.0' # DO NOT EDIT (this is updated by a build job when a new release is published)
+  VERSION = '5.20.2' # 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.19.0
+  version: 5.20.2
 platform: ruby
 authors:
 - SmartyStreets SDK Team
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-08-12 00:00:00.000000000 Z
+date: 2024-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler