amadeus 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffd090d42d800bbfae01e30b095e6907ee66922875eb38e81e83d0dfcf93688c
-  data.tar.gz: 1d34a30f43448bae789456f43fb2e96ce89abd63561b7318aec8086dc3b9bf0f
+  metadata.gz: a4a23a2c80c517339250f297ad7387205daf2614b170c42a86e3bbb9325bfa67
+  data.tar.gz: 8af63e1c90db57ea0d0390a8b8d6965bb4ed8499b1749a5ed23e73ce7a0c0003
 SHA512:
-  metadata.gz: 3005646311109b6551347efd3ebe559d6f091e9210a84d77666f898e1a12e3f4f7c5166b2d49ddc9af8c67c859c1d7ae45b156656b917d3fe081ee339de81cc9
-  data.tar.gz: 65046569d983b9a988de5fee812b5a38e85311963161f9b9e94841b8f9cb98e524cb2c7e2e162b8f64dd27fdc085213d2a3d65a54ae93f872d40fd4f73082d6a
+  metadata.gz: 9faf86fecd19ff97b2923f4de98a921527629576a3db17e95a4ff4744a1201c83dbe56e40ba6634d5aa8feac17683d2270dcb8084c40331cedbf653f4195d30a
+  data.tar.gz: 5270563733e24fbe0e7fdbf60712f3c7c4fd305ae534576ac6a3e5f7d60cdf4c410bfb5bbf069d318fa7593f27c29fd1e8de7a910337b432196acaa9a9be98d3

data/CHANGELOG.md

@@ -1,4 +1,9 @@
 # Changelog
