google-apis-travelimpactmodel_v1 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f07226c012545a8278ba3744ae46ef28e9c896b0e5f2ffbe1c9b827e54577581
-  data.tar.gz: 84850d09451978cc2f70f09466378f6d48b7c4738935143c0f70bf02dede3ffa
+  metadata.gz: 3ccf3adb344fc1a1c6f498a25e772165629195bed89b56210434efc53b9dd9e5
+  data.tar.gz: 4797489a766e917e19712d7ad68ee7ce3dc9d886aa22997027f939e2fd38ed33
 SHA512:
-  metadata.gz: 07e025e9596775e249db1c9efd841bbbb26f7ade628f7df8fc4532b8d9c834eb18d23f0042150140a9d95e0b6475ede11ad44ad117d37efa9376de1410ec6ea8
-  data.tar.gz: 1971d27e1bf0c190c29a6602dc042839a462f9ab8c2716336452ff351478e2be4117a1af7e3439256811129c40e069750d1aa9cb4504740ec8c209707f96875b
+  metadata.gz: e90bc66d93d93fbc0e69477301c6430d4fc2170c78136765f39b2687153143fc72dbc4fa28fdeff8a2cf0dc559f4280d8daf318a7952a351bed61050e208ed0c
+  data.tar.gz: 45890ab3bb8a3b5ac028a926c5b8f583fb0a64a278b72d6ca25808ba955186a57ec8795c03c4ac4468b1557099a8d1bee9cf556eb146bbc4ac9f7d1aed33a85a

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-travelimpactmodel_v1
 
+### v0.9.0 (2025-06-29)
+
+* Regenerated from discovery document revision 20250624
+
+### v0.8.0 (2025-06-08)
+
+* Regenerated from discovery document revision 20250605
+* Regenerated using generator version 0.18.0
+
 ### v0.7.0 (2025-05-04)
 
 * Regenerated using generator version 0.17.0

data/lib/google/apis/travelimpactmodel_v1/classes.rb

@@ -51,7 +51,7 @@ module Google
         attr_accessor :flight_emissions
       
         # Travel Impact Model version. For more information about the model versioning
-        # see https://github.com/google/travel-impact-model/#versioning.
+        # see [GitHub](https://github.com/google/travel-impact-model/#versioning).
         # Corresponds to the JSON property `modelVersion`
         # @return [Google::Apis::TravelimpactmodelV1::ModelVersion]
         attr_accessor :model_version
@@ -67,6 +67,52 @@ module Google
         end
       end
       
+      # A list of pair of airports (markets) to request the typical emissions for.
+      class ComputeTypicalFlightEmissionsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Request the typical flight emissions estimates for this market pair.
+        # A maximum of 1000 markets can be requested.
+        # Corresponds to the JSON property `markets`
+        # @return [Array<Google::Apis::TravelimpactmodelV1::Market>]
+        attr_accessor :markets
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @markets = args[:markets] if args.key?(:markets)
+        end
+      end
+      
+      # The response includes the emissions but also the model version.
+      class ComputeTypicalFlightEmissionsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Travel Impact Model version. For more information about the model versioning
+        # see [GitHub](https://github.com/google/travel-impact-model/#versioning).
+        # Corresponds to the JSON property `modelVersion`
+        # @return [Google::Apis::TravelimpactmodelV1::ModelVersion]
+        attr_accessor :model_version
+      
+        # Market's Typical Flight Emissions requested.
+        # Corresponds to the JSON property `typicalFlightEmissions`
+        # @return [Array<Google::Apis::TravelimpactmodelV1::TypicalFlightEmissions>]
+        attr_accessor :typical_flight_emissions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @model_version = args[:model_version] if args.key?(:model_version)
+          @typical_flight_emissions = args[:typical_flight_emissions] if args.key?(:typical_flight_emissions)
+        end
+      end
+      
       # Represents a whole or partial calendar date, such as a birthday. The time of
       # day and time zone are either specified elsewhere or are insignificant. The
       # date is relative to the Gregorian Calendar. This can represent one of the
@@ -108,6 +154,61 @@ module Google
         end
       end
       
