amadeus 4.0.0 → 5.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6de12964b5fc9ba2acc621f7c6cba612176f5a510d762c176a20bbaff97b696c
-  data.tar.gz: 7feadab2cb09cfcfb400a68d5b0e3574d7e26704cbf3b110675578116eb5bee1
+  metadata.gz: 33aae007eb2c940f808b5de0d0d006fd9a1f699cb9a607fb59d801290eb2f372
+  data.tar.gz: 87fdd06730f8dec43766019695da9d1f390ec2cd9f4f15e5c63cf0e493b2a28e
 SHA512:
-  metadata.gz: eda4f4a0e74f46ab1ff6a7fd50943c98f25f3ab7cb09bfb2f9b9545fd36f906c658830ef38a1a3c8ce9129900226a9e303692156f3e12020effe5cc8499b8184
-  data.tar.gz: 335ede21e566eaa2d136c91f5a0408c9d22dbb53a8af7df05312645e0d3da3f4fa039ba65ec38b01e30d445c7861c8280dd438713476447de12c7abe8bcb27a8
+  metadata.gz: 9044a656f932b284fa305a71670b2ab871458a0923c697d61600f521c09c3fe7a6e8e8c4ddb1b2880fe2896932e0eecfe2beea16d78c2983f2c45022956be132
+  data.tar.gz: 4661b308497f20c8a09c9c31e5003e3653120228ee3b977a45a7a66eff38df4f0194a078814f9cb7ad0efb365066d84e85921fa0c1acc80c7d845374d31a8cf7

data/CHANGELOG.md

@@ -1,4 +1,21 @@
 # Changelog
