add support for retrieve pois

Author: tsolakoua

README.rst

@@ -290,6 +290,8 @@ List of supported endpoints
     amadeus.reference_data.locations.points_of_interest.get(latitude=41.397158, longitude=2.160873)
     # What are the popular places in Barcelona? (based on a square)
     amadeus.reference_data.locations.points_of_interest.by_square.get(north=41.397158, west=2.160873, south=41.394582, east=2.177181)
+    # Returns a single Point of Interest from a given id
+    amadeus.reference_data.locations.point_of_interest('9CB40CB5D0').get()
 
     # Trip Purpose Prediction
     amadeus.travel.predictions.trip_purpose.get(originLocationCode='ATH', destinationLocationCode='MAD', departureDate='2020-08-01', returnDate='2020-08-12', searchDate='2020-06-11')

amadeus/reference_data/_locations.py

@@ -1,6 +1,7 @@
 from amadeus.client.decorator import Decorator
 from amadeus.reference_data.locations._airports import Airports
 from amadeus.reference_data.locations._points_of_interest import PointsOfInterest
+from amadeus.reference_data.locations._point_of_interest import PointOfInterest
 
 
 class Locations(Decorator, object):
@@ -9,6 +10,9 @@ def __init__(self, client):
         self.airports = Airports(client)
         self.points_of_interest = PointsOfInterest(client)
 
+    def point_of_interest(self, poi_id):
+        return PointOfInterest(self.client, poi_id)
+
     def get(self, **params):
         '''
         Returns details for a specific airport.

amadeus/reference_data/locations/_point_of_interest.py

@@ -0,0 +1,21 @@
+from amadeus.client.decorator import Decorator
+
+
+class PointOfInterest(Decorator, object):
+    def __init__(self, client, poi_id):
+        Decorator.__init__(self, client)
+        self.poi_id = poi_id
+
+    def get(self, **params):
+        '''
+        Returns a single Point of Interest from a given id.
+
+        .. code-block:: python
+
+            amadeus.reference_data.locations.point_of_interest('9CB40CB5D0').get()
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get('/v1/reference-data/locations/pois/{0}'
+                               .format(self.poi_id), **params)

docs/index.rst

@@ -65,7 +65,7 @@ Shopping/Hotels
 .. autoclass:: amadeus.shopping.hotel.Offer
   :members: get
 
-Shopping/Flight Offers
+Shopping/FlightOffers
 ===============
 
 .. autoclass:: amadeus.shopping.FlightOffersPrice
@@ -89,7 +89,7 @@ Travel/Predictions
 .. autoclass:: amadeus.travel.predictions.FlightDelay
   :members: get
 
-Travel/Trip Parser
+Travel/TripParser
 ================
 
 .. autoclass:: amadeus.travel.TripParser
@@ -116,6 +116,18 @@ ReferenceData/Locations
 .. autoclass:: amadeus.reference_data.Airlines
   :members: get
 
+ReferenceData/Locations/PointsOfInterest
+=======================
+
+.. autoclass:: amadeus.reference_data.locations.PointsOfInterest
+  :members: get
+
+.. autoclass:: amadeus.reference_data.locations.points_of_interest.BySquare
+  :members: get
+
+.. autoclass:: amadeus.reference_data.locations.PointOfInterest
+  :members: get
+
 ReferenceData/Urls
 ==================
 

examples/points_of_interest/points_of_interest.py

@@ -21,3 +21,12 @@
     # print(response.data)
 except ResponseError as error:
     raise error
+
+try:
+    '''
+    Give me information about a place based on it's ID
+    '''
+    response = amadeus.reference_data.locations.point_of_interest('9CB40CB5D0').get()
+    # print(response.data)
+except ResponseError as error:
+    raise error

specs/namespaces/namespaces_spec.py

@@ -24,7 +24,7 @@
         expect(
             client.reference_data.locations.points_of_interest.by_square).not_to(
             be_none)
-
+        expect(client.reference_data.locations.point_of_interest).not_to(be_none)
         expect(client.travel).not_to(be_none)
         expect(client.travel.analytics).not_to(be_none)
         expect(client.travel.analytics.air_traffic.traveled).not_to(be_none)
@@ -80,6 +80,8 @@
         expect(
             client.reference_data.locations.points_of_interest.by_square.get
             ).not_to(be_none)
+        expect(client.reference_data.locations.point_of_interest(
+            '9CB40CB5D0').get).not_to(be_none)
 
         expect(client.travel.analytics.air_traffic.traveled.get).not_to(be_none)
         expect(client.travel.analytics.air_traffic.booked.get).not_to(be_none)
@@ -170,6 +172,13 @@
                 '/v1/reference-data/locations/pois/by-square', a='b'
             ))
 
+        with it('.reference_data.locations.point_of_interest().get'):
+            self.client.reference_data.locations.point_of_interest(
+                'XXX').get(a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/reference-data/locations/pois/XXX', a='b'
+            ))
+
         with it('.travel.analytics.air_traffic.traveled.get'):
             self.client.travel.analytics.air_traffic.traveled.get(a='b')
             expect(self.client.get).to(have_been_called_with(