Merge pull request #118 from amadeus4dev/location-score

Add support for Location Score API

Author: tsolakoua

README.rst

@@ -282,6 +282,9 @@ List of supported endpoints
     # Returns a single Point of Interest from a given id
     amadeus.reference_data.locations.point_of_interest('9CB40CB5D0').get()
 
+    # Location Score
+    amadeus.location.analytics.category_rated_areas.get(latitude=41.397158, longitude=2.160873)
+
     # Safe Place
     # How safe is Barcelona? (based a geo location and a radius)
     amadeus.safety.safety_rated_locations.get(latitude=41.397158, longitude=2.160873)

amadeus/location/__init__.py

@@ -0,0 +1,3 @@
+from ._analytics import Analytics
+
+__all__ = ['Analytics']

amadeus/location/_analytics.py

@@ -0,0 +1,8 @@
+from amadeus.client.decorator import Decorator
+from .analytics import CategoryRatedAreas
+
+
+class Analytics(Decorator, object):
+    def __init__(self, client):
+        Decorator.__init__(self, client)
+        self.category_rated_areas = CategoryRatedAreas(client)

amadeus/location/analytics/__init__.py

@@ -0,0 +1,3 @@
+from ._category_rated_areas import CategoryRatedAreas
+
+__all__ = ['CategoryRatedAreas']

amadeus/location/analytics/_category_rated_areas.py

@@ -0,0 +1,24 @@
+from amadeus.client.decorator import Decorator
+
+
+class CategoryRatedAreas(Decorator, object):
+    def get(self, **params):
+        '''
+        Gets popularity score for location categories
+
+        .. code-block:: python
+
+            amadeus.location.analytics.category_rated_areas.get(
+                            latitude=41.397158,
+                            longitude=2.160873)
+
+        :param latitude: latitude of geographic location to search around.
+            For example: ``41.397158``
+        :param longitude: longitude of geographic location to search around.
+            For example: ``2.160873``
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get('/v1/location/analytics/category-rated-areas',
+                               **params)

amadeus/namespaces/_location.py

@@ -0,0 +1,8 @@
+from amadeus.client.decorator import Decorator
+from amadeus.location._analytics import Analytics
+
+
+class Location(Decorator, object):
+    def __init__(self, client):
+        Decorator.__init__(self, client)
+        self.analytics = Analytics(client)

amadeus/namespaces/core.py

@@ -8,6 +8,7 @@
 from amadeus.namespaces._safety import Safety
 from amadeus.namespaces._schedule import Schedule
 from amadeus.namespaces._analytics import Analytics
+from amadeus.namespaces._location import Location
 
 
 class Core(object):
@@ -22,3 +23,4 @@ def __init__(self):
         self.safety = Safety(self)
         self.schedule = Schedule(self)
         self.analytics = Analytics(self)
+        self.location = Location(self)

docs/index.rst

@@ -208,11 +208,17 @@ Safety/SafetyRatedLocations
 Schedule/Flights
 ================
 
-.. autoclass:: amadeus.schedule.flights
+.. autoclass:: amadeus.schedule.Flights
   :members: get
 
 Analytics/ItineraryPriceMetrics
 ================
 
-.. autoclass:: amadeus.analytics.itinerary_price_metrics
+.. autoclass:: amadeus.analytics.ItineraryPriceMetrics
+  :members: get
+
+Location/Analytics
+================
+
+.. autoclass:: amadeus.location.analytics.CategoryRatedAreas
   :members: get

specs/namespaces/namespaces_spec.py

@@ -84,6 +84,9 @@
         expect(client.analytics).not_to(be_none)
         expect(client.analytics.itinerary_price_metrics).not_to(be_none)
 
+        expect(client.location).not_to(be_none)
+        expect(client.location.analytics.category_rated_areas).not_to(be_none)
+
     with it('should define all expected .get methods'):
         client = self.client
         expect(client.reference_data.urls.checkin_links.get).not_to(be_none)
@@ -139,6 +142,8 @@
 
         expect(client.analytics.itinerary_price_metrics.get).not_to(be_none)
 
+        expect(client.location.analytics.category_rated_areas.get).not_to(be_none)
+
     with it('should define all expected .delete methods'):
         client = self.client
         expect(client.booking.flight_order('123').delete).not_to(be_none)
@@ -203,6 +208,12 @@
                 '/v1/reference-data/locations/pois/XXX', a='b'
             ))
 
+        with it('.location.analytics.category_rated_areas.get'):
+            self.client.location.analytics.category_rated_areas.get(a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/location/analytics/category-rated-areas', a='b'
+            ))
+
         with it('.reference_data.recommended_locations.get'):
             self.client.reference_data.recommended_locations.get(a='b')
             expect(self.client.get).to(have_been_called_with(