+## 3.1.0 - 2019-03-25
+Release of the [Point of Interest API](https://developers.amadeus.com/self-service/category/210/api-doc/55)
+
+> The Points Of Interest API, powered by AVUXI TopPlace, is a search API that returns a list of popular places for a particular location. The location can be defined as area bound by four coordinates or as a geographical coordinate with a radius. The popularity of a place or 'point of interest' is determined by AVUXI's proprietary algorithm that considers factors such as ratings, check-ins, category scores among other factors from a host of online media sources.
+
 ## 3.0.0 - 2019-01-22
 
 ## Hotel Search v2 has been deployed (Hotel Search v1 is now deprecated)

data/README.md

@@ -178,7 +178,7 @@ amadeus = Amadeus::Client.new(
 amadeus.shopping.flight_destinations.get(origin: 'MAD')
 
 # Flight Cheapest Date Search
-amadeus.shopping.flight_dates.get(origin: 'NYC', destination: 'MAD')
+amadeus.shopping.flight_dates.get(origin: 'MAD', destination: 'MUC')
 
 # Flight Low-fare Search
 amadeus.shopping.flight_offers.get(origin: 'NYC', destination: 'MAD', departureDate: '2019-08-01')
@@ -227,6 +227,12 @@ amadeus.shopping.hotel_offers.get(cityCode: 'MAD')
 amadeus.shopping.hotel_offers_by_hotel.get(hotelId: 'IALONCHO')
 # Confirm the availability of a specific offer
 amadeus.shopping.hotel_offer('D5BEE9D0D08B6678C2F5FAD910DC110BCDA187D21D4FCE68ED423426D0A246BB').get
+
+# Point 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)
 ```
 ## Development & Contributing
 

data/lib/amadeus.rb

@@ -18,6 +18,8 @@ require 'amadeus/namespaces/reference_data/urls/checkin_links'
 require 'amadeus/namespaces/reference_data/location'
 require 'amadeus/namespaces/reference_data/locations'
 require 'amadeus/namespaces/reference_data/locations/airports'
+require 'amadeus/namespaces/reference_data/locations/points_of_interest'
+require 'amadeus/namespaces/reference_data/locations/points_of_interest/by_square'
 require 'amadeus/namespaces/shopping/flight_destinations'
 require 'amadeus/namespaces/shopping/flight_offers'
 require 'amadeus/namespaces/shopping/flight_dates'

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

@@ -22,6 +22,16 @@ module Amadeus
           Amadeus::Namespaces::ReferenceData::Locations::Airports.new(client)
         end
 
+        # The namespace for the Point Of Interest API:
+        #
+        # @return [Amadeus::Namespaces::ReferenceData::Locations::PointsOfInterest]
+        # @example
+        #   amadeus.reference_data.locations.points_of_interest
+        #
+        def points_of_interest
+          Amadeus::Namespaces::ReferenceData::Locations::PointsOfInterest.new(client)
+        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/airports.rb

@@ -5,7 +5,7 @@ module Amadeus
     class ReferenceData
       class Locations
         # A namespaced client for the
-        # +/v2/reference-data/locations/airports+ endpoints
+        # +/v1/reference-data/locations/airports+ endpoints
         #
         # Access via the +Amadeus::Client+ object
         #

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class ReferenceData
+      class Locations
+        # A namespaced client for the
+        # +/v1/reference-data/locations/pois+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.reference_data.locations.points_of_interest
+        #
+        class PointsOfInterest < Amadeus::Client::Decorator
+          # The namespace for the Point Of Interest API:
+          #
+          # @return [Amadeus::Namespaces::ReferenceData::Locations::PointsOfInterest]
+          # @example
+          #   amadeus.reference_data.locations.points_of_interest.by_square
+          #
+          def by_square
+            Amadeus::Namespaces::ReferenceData::Locations::PointsOfInterest::BySquare.new(client)
+          end
+
+          # Returns a list of relevant point of interests near to a given point.
+          #
+          # @option params [Double] :latitude latitude location to be at the
+          #   center of the search circle - required
+          # @option params [Double] :longitude longitude location to be at the
+          #   center of the search circle - required
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call
+          #   failed
+          # @example What are the popular places in Barcelona?
+          #   amadeus.reference_data.locations.points_of_interest.get(
+          #     latitude: 41.397158,
+          #     longitude: 2.160873
+          #   )
+          #
+          def get(params = {})
+            client.get('/v1/reference-data/locations/pois', params)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class ReferenceData
+      class Locations
+        class PointsOfInterest
+          # A namespaced client for the
+          # +/v1/reference-data/locations/pois/by-square+ endpoints
+          #
+          # Access via the +Amadeus::Client+ object
+          #
+          #   amadeus = Amadeus::Client.new
+          #   amadeus.reference_data.locations.points_of_interest.by_square
+          #
+          class BySquare < Amadeus::Client::Decorator
+            # Returns a list of relevant point of interests
+            #  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 What are the popular places in Barcelona?
+            #   amadeus.reference_data.locations.points_of_interest.by_square.get(
+            #     north: 41.397158,
+            #     west: 2.160873,
+            #     south: 41.394582,
+            #     east: 2.177181
+            #   )
+            #
+            def get(params = {})
+              client.get('/v1/reference-data/locations/pois/by-square', params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/version.rb

@@ -2,5 +2,5 @@
 
 module Amadeus
   # The current client version
-  VERSION = '3.0.0'.freeze
+  VERSION = '3.1.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: amadeus
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Amadeus
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-01-22 00:00:00.000000000 Z
+date: 2019-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -216,6 +216,8 @@ files:
 - lib/amadeus/namespaces/reference_data/location.rb
 - lib/amadeus/namespaces/reference_data/locations.rb
 - lib/amadeus/namespaces/reference_data/locations/airports.rb
+- lib/amadeus/namespaces/reference_data/locations/points_of_interest.rb
+- lib/amadeus/namespaces/reference_data/locations/points_of_interest/by_square.rb
 - lib/amadeus/namespaces/reference_data/urls.rb
 - lib/amadeus/namespaces/reference_data/urls/checkin_links.rb
 - lib/amadeus/namespaces/shopping.rb
@@ -253,7 +255,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Amadeus travel APIs