amadeus 3.2.0 → 5.2.0

data/lib/amadeus/namespaces/airport/predictions/on_time.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Airport
+      class Predictions
+        # A namespaced client for the
+        # +/v1/airport/predictions/on_time+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.airport.predictions.on_time
+        #
+        class OnTime < Amadeus::Client::Decorator
+          # Returns a prediction on airport performance.
+          #
+          # @option params [String] :airportCode IATA code of the airport
+          # @option params [String] :date date of the prediction, in the future
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call failed
+          # @example
+          #   amadeus.airport.predictions.on_time.get(airportCode: 'JFK', date: '2020-09-01')
+          #
+          def get(params = {})
+            client.get('/v1/airport/predictions/on-time', params)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/analytics.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v1/analytics+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.analytics
+    #
+    class Analytics < Amadeus::Client::Decorator
+      # The namespace for the Analytics-ItineraryPriceMetrics API:
+      #
+      # @return [Amadeus::Namespaces::Analytics::ItineraryPriceMetrics]
+      # @example
+      #   amadeus.analytics.itinerary_price_metrics
+      #
+      def itinerary_price_metrics
+        Amadeus::Namespaces::Analytics::ItineraryPriceMetrics.new(client)
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/analytics/itinerary_price_metrics.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Analytics
+      # A namespaced client for the
+      # +/v1/analytics/itinerary-price-metrics+ endpoint
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.analytics.itinerary_price_metrics
+      #
+      class ItineraryPriceMetrics < Amadeus::Client::Decorator
+        # Returns historical flight prices by date and route so you can see how current ticket
+        # prices stack up against the historical average
+        #
+        # @option params [String] :originIataCode IATA code of the airport to depart from
+        # @option params [String] :destinationIataCode IATA code of the airport to arrive at
+        # @option params [String] :departureDate date to depart on, formatted as YYYY-MM-DD
+        # @option params [String] :currencyCode the preferred currency (ISO 4217) - optional
+        # @option params [Boolean] :oneWay retrieve prices for one-way only - optional
+        # @return [Amadeus::Response] a parsed response
+        # @raise [Amadeus::Base] an exception if the call failed
+        # @example
+        #   amadeus.analytics.itinerary_price_metrics.get(
+        #     originIataCode: 'AMS',
+        #     destinationIataCode: 'CDG',
+        #     departureDate: '2021-06-18'
+        #   )
+        #
+        def get(params = {})
+          client.get('/v1/analytics/itinerary-price-metrics', params)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/booking.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v1/booking+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.booking
+    #
+    class Booking < Amadeus::Client::Decorator
+      # The namespace for the Booking APIs:
+      #
+      # @return [Amadeus::Namespaces::Booking::HotelBookings]
+      # @example
+      #   amadeus.booking.hotel_bookings
+      #
+      def hotel_bookings
+        Amadeus::Namespaces::Booking::HotelBookings.new(client)
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/booking/hotel_bookings.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Booking
+      # A namespaced client for the
+      # +/v1/booking/hotel_bookings+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.booking.hotel_bookings
+      #
+      class HotelBookings < Amadeus::Client::Decorator
+        # Book a specific room
+        #
+        # The parameters guests and payments can be passed as dictionary
+        # or list of dictionaries. If they are dictionary in this method they are
+        # converted to a list of dictionaries.
+        #
+        # @option params [String] :hotelIds list of hotel ids separated by comas
+        # @return [Amadeus:Response] a parsed response
+        # @raise [Amadeus:Base] an exception if the call failed
+        # @example book for a hotel offer
+        #  amadeus.booking.hotel_bookings.post(
+        #     hotel_offer_id, guests, payments
+        #   )
+        #
+        def post(hotel_offer_id, guests, payments)
+          body = prepare_body(hotel_offer_id, guests, payments)
+
+          client.post('/v1/booking/hotel-bookings', body.to_json)
+        end
+
+        def prepare_body(hotel_offer_id, guests, payments)
+          guests_info = [], pay_info = []
+
+          guests.is_a?(Array) ? guests_info.push(guests).flatten! : guests_info.push(guests)
+          payments.is_a?(Array) ? pay_info.push(payments).flatten! : pay_info.push(payments)
+
+          {
+            'data' => {
+              'offerId' => hotel_offer_id,
+              'guests' => guests_info,
+              'payments' => pay_info
+            }
+          }
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/core.rb

@@ -37,6 +37,16 @@ module Amadeus
       Shopping.new(self)
     end
 
+    # The namespace for the booking APIs:
+    #
+    # @return [Amadeus::Namespaces::Booking]
+    # @example Some of the further namespaces available
+    #   amadeus.booking.hotel_bookings
+    #
+    def booking
+      Booking.new(self)
+    end
+
     # The namespace for the travel analytics APIs:
     #
     # @return [Amadeus::Namespaces::Travel]
@@ -47,5 +57,45 @@ module Amadeus
     def travel
       Travel.new(self)
     end
+
+    # The namespace for the E Reputation  APIs:
+    #
+    # @return [Amadeus::Namespaces::EReputation]
+    # @example Some of the further namespaces available
+    #   amadeus.e_reputation.hotel_sentiments
+    #
+    def e_reputation
+      EReputation.new(self)
+    end
+
+    # The namespace for the Airport  APIs:
+    #
+    # @return [Amadeus::Namespaces::Airport]
+    # @example Some of the further namespaces available
+    #   amadeus.airport.predictions
+    #
+    def airport
+      Airport.new(self)
+    end
+
+    # The namespace for the Safety related APIs:
+    #
+    # @return [Amadeus::Namespaces::Safety]
+    # @example Some of the further namespaces available
+    #   amadeus.safety.safety_rated_locations
+    #
+    def safety
+      Safety.new(self)
+    end
+
+    # The namespace for the Analytics related APIs:
+    #
+    # @return [Amadeus::Namespaces::Analytics]
+    # @example Some of the further namespaces available
+    #   amadeus.analytics.itinerary_price_metrics
+    #
+    def analytics
+      Analytics.new(self)
+    end
   end
 end