+      # Metadata about the EASA Flight Emissions Label.
+      class EasaLabelMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `labelExpiryDate`
+        # @return [Google::Apis::TravelimpactmodelV1::Date]
+        attr_accessor :label_expiry_date
+      
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values. * A month
+        # and day, with a zero year (for example, an anniversary). * A year on its own,
+        # with a zero month and a zero day. * A year and month, with a zero day (for
+        # example, a credit card expiration date). Related types: * google.type.
+        # TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
+        # Corresponds to the JSON property `labelIssueDate`
+        # @return [Google::Apis::TravelimpactmodelV1::Date]
+        attr_accessor :label_issue_date
+      
+        # Version of the label.
+        # Corresponds to the JSON property `labelVersion`
+        # @return [String]
+        attr_accessor :label_version
+      
+        # Sustainable Aviation Fuel (SAF) emissions discount percentage applied to the
+        # label. It is a percentage as a decimal. The values are in the interval [0,1].
+        # For example, 0.0021 means 0.21%. This discount and reduction in emissions are
+        # reported by the EASA label but they are not included in the CO2e estimates
+        # distributed by this API.
+        # Corresponds to the JSON property `safDiscountPercentage`
+        # @return [Float]
+        attr_accessor :saf_discount_percentage
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @label_expiry_date = args[:label_expiry_date] if args.key?(:label_expiry_date)
+          @label_issue_date = args[:label_issue_date] if args.key?(:label_issue_date)
+          @label_version = args[:label_version] if args.key?(:label_version)
+          @saf_discount_percentage = args[:saf_discount_percentage] if args.key?(:saf_discount_percentage)
+        end
+      end
+      
       # Grouped emissions per seating class results.
       class EmissionsGramsPerPax
         include Google::Apis::Core::Hashable
@@ -208,6 +309,17 @@ module Google
       class FlightWithEmissions
         include Google::Apis::Core::Hashable
       
+        # Optional. The significance of contrails warming impact compared to the total
+        # CO2e emissions impact.
+        # Corresponds to the JSON property `contrailsImpactBucket`
+        # @return [String]
+        attr_accessor :contrails_impact_bucket
+      
+        # Metadata about the EASA Flight Emissions Label.
+        # Corresponds to the JSON property `easaLabelMetadata`
+        # @return [Google::Apis::TravelimpactmodelV1::EasaLabelMetadata]
+        attr_accessor :easa_label_metadata
+      
         # Grouped emissions per seating class results.
         # Corresponds to the JSON property `emissionsGramsPerPax`
         # @return [Google::Apis::TravelimpactmodelV1::EmissionsGramsPerPax]
@@ -219,19 +331,52 @@ module Google
         # @return [Google::Apis::TravelimpactmodelV1::Flight]
         attr_accessor :flight
       
+        # Optional. The source of the emissions data.
+        # Corresponds to the JSON property `source`
+        # @return [String]
+        attr_accessor :source
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @contrails_impact_bucket = args[:contrails_impact_bucket] if args.key?(:contrails_impact_bucket)
+          @easa_label_metadata = args[:easa_label_metadata] if args.key?(:easa_label_metadata)
           @emissions_grams_per_pax = args[:emissions_grams_per_pax] if args.key?(:emissions_grams_per_pax)
           @flight = args[:flight] if args.key?(:flight)
+          @source = args[:source] if args.key?(:source)
+        end
+      end
+      
+      # A pair of airports.
+      class Market
+        include Google::Apis::Core::Hashable
+      
+        # Required. IATA airport code for flight destination, e.g. "JFK".
+        # Corresponds to the JSON property `destination`
+        # @return [String]
+        attr_accessor :destination
+      
+        # Required. IATA airport code for flight origin, e.g. "LHR".
+        # Corresponds to the JSON property `origin`
+        # @return [String]
+        attr_accessor :origin
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @destination = args[:destination] if args.key?(:destination)
+          @origin = args[:origin] if args.key?(:origin)
         end
       end
       
       # Travel Impact Model version. For more information about the model versioning
-      # see https://github.com/google/travel-impact-model/#versioning.
+      # see [GitHub](https://github.com/google/travel-impact-model/#versioning).
       class ModelVersion
         include Google::Apis::Core::Hashable
       