+## 5.2.1 - 2021-11-30
+Migrate to Github actions
+
+## 5.2.0 - 2021-03-20
+
+Add support for Flight Price Analysis. Thanks [@developius](https://github.com/developius) for the contribution.
+## 5.1.0 - 2020-11-26
+
+Add support for Safe Place API.
+Add support for retrieve by id for Points Of Interest API
+## 5.0.0 - 2020-05-14
+Release of the Flight Offers Search API.
+
+Add support for the Flight Choice Prediction v2.
+
+Decommission of the Flight Low-fare Search and Flight Choice Prediction v1.
+
 ## 4.0.0 - 2020-02-12
 Release of the [Hotel Booking API](https://developers.amadeus.com/self-service/category/hotel/api-doc/hotel-booking)
 

data/README.md

@@ -5,16 +5,13 @@
 [![Maintainability](https://api.codeclimate.com/v1/badges/d2e15221a502a7d71144/maintainability)](https://codeclimate.com/github/amadeus4dev/amadeus-ruby/maintainability)
 [![Dependencies](https://github.com/amadeus4dev/amadeus-ruby/raw/master/.github/images/dependencies.svg?sanitize=true)](gem)
 [![Contact Support](https://github.com/amadeus4dev/amadeus-ruby/raw/master/.github/images/support.svg?sanitize=true)][support]
+[![Discord](https://img.shields.io/discord/696822960023011329?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/cVrFBqx)
 
-Amadeus provides a set of APIs for the travel industry. Flights, Hotels, Locations and more.
-
-For more details see the [Ruby
-documentation](https://amadeus4dev.github.io/amadeus-ruby/) on
-[Amadeus.com](https://developers.amadeus.com).
+Amadeus provides a rich set of APIs for the travel industry. For more details, check out the [Amadeus for Developers Portal](https://developers.amadeus.com) or the [SDK class reference](https://amadeus4dev.github.io/amadeus-ruby/).
 
 ## Installation
 
-This gem requires Ruby 2.4+. You can install install it directly or via bundler.
+This gem requires Ruby 2.5+. You can install it directly or via bundler.
 #### Command line
 ```bash
 gem install amadeus
@@ -26,9 +23,7 @@ gem 'amadeus'
 
 ## Getting Started
 
-To make your first API call you will need to [register for an Amadeus
-Developer Account](https://developers.amadeus.com/create-account) and set up
-your first application.
+To make your first API call, you will need to [register](https://developers.amadeus.com/register) for an Amadeus Developer Account and [set up your first application](https://developers.amadeus.com/my-apps).
 
 ```rb
 require 'amadeus'
@@ -39,7 +34,7 @@ amadeus = Amadeus::Client.new({
 })
 
 begin
-  puts amadeus.reference_data.urls.checkin_links.get({ airlineCode: 'BA' })
+  puts amadeus.shopping.flight_offers_search.get(originLocationCode: 'NYC', destinationLocationCode: 'MAD', departureDate: '2021-05-01', adults: 1, max: 1).body
 rescue Amadeus::ResponseError => error
   puts error
 end
@@ -54,19 +49,15 @@ The client can be initialized directly.
 amadeus = Amadeus::Client.new(client_id: 'REPLACE_BY_YOUR_API_KEY', client_secret: 'REPLACE_BY_YOUR_API_SECRET')
 ```
 
-Alternatively it can be initialized without any parameters if the environment
-variables `AMADEUS_CLIENT_ID` and `AMADEUS_CLIENT_SECRET` are present.
+Alternatively, it can be initialized without any parameters if the environment variables `AMADEUS_CLIENT_ID` and `AMADEUS_CLIENT_SECRET` are present.
 
 ```rb
 amadeus = Amadeus::Client.new
 ```
 
-Your credentials can be found on the [Amadeus
-dashboard](https://developers.amadeus.com/my-apps). [Sign
-up](https://developers.amadeus.com/create-account) for an account today.
+Your credentials can be found on the [Amadeus dashboard](https://developers.amadeus.com/my-apps).
 
-By default the environment for the SDK is the `:test` environment. To switch to
-a production (paid-for) environment please switch the hostname as follows:
+By default, the environment for the SDK is the `:test` environment. To switch to a production (pay-as-you-go) environment please switch the hostname as follows:
 
 ```rb
 amadeus = Amadeus::Client.new(hostname: :production)
@@ -74,34 +65,26 @@ amadeus = Amadeus::Client.new(hostname: :production)
 
 ## Documentation
 
-Amadeus has a large set of APIs, and our documentation is here to get you
-started today. Head over to our
-[Reference](https://amadeus4dev.github.io/amadeus-ruby/) documentation for
-in-depth information about every SDK method, its arguments and return types.
+Amadeus has a large set of APIs, and our documentation is here to get you started today. Head over to our [reference documentation](https://amadeus4dev.github.io/amadeus-ruby/) for in-depth information about every SDK method, its arguments and return types.
 
 
-* [Get Started](https://amadeus4dev.github.io/amadeus-ruby/) documentation
-  * [Initialize the SDK](https://amadeus4dev.github.io/amadeus-ruby/)
+  * [Get Started](https://amadeus4dev.github.io/amadeus-ruby/)
   * [Find an Airport](https://amadeus4dev.github.io/amadeus-ruby/Amadeus/Namespaces/ReferenceData/Locations/Airports.html)
-  * [Find a Flight](https://amadeus4dev.github.io/amadeus-ruby/Amadeus/Namespaces/Shopping/FlightOffers.html)
+  * [Find a Flight](https://amadeus4dev.github.io/amadeus-ruby/Amadeus/Namespaces/Shopping/FlightOffersSearch.html)
   * [Get Flight Inspiration](https://amadeus4dev.github.io/amadeus-ruby/Amadeus/Namespaces/Shopping/FlightDestinations.html)
 
 ## Making API calls
 
-This library conveniently maps every API path to a similar path.
-
-For example, `GET /v2/reference-data/urls/checkin-links?airlineCode=BA` would be:
+This library conveniently maps every API path to a similar path. For example, `GET /v2/reference-data/urls/checkin-links?airlineCode=BA` would be:
 
 ```rb
 amadeus.reference_data.urls.checkin_links.get(airlineCode: 'BA')
 ```
 
-Similarly, to select a resource by ID, you can pass in the ID to the **singular** path.
-
-For example,  `GET /v2/shopping/hotel-offers/XZY` would be:
+Similarly, to select a resource by ID, you can pass in the ID to the **singular** path. For example,  `GET /v2/shopping/hotel-offers/XZY` would be:
 
 ```rb
-amadeus.shopping.hotel_offer('D5BEE9D0D08B6678C2F5FAD910DC110BCDA187D21D4FCE68ED423426D0A246BB').get
+amadeus.shopping.hotel_offer('XZY').get
 ```
 
 You can make any arbitrary API call as well directly with the `.get` method:
@@ -112,10 +95,7 @@ amadeus.get('/v2/reference-data/urls/checkin-links', airlineCode: 'BA')
 
 ## Response
 
-Every API call returns a `Amadeus::Response` object. If the API call contained
-a JSON response it will parse the JSON into the `.result` attribute. If this data
-also contains a `data` key, it will make that available as the `.data`
-attribute. The raw body of the response is always avaulable as the `.body` attribute.
+Every API call returns a `Amadeus::Response` object. If the API call contained a JSON response, it will parse the JSON into `.result` attribute. If this data also contains a `data` key, that will be made available in `.data` attribute. The raw body of the response is always available in `.body` attribute.
 
 ```rb
 response = amadeus.reference_data.locations.get(
@@ -158,10 +138,7 @@ amadeus = Amadeus::Client.new(
 )
 ```
 
-Additionally, to enable more verbose logging, you can set the appropriate level
-on your own logger, though the easiest way would be to enable debugging via a
-parameter on initialization, or using the `AMADEUS_LOG_LEVEL` environment
-variable.
+Additionally, to enable more verbose logging, you can set the appropriate level on your own logger. The easiest way would be to enable debugging via a parameter on initialization, or using the `AMADEUS_LOG_LEVEL` environment variable.
 
 ```rb
 require 'logger'
@@ -180,12 +157,15 @@ amadeus.shopping.flight_destinations.get(origin: 'MAD')
 # Flight Cheapest Date Search
 amadeus.shopping.flight_dates.get(origin: 'MAD', destination: 'MUC')
 
-# Flight Low-fare Search
-amadeus.shopping.flight_offers.get(origin: 'NYC', destination: 'MAD', departureDate: '2020-08-01')
+# Flight Offers Search
+amadeus.shopping.flight_offers_search.get(originLocationCode: 'NYC', destinationLocationCode: 'MAD', departureDate: '2021-05-01', adults: 1)
 
-# Flight Choice Prediction / Be careful, this example combines 2 API calls: 1. Flight Low-fare Search then Flight Choice Prediction
-amadeus.shopping.flight_offers.prediction.post(amadeus.shopping.flight_offers.get(origin: 'NYC', destination: 'MAD', departureDate: '2020-11-01').body)
+# Flight Choice Prediction / Be careful, this example combines 2 API calls: 1. Flight Offers Search then Flight Choice Prediction
+flight_offers = amadeus.shopping.flight_offers_search.get(originLocationCode: 'NYC', destinationLocationCode: 'MAD', departureDate: '2021-05-01', adults: 1, max: 1).body
+amadeus.shopping.flight_offers_search.prediction.post(flight_offers)
 
+# Flight Delay Prediction
+amadeus.travel.predictions.flight_delay.get(originLocationCod: 'NCE', destinationLocationCod: 'IST', departureDat: '2021-05-01', departureTim: '18:20:00', arrivalDat: '2020-08-01', arrivalTim: '22:15:00', aircraftCod: '321', carrierCod: 'TK', flightNumber: '1816', duration: 'PT31H10M')
 # Flight Check-in Links
 amadeus.reference_data.urls.checkin_links.get(airlineCode: 'BA')
 
@@ -233,11 +213,30 @@ amadeus.booking.hotel_bookings.post(offerId, guests, payments)
 # What are the reviews for the Holiday INN Manhattan and the Hilton London Paddington
 amadeus.e_reputation.hotel_sentiments.get(hotelIds: 'SJNYCAJA,TELONMFS')
 
-# Point of Interest
+# Points of Interest
 # What are the popular places in Barcelona (based a geo location and a radius)
 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()
+
+# 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)
+# How safe is Barcelona? (based on a square)
+amadeus.safety.safety_rated_locations.by_square.get(north: 41.397158, west: 2.160873, south: 41.394582, east: 2.177181)
+# What is the safety information of a location based on it's Id?
+amadeus.safety.safety_rated_location('Q930402753').get()
+
+# Airport On-Time Performance
+amadeus.airport.predictions.on_time.get(airportCode: 'JFK', date: '2020-08-01')
+
+# Flight Price Analysis
+amadeus.analytics.itinerary_price_metrics.get(originIataCode: 'AMS', destinationIataCode: 'CDG', departureDate: '2021-08-18')
+
+# 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')
 ```
 ## Development & Contributing
 

data/amadeus.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'amadeus/version'
@@ -24,19 +26,19 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
-  spec.required_ruby_version = '>= 2.2.0'
+  spec.required_ruby_version = '>= 2.4.0'
 
   spec.add_development_dependency 'awesome_print', '~> 1.8'
-  spec.add_development_dependency 'bundler', '~> 2.1.2'
-  spec.add_development_dependency 'guard', '~> 2.14'
+  spec.add_development_dependency 'bundler', '~> 2.2.14'
+  spec.add_development_dependency 'guard', '~> 2.16'
   spec.add_development_dependency 'guard-rake', '~> 1.0'
   spec.add_development_dependency 'guard-yard', '~> 2.2'
-  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'rake', '~> 12.3.1'
   spec.add_development_dependency 'rb-readline', '~> 0.5.5'
-  spec.add_development_dependency 'rspec', '~> 3.7'
-  spec.add_development_dependency 'rubocop', '0.59'
-  spec.add_development_dependency 'simplecov', '~> 0.15'
-  spec.add_development_dependency 'vcr', '~> 4.0'
-  spec.add_development_dependency 'webmock', '~> 3.3'
-  spec.add_development_dependency 'yard', '~> 0.9.12'
+  spec.add_development_dependency 'rspec', '~> 3.9'
+  spec.add_development_dependency 'rubocop', '0.79'
+  spec.add_development_dependency 'simplecov', '~> 0.18'
+  spec.add_development_dependency 'vcr', '~> 5.1'
+  spec.add_development_dependency 'webmock', '~> 3.8'
+  spec.add_development_dependency 'yard', '~> 0.9.24'
 end

data/lib/amadeus/client/direction.rb

@@ -3,9 +3,7 @@
 module Amadeus
   # A list of directions, as used in Busiest Travel Period
   module Direction
-    # Airport
-    ARRIVING = 'ARRIVING'.freeze
-    # City
-    DEPARTING = 'DEPARTING'.freeze
+    ARRIVING = 'ARRIVING'
+    DEPARTING = 'DEPARTING'
   end
 end

data/lib/amadeus/client/errors.rb

@@ -64,11 +64,12 @@ module Amadeus
 
     # Determines the longer description, printed after the initial error
     def long_description
-      return '' unless response && response.parsed
-
       message = ''
-      message += error_description if response.result['error_description']
-      message += errors_description if response.result['errors']
+      if response&.parsed
+        message += error_description if response.result['error_description']
+        message += errors_description if response.result['errors']
+      end
+
       message
     end
 

data/lib/amadeus/client/location.rb

@@ -4,9 +4,9 @@ module Amadeus
   # A list of location types, as used in searching for locations
   module Location
     # Airport
-    AIRPORT = 'AIRPORT'.freeze
+    AIRPORT = 'AIRPORT'
     # City
-    CITY = 'CITY'.freeze
+    CITY = 'CITY'
     # Any
     ANY = [AIRPORT, CITY].join(',')
   end

data/lib/amadeus/client/request/hash.rb

@@ -25,7 +25,7 @@ module Amadeus
 
       # Used by .flatten_keys to add a sub key to a key
       def append_key(root_key, key)
-        root_key.nil? ? :"#{key}" : :"#{root_key}[#{key.to_s}]"
+        root_key.nil? ? :"#{key}" : :"#{root_key}[#{key}]"
       end
     end
   end

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/airport/predictions.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Airport
+      # A namespaced client for the
+      # +/v1/airport/predictions+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.airport.predictions
+      #
+      class Predictions < Amadeus::Client::Decorator
+        # The namespace for the Airport-OnTime-Prediction API:
+        #
+        # @return [Amadeus::Namespaces::Airport::Predictions::OnTime]
+        # @example
+        #   amadeus.airport.predictions.on_time
+        #
+        def on_time
+          Amadeus::Namespaces::Airport::Predictions::OnTime.new(client)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/airport.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v1/airport+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.airport
+    #
+    class Airport < Amadeus::Client::Decorator
+      # The namespace for the Ai APIs:
+      #
+      # @return [Amadeus::Namespaces::Airport::Predictions]
+      # @example
+      #   amadeus.airport.predictions
+      #
+      def predictions
+        Amadeus::Namespaces::Airport::Predictions.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/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/core.rb

@@ -67,5 +67,35 @@ module Amadeus
     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/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/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/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

data/lib/amadeus/namespaces/safety/safety_rated_locations/by_square.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Safety
+      class SafetyRatedLocations
+        # A namespaced client for the
+        # +/v1/safety/safety_rated_locations/by-square+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.safety.safety_rated_locations.by_square
+        #
+        class BySquare < Amadeus::Client::Decorator
+          # Returns a list of relevant safety information
+          #  around a defined square (4 points).
+          #
+          # @option params [Double] :north Latitude north of bounding box - required
+          # @option params [Double] :west Longitude west of bounding box - required
+          # @option params [Double] :south Latitude south of bounding box - required
+          # @option params [Double] :east Longitude east of bounding box - required
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call
+          #   failed
+          # @example How safe is Barcelona?
+          #   amadeus.safety.safety_rated_locations.by_square.get(
+          #     north: 41.397158,
+          #     west: 2.160873,
+          #     south: 41.394582,
+          #     east: 2.177181
+          #   )
+          #
+          def get(params = {})
+            client.get('/v1/safety/safety-rated-locations/by-square', params)
+          end
+        end
+      end
+    end
+  end
+end