Add max group results and geolocation to international autocomplete api.

Author: RyanLCox1

src/main/java/com/smartystreets/api/international_autocomplete/Client.java

@@ -45,6 +45,10 @@ private Request buildRequest(Lookup lookup) {
         request.putParameter("country", lookup.getCountry());
         request.putParameter("search", lookup.getSearch());
         request.putParameter("max_results", String.valueOf(lookup.getMaxResults()));
+        request.putParameter("max_group_results", String.valueOf(lookup.getMaxGroupResults()));
+        if (lookup.isGeolocation()) {
+            request.putParameter("geolocation", "on");
+        }
         request.putParameter("include_only_locality", lookup.getLocality());
         request.putParameter("include_only_postal_code", lookup.getPostalCode());
 

src/main/java/com/smartystreets/api/international_autocomplete/Lookup.java

@@ -9,6 +9,7 @@
 public class Lookup {
     static final int MAX_RESULTS_DEFAULT = 5;
     static final int DISTANCE_DEFAULT = 5;
+    static final int MAX_GROUP_RESULTS_DEFAULT = 100;
 
     //region [ Fields ]
 
@@ -17,6 +18,8 @@ public class Lookup {
     private String search;
     private String addressID;
     private int maxResults;
+    private int maxGroupResults;
+    private boolean geolocation;
     private String locality;
     private String postalCode;
 
@@ -29,6 +32,7 @@ public class Lookup {
      */
     public Lookup() {
         this.maxResults = MAX_RESULTS_DEFAULT;
+        this.maxGroupResults = MAX_GROUP_RESULTS_DEFAULT;
     }
 
     /**
@@ -67,6 +71,14 @@ public int getMaxResults() {
         return this.maxResults;
     }
 
+    public int getMaxGroupResults() {
+        return this.maxGroupResults;
+    }
+
+    public boolean isGeolocation() {
+        return this.geolocation;
+    }
+
     public String getLocality() {
         return this.locality;
     }
@@ -98,6 +110,14 @@ public void setMaxResults(int maxResults) {
         this.maxResults = maxResults;
     }
 
+    public void setMaxGroupResults(int maxGroupResults) {
+        this.maxGroupResults = maxGroupResults;
+    }
+
+    public void setGeolocation(boolean geolocation) {
+        this.geolocation = geolocation;
+    }
+
     public void setLocality(String locality) {
         this.locality = locality;
     }

src/main/java/examples/InternationalAutocompleteExample.java

@@ -24,6 +24,8 @@ public static void main(String[] args) {
 
             lookup.setCountry("FRA");
             lookup.setLocality("Paris");
+            lookup.setMaxGroupResults(50);
+            lookup.setGeolocation(true);
 
             client.send(lookup);
 

src/test/java/com/smartystreets/api/international_autocomplete/ClientTest.java

@@ -10,6 +10,8 @@
 
 import static org.junit.Assert.assertArrayEquals;
 import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.assertFalse;
 
 public class ClientTest {
     //region [ Single Lookup ]
@@ -23,7 +25,7 @@ public void testSendingSinglePrefixOnlyLookup() throws Exception {
 
         client.send(new Lookup("1"));
 
-        assertEquals("http://localhost/?search=1&max_results=5", capturingSender.getRequest().getUrl());
+        assertEquals("http://localhost/?search=1&max_results=5&max_group_results=100", capturingSender.getRequest().getUrl());
     }
 
     @Test
@@ -32,7 +34,7 @@ public void testSendingSinglePartiallyPopulatedLookup() throws Exception {
         URLPrefixSender sender = new URLPrefixSender("http://localhost/", capturingSender);
         FakeSerializer serializer = new FakeSerializer(new Result());
         Client client = new Client(sender, serializer);
-        String expectedURL = "http://localhost/?country=1&search=2&max_results=5&include_only_locality=4&include_only_postal_code=5";
+        String expectedURL = "http://localhost/?country=1&search=2&max_results=5&max_group_results=100&include_only_locality=4&include_only_postal_code=5";
         Lookup lookup = new Lookup();
         lookup.setCountry("1");
         lookup.setSearch("2");
@@ -50,7 +52,7 @@ public void testSendingSingleFullyPopulatedLookup() throws Exception {
         URLPrefixSender sender = new URLPrefixSender("http://localhost/", capturingSender);
         FakeSerializer serializer = new FakeSerializer(new Result());
         Client client = new Client(sender, serializer);
-        String expectedURL = "http://localhost/?country=1&search=2&max_results=10&include_only_locality=4&include_only_postal_code=5";
+        String expectedURL = "http://localhost/?country=1&search=2&max_results=10&max_group_results=100&include_only_locality=4&include_only_postal_code=5";
         Lookup lookup = new Lookup();
         lookup.setCountry("1");
         lookup.setSearch("2");
@@ -63,6 +65,43 @@ public void testSendingSingleFullyPopulatedLookup() throws Exception {
         assertEquals(expectedURL, capturingSender.getRequest().getUrl());
     }
 
+    @Test
+    public void testSendingLookupWithGeolocation() throws Exception {
+        RequestCapturingSender capturingSender = new RequestCapturingSender();
+        URLPrefixSender sender = new URLPrefixSender("http://localhost/", capturingSender);
+        FakeSerializer serializer = new FakeSerializer(new Result());
+        Client client = new Client(sender, serializer);
+        Lookup lookup = new Lookup("1");
+        lookup.setGeolocation(true);
+
+        client.send(lookup);
+
+        assertTrue(capturingSender.getRequest().getUrl().contains("geolocation=on"));
+    }
+
+    @Test
+    public void testSendingLookupWithCustomMaxGroupResults() throws Exception {
+        RequestCapturingSender capturingSender = new RequestCapturingSender();
+        URLPrefixSender sender = new URLPrefixSender("http://localhost/", capturingSender);
+        FakeSerializer serializer = new FakeSerializer(new Result());
+        Client client = new Client(sender, serializer);
+        Lookup lookup = new Lookup("1");
+        lookup.setMaxGroupResults(50);
+
+        client.send(lookup);
+
+        assertTrue(capturingSender.getRequest().getUrl().contains("max_group_results=50"));
+    }
+
+    @Test
+    public void testDefaultValues() {
+        Lookup lookup = new Lookup();
+
+        assertEquals(5, lookup.getMaxResults());
+        assertEquals(100, lookup.getMaxGroupResults());
+        assertFalse(lookup.isGeolocation());
+    }
+
     //endregion
 
     //region [ Response Handling ]