@@ -244,8 +389,8 @@ module Google
         # Major versions: Major changes to methodology (e.g. adding new data sources to
         # the model that lead to major output changes). Such changes will be infrequent
         # and announced well in advance. Might involve API version changes, which will
-        # respect guidelines in https://cloud.google.com/endpoints/docs/openapi/
-        # versioning-an-api#backwards-incompatible
+        # respect [Google Cloud API guidelines](https://cloud.google.com/endpoints/docs/
+        # openapi/versioning-an-api#backwards-incompatible)
         # Corresponds to the JSON property `major`
         # @return [Fixnum]
         attr_accessor :major
@@ -274,6 +419,31 @@ module Google
           @patch = args[:patch] if args.key?(:patch)
         end
       end
+      
+      # Typical flight emission estimates for a certain market
+      class TypicalFlightEmissions
+        include Google::Apis::Core::Hashable
+      
+        # Grouped emissions per seating class results.
+        # Corresponds to the JSON property `emissionsGramsPerPax`
+        # @return [Google::Apis::TravelimpactmodelV1::EmissionsGramsPerPax]
+        attr_accessor :emissions_grams_per_pax
+      
+        # A pair of airports.
+        # Corresponds to the JSON property `market`
+        # @return [Google::Apis::TravelimpactmodelV1::Market]
+        attr_accessor :market
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @emissions_grams_per_pax = args[:emissions_grams_per_pax] if args.key?(:emissions_grams_per_pax)
+          @market = args[:market] if args.key?(:market)
+        end
+      end
     end
   end
 end

data/lib/google/apis/travelimpactmodel_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module TravelimpactmodelV1
       # Version of the google-apis-travelimpactmodel_v1 gem
-      GEM_VERSION = "0.7.0"
+      GEM_VERSION = "0.9.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.17.0"
+      GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250224"
+      REVISION = "20250624"
     end
   end
 end

data/lib/google/apis/travelimpactmodel_v1/representations.rb

@@ -34,12 +34,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ComputeTypicalFlightEmissionsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ComputeTypicalFlightEmissionsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Date
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class EasaLabelMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class EmissionsGramsPerPax
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -58,12 +76,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Market
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ModelVersion
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TypicalFlightEmissions
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ComputeFlightEmissionsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -82,6 +112,24 @@ module Google
         end
       end
       
+      class ComputeTypicalFlightEmissionsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :markets, as: 'markets', class: Google::Apis::TravelimpactmodelV1::Market, decorator: Google::Apis::TravelimpactmodelV1::Market::Representation
+      
+        end
+      end
+      
+      class ComputeTypicalFlightEmissionsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :model_version, as: 'modelVersion', class: Google::Apis::TravelimpactmodelV1::ModelVersion, decorator: Google::Apis::TravelimpactmodelV1::ModelVersion::Representation
+      
+          collection :typical_flight_emissions, as: 'typicalFlightEmissions', class: Google::Apis::TravelimpactmodelV1::TypicalFlightEmissions, decorator: Google::Apis::TravelimpactmodelV1::TypicalFlightEmissions::Representation
+      
+        end
+      end
+      
       class Date
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -91,6 +139,18 @@ module Google
         end
       end
       
+      class EasaLabelMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :label_expiry_date, as: 'labelExpiryDate', class: Google::Apis::TravelimpactmodelV1::Date, decorator: Google::Apis::TravelimpactmodelV1::Date::Representation
+      
+          property :label_issue_date, as: 'labelIssueDate', class: Google::Apis::TravelimpactmodelV1::Date, decorator: Google::Apis::TravelimpactmodelV1::Date::Representation
+      
+          property :label_version, as: 'labelVersion'
+          property :saf_discount_percentage, as: 'safDiscountPercentage'
+        end
+      end
+      
       class EmissionsGramsPerPax
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -116,10 +176,22 @@ module Google
       class FlightWithEmissions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :contrails_impact_bucket, as: 'contrailsImpactBucket'
