Redesign of the Flight Most Searched Destinations API

Author: Anthony Roux

.github/CONTRIBUTING.md

@@ -3,7 +3,7 @@
 To run the project locally, clone the repository, and then create a virtual environment and install the dependencies.
 ```sh
 git clone https://github.com/amadeus4dev/amadeus-python.git
-cd amadeus-ruby
+cd amadeus-python
 ```
 
 First, ensure you have a version of every Python we support installed. Your versions may differ.

CHANGELOG.rst

@@ -1,6 +1,38 @@
 Changelog
 =========
 
+2.0.0 - 2018-10-14
+-------------------- 
+
+`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.0 - 2018-08-01
 --------------------
 

amadeus/travel/_analytics.py

@@ -1,10 +1,9 @@
 from amadeus.client.decorator import Decorator
 from .analytics._air_traffic import AirTraffic
-from .analytics._fare_searches import FareSearches
+
 
 
 class Analytics(Decorator, object):
     def __init__(self, client):
         Decorator.__init__(self, client)
-        self.fare_searches = FareSearches(client)
         self.air_traffic = AirTraffic(client)

amadeus/travel/analytics/__init__.py

@@ -1,5 +1,4 @@
-from ._fare_searches import FareSearches
 from ._air_traffic import AirTraffic
 
 
-__all__ = ['FareSearches', 'AirTraffic']
+__all__ = ['AirTraffic']

amadeus/travel/analytics/_air_traffic.py

@@ -1,6 +1,8 @@
 from amadeus.client.decorator import Decorator
 from .air_traffic._traveled import Traveled
 from .air_traffic._booked import Booked
+from .air_traffic._searched import Searched
+from .air_traffic._searched_by_destination import SearchedByDestination
 from .air_traffic._busiest_period import BusiestPeriod
 
 
@@ -9,4 +11,6 @@ def __init__(self, client):
         Decorator.__init__(self, client)
         self.booked = Booked(client)
         self.traveled = Traveled(client)
+        self.searched = Searched(client)
+        self.searched_by_destination = SearchedByDestination(client)
         self.busiest_period = BusiestPeriod(client)

amadeus/travel/analytics/_fare_searches.py

@@ -1,6 +1,8 @@
 from ._traveled import Traveled
+from ._searched import Searched
+from ._searched_by_destination import SearchedByDestination
 from ._booked import Booked
 from ._busiest_period import BusiestPeriod
 
 
-__all__ = ['Traveled', 'Booked', 'BusiestPeriod']
+__all__ = ['Searched', 'SearchedByDestination', 'Traveled', 'Booked', 'BusiestPeriod']

amadeus/travel/analytics/air_traffic/__init__.py

@@ -0,0 +1,29 @@
+from amadeus.client.decorator import Decorator
+
+
+class Searched(Decorator, object):
+    def get(self, **params):
+        '''
+        Returns a list of air traffic reports, based on number of searches.
+
+        .. code-block:: python
+
+            amadeus.travel.analytics.air_traffic.searched.get(
+                originCityCode='MAD',
+                searchPeriod='2017-08',
+                marketCountryCode='ES'
+            )
+
+        :param originCityCode: IATA code of the origin city, for
+            example ``"MAD"`` for Madrid.
+        :param searchPeriod: period when consumers are traveling
+            in ``YYYY-MM`` format
+        :param marketCountryCode: IATA code of the country from which
+            searches were made - e.g. ``"ES"`` for Spain
+
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get('/v1/travel/analytics/air-traffic/searched',
+                               **params)

amadeus/travel/analytics/air_traffic/_searched.py

@@ -0,0 +1,32 @@
+from amadeus.client.decorator import Decorator
+
+
+class SearchedByDestination(Decorator, object):
+    def get(self, **params):
+        '''
+        The Flight Most Searched Destinations API allows to find the number of
+        estimated searches from an origin and a destination,
+        within a time period when travelers are performing the searches.
+
+        .. code-block:: python
+
+            amadeus.travel.analytics.air_traffic.searched_by_destination.get(
+                originCityCode='MAD',
+                destinationCityCode='NYC',
+                marketCountryCode='ES'
+                searchPeriod='2017-08'
+            )
+
+        :param originCityCode: IATA code of the origin city, for
+            example ``"MAD"`` for Madrid.
+        :param destinationCityCode: IATA code of the destination city, for
+            example ``"NYC"`` for New-York.
+        :param marketCountryCode: IATA code of the country from which
+            searches were made - e.g. ``"ES"`` for Spain
+        :param searchPeriod: period when consumers are traveling
+            in ``YYYY-MM`` format
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get('/v1/travel/analytics/air-traffic/searched/by-destination', **params)

amadeus/travel/analytics/air_traffic/_searched_by_destination.py

@@ -1,2 +1,2 @@
-version_info = (1, 1, 0)
+version_info = (2, 0, 0)
 version = '.'.join(str(v) for v in version_info)