data/lib/amadeus/namespaces/e_reputation.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v2/e-reputation+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.e_reputation
+    #
+    class EReputation < Amadeus::Client::Decorator
+      # The namespace for the E Reputation APIs:
+      #
+      # @return [Amadeus::Namespaces::EReputation::HotelSentiments]
+      # @example
+      #   amadeus.e_reputation.hotel_sentiments
+      #
+      def hotel_sentiments
+        Amadeus::Namespaces::EReputation::HotelSentiments.new(client)
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/e_reputation/hotel_sentiments.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class EReputation
+      # A namespaced client for the
+      # +/v2/e-reputation/hotel-sentiments+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.e_reputation.hotel_sentiments
+      #
+      class HotelSentiments < Amadeus::Client::Decorator
+        # For a given list of hotels, returns the sentiment analysis of each hotel
+        #
+        # @option params [String] :hotelIds list of hotel ids separated by comas
+        # @return [Amadeus:Response] a parsed response
+        # @raise [Amadeus:Base] an exception if the call failed
+        # @example Search for hotels in London
+        #   amadeus.e_reputation.hotel_sentiments.get(
+        #     hotelIds: 'GUNYCAXZ,CTLONCMB'
+        #   )
+        #
+        def get(params = {})
+          client.get('/v2/e-reputation/hotel-sentiments', params)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/reference_data/locations.rb

@@ -22,7 +22,7 @@ module Amadeus
           Amadeus::Namespaces::ReferenceData::Locations::Airports.new(client)
         end
 
-        # The namespace for the Point Of Interest API:
+        # The namespace for the Points Of Interest API:
         #
         # @return [Amadeus::Namespaces::ReferenceData::Locations::PointsOfInterest]
         # @example
@@ -32,6 +32,18 @@ module Amadeus
           Amadeus::Namespaces::ReferenceData::Locations::PointsOfInterest.new(client)
         end
 
+        # The namespace for the Point Of Interest API:
+        #
+        # @return [Amadeus::Namespaces::ReferenceData::Locations::PointOfInterest]
+        # @example
+        #   amadeus.reference_data.locations.point_of_interest
+        #
+        def point_of_interest(location_id)
+          Amadeus::Namespaces::ReferenceData::Locations::PointOfInterest.new(
+            client, location_id
+          )
+        end
+
         # Returns a list of airports and cities matching a given keyword.
         #
         # @option params [String] :keyword keyword that should represent the

data/lib/amadeus/namespaces/reference_data/locations/point_of_interest.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class ReferenceData
+      class Locations
+        # A namespaced client for the
+        # +/v1/reference-data/locations/pois/:location_id+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.reference_data.locations.point_of_interest('9CB40CB5D0')
+        #
+        class PointOfInterest < Amadeus::Client::Decorator
+          # the Location ID
+          attr_reader :poi_location_id
+
+          # Initialize this namespaced client with an
+          # {Amadeus::Client} instance and an optional Location ID
+          #
+          # @param [Amadeus::Client] client
+          # @param [Number] poi_location_id
+          #
+          def initialize(client, poi_location_id = nil)
+            super(client)
+            @poi_location_id = poi_location_id
+          end
+
+          # Returns details for a specific poi
+          #
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call failed
+          # @example Retrieve poi information of '9CB40CB5D0'
+          #   amadeus.reference_data.locations.point_of_interest('9CB40CB5D0').get
+          #
+          def get(params = {})
+            client.get("/v1/reference-data/locations/pois/#{@poi_location_id}", params)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/safety.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v1/safety+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.safety
+    #
+    class Safety < Amadeus::Client::Decorator
+      # The namespace for the Safety APIs:
+      #
+      # @return [Amadeus::Namespaces::Safety::SafetyRetedLocations]
+      # @example
+      #   amadeus.safety.safety_rated_locations
+      #
+      def safety_rated_locations
+        Amadeus::Namespaces::Safety::SafetyRatedLocations.new(client)
+      end
+
+      #
+      # @return [Amadeus::Namespaces::Safety::SafetyRetedLocation]
+      # @example
+      #   amadeus.safety.safety_rated_location
+      #
+      def safety_rated_location(location_id)
+        Amadeus::Namespaces::Safety::SafetyRatedLocation.new(client, location_id)
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/safety/safety_rated_location.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Safety
+      # amadeus.safety.safety_rated_location('Q930400801').get()
+      class SafetyRatedLocation < Amadeus::Client::Decorator
+        attr_reader :safe_location_id
+
+        #
+        # @param [Amadeus::Client] client
+        # @param [Number] safe_location_id
+        #
+        def initialize(client, safe_location_id = nil)
+          super(client)
+          @safe_location_id = safe_location_id
+        end
+
+        # Returns details for a specific place
+        #
+        # @return [Amadeus::Response] a parsed response
+        # @raise [Amadeus::Base] an exception if the call failed
+        # @example Retrieve safety information of 'Q930402753'
+        #   amadeus.safety.safety_rated_location('Q930402753').get
+        #
+        def get(params = {})
+          client.get("/v1/safety/safety-rated-locations/#{@safe_location_id}", params)
+        end
+      end
+    end
+  end
+end