+          property :easa_label_metadata, as: 'easaLabelMetadata', class: Google::Apis::TravelimpactmodelV1::EasaLabelMetadata, decorator: Google::Apis::TravelimpactmodelV1::EasaLabelMetadata::Representation
+      
           property :emissions_grams_per_pax, as: 'emissionsGramsPerPax', class: Google::Apis::TravelimpactmodelV1::EmissionsGramsPerPax, decorator: Google::Apis::TravelimpactmodelV1::EmissionsGramsPerPax::Representation
       
           property :flight, as: 'flight', class: Google::Apis::TravelimpactmodelV1::Flight, decorator: Google::Apis::TravelimpactmodelV1::Flight::Representation
       
+          property :source, as: 'source'
+        end
+      end
+      
+      class Market
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :destination, as: 'destination'
+          property :origin, as: 'origin'
         end
       end
       
@@ -132,6 +204,16 @@ module Google
           property :patch, as: 'patch'
         end
       end
+      
+      class TypicalFlightEmissions
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :emissions_grams_per_pax, as: 'emissionsGramsPerPax', class: Google::Apis::TravelimpactmodelV1::EmissionsGramsPerPax, decorator: Google::Apis::TravelimpactmodelV1::EmissionsGramsPerPax::Representation
+      
+          property :market, as: 'market', class: Google::Apis::TravelimpactmodelV1::Market, decorator: Google::Apis::TravelimpactmodelV1::Market::Representation
+      
+        end
+      end
     end
   end
 end

data/lib/google/apis/travelimpactmodel_v1/service.rb

@@ -52,11 +52,11 @@ module Google
         end
         
         # Stateless method to retrieve emission estimates. Details on how emission
-        # estimates are computed: https://github.com/google/travel-impact-model The
-        # response will contain all entries that match the input flight legs, in the
-        # same order. If there are no estimates available for a certain flight leg, the
-        # response will return the flight leg object with empty emission fields. The
-        # request will still be considered successful. Reasons for missing emission
+        # estimates are computed are in [GitHub](https://github.com/google/travel-impact-
+        # model) The response will contain all entries that match the input flight legs,
+        # in the same order. If there are no estimates available for a certain flight
+        # leg, the response will return the flight leg object with empty emission fields.
+        # The request will still be considered successful. Reasons for missing emission
         # estimates include: * The flight is unknown to the server. * The input flight
         # leg is missing one or more identifiers. * The flight date is in the past. *
         # The aircraft type is not supported by the model. * Missing seat configuration.
@@ -90,6 +90,43 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Retrieves typical flight emissions estimates between two airports, also known
+        # as a market. If there are no estimates available for a certain market, the
+        # response will return the market object with empty emission fields. The request
+        # will still be considered successful. Details on how the typical emissions
+        # estimates are computed are on [GitHub](https://github.com/google/travel-impact-
+        # model/blob/main/projects/typical_flight_emissions.md). The request can contain
+        # up to 1000 markets. If the request has more than 1000 markets, it will fail
+        # with an INVALID_ARGUMENT error.
+        # @param [Google::Apis::TravelimpactmodelV1::ComputeTypicalFlightEmissionsRequest] compute_typical_flight_emissions_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::TravelimpactmodelV1::ComputeTypicalFlightEmissionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::TravelimpactmodelV1::ComputeTypicalFlightEmissionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def compute_typical_flight_emissions(compute_typical_flight_emissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/flights:computeTypicalFlightEmissions', options)
+          command.request_representation = Google::Apis::TravelimpactmodelV1::ComputeTypicalFlightEmissionsRequest::Representation
+          command.request_object = compute_typical_flight_emissions_request_object
+          command.response_representation = Google::Apis::TravelimpactmodelV1::ComputeTypicalFlightEmissionsResponse::Representation
+          command.response_class = Google::Apis::TravelimpactmodelV1::ComputeTypicalFlightEmissionsResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-travelimpactmodel_v1
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-travelimpactmodel_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-travelimpactmodel_v1/v0.7.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-travelimpactmodel_v1/v0.9.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-travelimpactmodel_v1
 rdoc_options: []
 require_paths:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Simple REST client for Travel Impact Model API V1
 test_files: []