Merge pull request #83 from amadeus4dev/travel-recommendations

Add support for Travel Recommendations API

Author: tsolakoua

README.md

@@ -351,6 +351,11 @@ Prediction tripPurpose = amadeus.travel.predictions.tripPurpose.get(Params
     .and("destinationLocationCode", "MAD")
     .and("departureDate", "2020-08-01")
     .and("returnDate", "2020-08-12"));
+
+// Travel Recommendations
+Location destinations = amadeus.referenceData.recommendedLocations.get(Params
+    .with("cityCodes", "PAR")
+    .and("travelerCountryCode", "FR"));
 ```
 
 ## Development & Contributing

src/main/java/com/amadeus/ReferenceData.java

@@ -3,6 +3,7 @@
 import com.amadeus.referenceData.Airlines;
 import com.amadeus.referenceData.Location;
 import com.amadeus.referenceData.Locations;
+import com.amadeus.referenceData.RecommendedLocations;
 import com.amadeus.referenceData.Urls;
 
 /**
@@ -48,6 +49,14 @@ public class ReferenceData {
    */
   public Airlines airlines;
 
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/reference-data/recommended-locations</code> endpoints.
+   * </p>
+   */
+  public RecommendedLocations recommendedLocations;
+
 
   /**
    * Constructor.
@@ -58,6 +67,7 @@ public ReferenceData(Amadeus client) {
     this.urls = new Urls(client);
     this.locations = new Locations(client);
     this.airlines = new Airlines(client);
+    this.recommendedLocations = new RecommendedLocations(client);
   }
 
   /**

src/main/java/com/amadeus/referenceData/RecommendedLocations.java

@@ -0,0 +1,62 @@
+package com.amadeus.referenceData;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.Response;
+import com.amadeus.exceptions.ResponseException;
+import com.amadeus.resources.Location;
+import com.amadeus.resources.Resource;
+import com.google.gson.Gson;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/reference-data/recommended-locations</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.referenceData.recommendedLocations;</pre>
+ */
+public class RecommendedLocations {
+  private Amadeus client;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public RecommendedLocations(Amadeus client) {
+    this.client = client;
+  }
+
+  /**
+   * <p>
+   *   Returns a list of destination recommendations.
+   * </p>
+   *
+   * <pre>
+   * amadeus.referenceData.recommendedLocations.get(Params
+   *   .with("cityCodes", "PAR")
+   *   .and("travelerCountryCode", "FR"));</pre>
+   *
+   * @param params the parameters to send to the API
+   * @return an API response object
+   * @throws ResponseException when an exception occurs
+   */
+  public Location[] get(Params params) throws ResponseException {
+    Response response = client.get("/v1/reference-data/recommended-locations", params);
+    return (Location[]) Resource.fromArray(response, Location[].class);
+  }
+
+  /**
+   * Convenience method for calling <code>get</code> without any parameters.
+   * @see Location#get()
+   */
+  public Location[] get() throws ResponseException {
+    return get(null);
+  }
+}

src/test/java/com/amadeus/NamespaceTest.java

@@ -10,6 +10,7 @@
 import com.amadeus.referenceData.Airlines;
 import com.amadeus.referenceData.Location;
 import com.amadeus.referenceData.Locations;
+import com.amadeus.referenceData.RecommendedLocations;
 import com.amadeus.referenceData.locations.Airports;
 import com.amadeus.referenceData.locations.PointsOfInterest;
 import com.amadeus.referenceData.urls.CheckinLinks;
@@ -54,6 +55,7 @@ public void testAllNamespacesExist() {
     TestCase.assertNotNull(client.referenceData.locations.pointsOfInterest.bySquare);
     TestCase.assertNotNull(client.referenceData.locations.pointOfInterest("XXX"));
     TestCase.assertNotNull(client.referenceData.location("123"));
+    TestCase.assertNotNull(client.referenceData.recommendedLocations);
     TestCase.assertNotNull(client.referenceData.airlines);
     TestCase.assertNotNull(client.travel.analytics.airTraffic.traveled);
     TestCase.assertNotNull(client.travel.analytics.airTraffic.booked);
@@ -164,6 +166,16 @@ public void testGetMethods() throws ResponseException {
     TestCase.assertNotNull(poi.get(params));
     TestCase.assertEquals(poi.get().length, 2);
 
+    // Testing travel recommendations
+    Mockito.when(client.get("/v1/reference-data/recommended-locations", null))
+        .thenReturn(multiResponse);
+    Mockito.when(client.get("/v1/reference-data/recommended-locations", params))
+        .thenReturn(multiResponse);
+    RecommendedLocations destinations = new RecommendedLocations(client);
+    TestCase.assertNotNull(destinations.get());
+    TestCase.assertNotNull(destinations.get(params));
+    TestCase.assertEquals(destinations.get().length, 2);
+
     // Testing safe place by coordinates
     Mockito.when(client.get("/v1/safety/safety-rated-locations", null))
         .thenReturn(multiResponse);