Merge pull request #98 from smarty/max/custom-parameters

Max/custom parameters

Author: maxwellpothier

examples/international_address_autocomplete.js

@@ -24,6 +24,9 @@ const client = clientBuilder.buildInternationalAddressAutocompleteClient();
 const country = "CAN";
 
 const summaryLookup = new Lookup({search: "123 Anson", country});
+// uncomment the following line to add a custom parameter
+// summaryLookup.addCustomParameter("max_results", 1);
+
 await handleRequest(summaryLookup, "Response of summary results");
 
 const detailedLookup = new Lookup({addressId: summaryLookup.result[0].addressId, country});

examples/international_street.js

@@ -23,6 +23,8 @@ let client = clientBuilder.buildInternationalStreetClient();
 // https://www.smarty.com/docs/cloud/international-street-api#http-input-fields
 
 let lookup1 = new Lookup("CA", "262 Browndale Cr, Richmond Hill, ON");
+// uncomment the following line to add a custom parameter
+// lookup1.addCustomParameter("input_id", 1234);
 
 let lookup2 = new Lookup();
 lookup2.inputId = "ID-8675309";

examples/us_autocomplete_pro.js

@@ -24,6 +24,8 @@ let client = clientBuilder.buildUsAutocompleteProClient();
 
 // *** Simple Lookup ***
 let lookup = new Lookup("4770 Lincoln");
+// uncomment the following line to add a custom parameter
+// lookup.addCustomParameter("max_results", 3);
 
 await handleRequest(lookup, "Simple Lookup");
 
@@ -60,4 +62,4 @@ async function handleRequest(lookup, lookupType) {
 	} catch(err) {
 		console.log(err)
 	}
-}
+}

examples/us_enrichment.js

@@ -23,6 +23,8 @@ let client = clientBuilder.buildUsEnrichmentClient();
 // https://www.smarty.com/docs/us-street-api#input-fields
 
 let lookup = new Lookup("334968275");
+// uncomment the following line to add a custom parameter
+// lookup.addCustomParameter("include", "group_financial");
 
 handleResponse(lookup).then();
 

examples/us_extract.js

@@ -24,6 +24,9 @@ lookup.aggressive = true;
 lookup.addressesHaveLineBreaks = false;
 lookup.addressesPerLine = 1;
 
+// uncomment the following line to add a custom parameter
+// lookup.addCustomParameter("addr_line_breaks", false);
+
 await handleRequest(lookup);
 
 function logResult(response) {

examples/us_reverse_geo.js

@@ -18,7 +18,9 @@ let clientBuilder = new SmartyCore.ClientBuilder(credentials).withLicenses(["us-
 	// .withBaseUrl("YOUR URL") // withBaseUrl() should be used if you are self-hosting the Smarty API
 let client = clientBuilder.buildUsReverseGeoClient();
 
-let lookup1 = new Lookup(40.27644, -111.65747, "all");
+let lookup1 = new Lookup(40.27644, -111.65747);
+// uncomment the following line to add a custom parameter
+// lookup1.addCustomParameter("source", "all");
 
 await handleResponse(lookup1);
 

examples/us_street.js

@@ -45,7 +45,9 @@ lookup2.maxCandidates = 5;
 let lookup3 = new Lookup();
 lookup3.inputId = "8675309";
 lookup3.street = "1600 Amphitheatre Parkway Mountain View, CA 94043";
-lookup3.maxCandidates = 1;
+
+// uncomment the following line to add a custom parameter
+// lookup3.addCustomParameter("max_candidates", 1);
 
 // NOTE: batches are not supported when using SharedCredentials.
 let batch = new SmartyCore.Batch();

examples/us_zipcode.js

@@ -33,6 +33,9 @@ let lookup3 = new Lookup();
 lookup3.city = "Phoenix";
 lookup3.state = "AZ";
 
+// uncomment the following line to add a custom parameter
+// lookup3.addCustomParameter("input_id", 1234);
+
 let batch = new SmartyCore.Batch();
 batch.add(lookup1);
 batch.add(lookup2);

src/InputData.js

@@ -8,6 +8,10 @@ class InputData {
 		if (this.lookupFieldIsPopulated(lookupField)) this.data[apiField] = this.formatData(this.lookup[lookupField]);
 	}
 
+	addCustomParameter(key, value) {
+		this.data[key] = value;
+	}
+
 	formatData(field) {
 		if (Array.isArray(field)) return field.join(";");
 		else return field;

src/international_address_autocomplete/Lookup.js

@@ -8,6 +8,11 @@ class Lookup {
 		this.maxResults = maxResults;
 		this.includeOnlyLocality = includeOnlyLocality;
 		this.includeOnlyPostalCode = includeOnlyPostalCode;
+		this.customParameters = {};
+	}
+
+	addCustomParameter(key, value) {
+		this.customParameters[key] = value;
 	}
 }