Merge pull request #19 from anthonyroux/api_updated_NOV2018

Redesign of the Flight Most Searched Destinations

Author: anthonyroux

.gitignore

@@ -5,4 +5,5 @@ build
 .settings
 .classpath
 .idea
-out
+out
+.DS_Store

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2.0.0 - 2018-10-16
+
+[Flight Most Searched Destinations](https://developers.amadeus.com/self-service/category/203/api-doc/6): Redesign of the API - Split the previous endpoint in 2 endpoints:
+* 1st endpoint to find the most searched destinations
+* 2nd endpoint to have more data about a dedicated origin & destination
+
+[Flight Most Booked Destinations](https://developers.amadeus.com/self-service/category/203/api-doc/27):
+* Rename origin to originCityCode
+
+[Flight Most Traveled Destinations](https://developers.amadeus.com/self-service/category/203/api-doc/7):
+* Rename origin in originCityCode
+
+[Flight Check-in Links](https://developers.amadeus.com/self-service/category/203/api-doc/8):
+* Rename airline to airlineCode
+
+[Airport & City Search](https://developers.amadeus.com/self-service/category/203/api-doc/10):
+* Remove parameter onlyMajor
+
+[Airport Nearest Relevant](https://developers.amadeus.com/self-service/category/203/api-doc/9):
+* Add radius as parameter
+
+[Airline Code Lookup](https://developers.amadeus.com/self-service/category/203/api-doc/26):
+* Regroup parameters _IATACode_ and _ICAOCode_ under the same name _airlineCodes_
+
 ## 1.1.2 - 2018-10-28
 Contribution by [nirmalvp](https://github.com/nirmalvp)
 

README.md

@@ -34,12 +34,12 @@ You can install the SDK via Maven or Gradle.
 <dependency>
   <groupId>com.amadeus</groupId>
   <artifactId>amadeus-java</artifactId>
-  <version>1.1.2</version>
+  <version>2.0.0</version>
 </dependency>
 ```
 #### Gradle
 ```js
-compile "com.amadeus:amadeus-java:1.1.2"
+compile "com.amadeus:amadeus-java:2.0.0"
 ```
 
 ## Getting Started
@@ -126,7 +126,7 @@ This library conveniently maps every API path to a similar path.
 For example, `GET /v2/reference-data/urls/checkin-links?airline=BA` would be:
 
 ```java
-amadeus.referenceData.urls.checkinLinks.get(Params.with("airline", "BA"));
+amadeus.referenceData.urls.checkinLinks.get(Params.with("airlineCode", "BA"));
 ```
 
 Similarly, to select a resource by ID, you can pass in the ID to the **singular** path.
@@ -142,7 +142,7 @@ Keep in mind, this returns a raw `Resource`
 
 ```java
 Resource resource = amadeus.get('/v2/reference-data/urls/checkin-links',
-  Params.with("airline", "BA"));
+  Params.with("airlineCode", "BA"));
 
 resource.getResult();
 ```
@@ -181,7 +181,7 @@ If a page is not available, the method will return `null`.
 
 The SDK makes it easy to add your own logger.
 
-```java TO FIX
+```java
 import java.util.logging.Logger;
 
 // Assumes the current class is called MyLogger
@@ -227,11 +227,11 @@ FlightOffer[] flightOffers = amadeus.shopping.flightOffers.get(Params
 
 // Flight Check-in Links
 CheckinLink[] checkinLinks = amadeus.referenceData.urls.checkinLinks.get(Params
-  .with("airline", "BA"));
+  .with("airlineCode", "BA"));
 
 // Airline Code LookUp
 Airline[] airlines = amadeus.referenceData.airlines.get(Params
-  .with("IATACode", "BA"));
+  .with("airlineCodes", "BA"));
 
 // Airport & City Search (autocomplete)
 // Find all the cities and airports starting by the keyword 'LON'
@@ -248,19 +248,26 @@ Location[] locations = amadeus.referenceData.locations.airports.get(Params
   .and("longitude", 2.55));
 
 // Flight Most Searched Destinations
-FareSearch[] fareSearches = amadeus.travel.analytics.fareSearches.get(Params
-  .with("origin", "MAD")
-  .and("sourceCountry", "SP")
-  .and("period", "2017-08"));
+// Which were the most searched flight destinations from Madrid in August 2017?
+SearchedDestination searchedDestination = amadeus.travel.analytics.airTraffic.searchedByDestination.get(Params
+        .with("originCityCode", "MAD")
+        .and("destinationCityCode", "NYC")
+        .and("searchPeriod", "2017-08")
+        .and("marketCountryCode", "ES"));
+// How many people in Spain searched for a trip from Madrid to New-York in September 2017?
+Search[] search = amadeus.travel.analytics.airTraffic.searched.get(Params
+        .with("originCityCode", "MAD")
+        .and("searchPeriod", "2017-08")
+        .and("marketCountryCode", "ES"));
 
 // Flight Most Booked Destinations
 AirTraffic[] airTraffics = amadeus.travel.analytics.airTraffic.booked.get(Params
-  .with("origin", "MAD")
+  .with("originCityCode", "MAD")
   .and("period", "2017-08"));
 
 // Flight Most Traveled Destinations
 AirTraffic[] airTraffics = amadeus.travel.analytics.airTraffic.traveled.get(Params
-  .with("origin", "MAD")
+  .with("originCityCode", "MAD")
   .and("period", "2017-01"));
 
 // Flight Busiest Traveling Period

gradle.properties

@@ -1,5 +1,5 @@
 GROUP=com.amadeus
-VERSION_NAME=1.1.2
+VERSION_NAME=2.0.0
 
 POM_URL=https://github.com/amadeus4dev/amadeus-java
 POM_SCM_URL[email protected]:amadeus4dev/amadeus-java.git

src/main/java/com/amadeus/Amadeus.java

@@ -25,7 +25,7 @@ public class Amadeus extends HTTPClient {
   /**
    * The API version.
    */
-  public static final String VERSION = "1.1.2";
+  public static final String VERSION = "2.0.0";
 
   /**
    * <p>

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

@@ -40,7 +40,7 @@ public Airlines(Amadeus client) {
    *
    * <pre>
    * amadeus.referenceData.airlines.get(Params
-   *   .with("IATACode", "BA"));</pre>
+   *   .with("airlineCodes", "BA"));</pre>
    *
    * @param params the parameters to send to the API
    * @return an API response object

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

@@ -6,7 +6,6 @@
 import com.amadeus.exceptions.ResponseException;
 import com.amadeus.referenceData.locations.Airports;
 import com.amadeus.resources.Resource;
-import com.google.gson.Gson;
 
 /**
  * <p>
@@ -19,7 +18,7 @@
  * </p>
  *
  * <pre>
- * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * Amadeus amadeus = Amadeus.builder(API_KEY, API_SECRET).build();
  * amadeus.referenceData.location(locationId);</pre>
  *
  * @hide

src/main/java/com/amadeus/referenceData/urls/CheckinLinks.java

@@ -19,7 +19,7 @@
  * </p>
  *
  * <pre>
- * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * Amadeus amadeus = Amadeus.builder(API_KEY, API_SECRET).build();
  * amadeus.referenceData.urls.checkinLinks;</pre>
  */
 public class CheckinLinks {
@@ -40,7 +40,7 @@ public CheckinLinks(Amadeus client) {
    * </p>
    *
    * <pre>
-   * amadeus.referenceData.urls.checkinLinks.get(Params.with("airline", "1X"));</pre>
+   * amadeus.referenceData.urls.checkinLinks.get(Params.with("airlineCode", "BA"));</pre>
    *
    * @param params the parameters to send to the API
    * @return an API resource

src/main/java/com/amadeus/resources/AirTraffic.java

@@ -3,6 +3,8 @@
 import lombok.Getter;
 import lombok.ToString;
 
+
+
 /**
  * An AirTraffic object as returned by the AirTraffic API.
  * @see Traveled#get()