google-maps-api-sdk 1.0.0

data/lib/google_maps_platform/models/directions_route.rb

@@ -0,0 +1,188 @@
+# google_maps_platform
+#
+# This file was automatically generated by APIMATIC
+# v3.0 ( https://www.apimatic.io ).
+
+module GoogleMapsPlatform
+  # Routes consist of nested `legs` and `steps`.
+  class DirectionsRoute < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # An array which contains information about a leg of the route, between two
+    # locations within the given route. A separate leg will be present for each
+    # waypoint or destination specified. (A route with no waypoints will contain
+    # exactly one leg within the legs array.) Each leg consists of a series of
+    # steps.
+    # @return [Array[DirectionsLeg]]
+    attr_accessor :legs
+
+    # A rectangle in geographical coordinates from points at the southwest and
+    # northeast corners.
+    # @return [Bounds]
+    attr_accessor :bounds
+
+    # Contains the copyright notices to be displayed for this route. You must
+    # handle and display this information yourself. This content is meant to be
+    # read as-is. Do not programmatically parse this display-only content.
+    # @return [String]
+    attr_accessor :copyrights
+
+    # Contains a short textual description for the route, suitable for naming
+    # and disambiguating the route from alternatives.
+    # @return [String]
+    attr_accessor :summary
+
+    # An array indicating the order of any waypoints in the calculated route.
+    # This waypoints may be reordered if the request was passed optimize:true
+    # within its waypoints parameter.
+    # @return [Array[Integer]]
+    attr_accessor :waypoint_order
+
+    # Contains an array of warnings to be displayed when showing these
+    # directions. You must handle and display these warnings yourself.
+    # @return [Array[String]]
+    attr_accessor :warnings
+
+    # [Polyline
+    # encoding](https://developers.google.com/maps/documentation/utilities/polyl
+    # inealgorithm) is a lossy compression algorithm that allows you to store a
+    # series of coordinates as a single string. Point coordinates are encoded
+    # using signed values. If you only have a few static points, you may also
+    # wish to use the interactive polyline encoding utility.
+    # The encoding process converts a binary value into a series of character
+    # codes for ASCII characters using the familiar base64 encoding scheme: to
+    # ensure proper display of these characters, encoded values are summed with
+    # 63 (the ASCII character '?') before converting them into ASCII. The
+    # algorithm also checks for additional character codes for a given point by
+    # checking the least significant bit of each byte group; if this bit is set
+    # to 1, the point is not yet fully formed and additional data must follow.
+    # Additionally, to conserve space, points only include the offset from the
+    # previous point (except of course for the first point). All points are
+    # encoded in Base64 as signed integers, as latitudes and longitudes are
+    # signed values. The encoding format within a polyline needs to represent
+    # two coordinates representing latitude and longitude to a reasonable
+    # precision. Given a maximum longitude of +/- 180 degrees to a precision of
+    # 5 decimal places (180.00000 to -180.00000), this results in the need for a
+    # 32 bit signed binary integer value.
+    # @return [DirectionsPolyline]
+    attr_accessor :overview_polyline
+
+    # The total fare for the route.
+    # ```
+    # {
+    #   "currency" : "USD",
+    #   "value" : 6,
+    #   "text" : "$6.00"
+    # }
+    # ```
+    # @return [Fare]
+    attr_accessor :fare
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['legs'] = 'legs'
+      @_hash['bounds'] = 'bounds'
+      @_hash['copyrights'] = 'copyrights'
+      @_hash['summary'] = 'summary'
+      @_hash['waypoint_order'] = 'waypoint_order'
+      @_hash['warnings'] = 'warnings'
+      @_hash['overview_polyline'] = 'overview_polyline'
+      @_hash['fare'] = 'fare'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        fare
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(legs:, bounds:, copyrights:, summary:, waypoint_order:,
+                   warnings:, overview_polyline:, fare: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @legs = legs
+      @bounds = bounds
+      @copyrights = copyrights
+      @summary = summary
+      @waypoint_order = waypoint_order
+      @warnings = warnings
+      @overview_polyline = overview_polyline
+      @fare = fare unless fare == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      # Parameter is an array, so we need to iterate through it
+      legs = nil
+      unless hash['legs'].nil?
+        legs = []
+        hash['legs'].each do |structure|
+          legs << (DirectionsLeg.from_hash(structure) if structure)
+        end
+      end
+
+      legs = nil unless hash.key?('legs')
+      bounds = Bounds.from_hash(hash['bounds']) if hash['bounds']
+      copyrights = hash.key?('copyrights') ? hash['copyrights'] : nil
+      summary = hash.key?('summary') ? hash['summary'] : nil
+      waypoint_order =
+        hash.key?('waypoint_order') ? hash['waypoint_order'] : nil
+      warnings = hash.key?('warnings') ? hash['warnings'] : nil
+      overview_polyline = DirectionsPolyline.from_hash(hash['overview_polyline']) if
+        hash['overview_polyline']
+      fare = Fare.from_hash(hash['fare']) if hash['fare']
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      DirectionsRoute.new(legs: legs,
+                          bounds: bounds,
+                          copyrights: copyrights,
+                          summary: summary,
+                          waypoint_order: waypoint_order,
+                          warnings: warnings,
+                          overview_polyline: overview_polyline,
+                          fare: fare,
+                          additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} legs: #{@legs}, bounds: #{@bounds}, copyrights: #{@copyrights}, summary:"\
+      " #{@summary}, waypoint_order: #{@waypoint_order}, warnings: #{@warnings},"\
+      " overview_polyline: #{@overview_polyline}, fare: #{@fare}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} legs: #{@legs.inspect}, bounds: #{@bounds.inspect}, copyrights:"\
+      " #{@copyrights.inspect}, summary: #{@summary.inspect}, waypoint_order:"\
+      " #{@waypoint_order.inspect}, warnings: #{@warnings.inspect}, overview_polyline:"\
+      " #{@overview_polyline.inspect}, fare: #{@fare.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end

data/lib/google_maps_platform/models/directions_status.rb

@@ -0,0 +1,94 @@
+# google_maps_platform
+#
+# This file was automatically generated by APIMATIC
+# v3.0 ( https://www.apimatic.io ).
+
+module GoogleMapsPlatform
+  # The status field within the Directions response object contains the status
+  # of the request, and may contain debugging information to help you track down
+  # why the Directions service failed. The status field may contain the
+  # following values: - `OK` indicates the response contains a valid result. -
+  # `NOT_FOUND` indicates at least one of the locations specified in the
+  # request's origin, destination, or waypoints could not be geocoded. -
+  # `ZERO_RESULTS` indicates no route could be found between the origin and
+  # destination. - `MAX_WAYPOINTS_EXCEEDED` indicates that too many waypoints
+  # were provided in the request. For applications using the Directions API as a
+  # web service, or the directions service in the Maps JavaScript API, the
+  # maximum allowed number of waypoints is 25, plus the origin and destination.
+  # - `MAX_ROUTE_LENGTH_EXCEEDED` indicates the requested route is too long and
+  # cannot be processed. This error occurs when more complex directions are
+  # returned. Try reducing the number of waypoints, turns, or instructions. -
+  # `INVALID_REQUEST` indicates that the provided request was invalid. Common
+  # causes of this status include an invalid parameter or parameter value. -
+  # `OVER_DAILY_LIMIT` indicates any of the following:     - The API key is
+  # missing or invalid.     - Billing has not been enabled on your account.
+  # - A self-imposed usage cap has been exceeded.     - The provided method of
+  # payment is no longer valid (for example, a credit card has expired).     See
+  # the [Maps FAQ](https://developers.google.com/maps/faq#over-limit-key-error)
+  # to learn how to fix this. - `OVER_QUERY_LIMIT` indicates the service has
+  # received too many requests from your application within the allowed time
+  # period. - `REQUEST_DENIED` indicates that the service denied use of the
+  # directions service by your application. - `UNKNOWN_ERROR` indicates a
+  # directions request could not be processed due to a server error. The request
+  # may succeed if you try again.
+  class DirectionsStatus
+    DIRECTIONS_STATUS = [
+      # TODO: Write general description for OK
+      OK = 'OK'.freeze,
+
+      # TODO: Write general description for NOT_FOUND
+      NOT_FOUND = 'NOT_FOUND'.freeze,
+
+      # TODO: Write general description for ZERO_RESULTS
+      ZERO_RESULTS = 'ZERO_RESULTS'.freeze,
+
+      # TODO: Write general description for MAX_WAYPOINTS_EXCEEDED
+      MAX_WAYPOINTS_EXCEEDED = 'MAX_WAYPOINTS_EXCEEDED'.freeze,
+
+      # TODO: Write general description for MAX_ROUTE_LENGTH_EXCEEDED
+      MAX_ROUTE_LENGTH_EXCEEDED = 'MAX_ROUTE_LENGTH_EXCEEDED'.freeze,
+
+      # TODO: Write general description for INVALID_REQUEST
+      INVALID_REQUEST = 'INVALID_REQUEST'.freeze,
+
+      # TODO: Write general description for OVER_DAILY_LIMIT
+      OVER_DAILY_LIMIT = 'OVER_DAILY_LIMIT'.freeze,
+
+      # TODO: Write general description for OVER_QUERY_LIMIT
+      OVER_QUERY_LIMIT = 'OVER_QUERY_LIMIT'.freeze,
+
+      # TODO: Write general description for REQUEST_DENIED
+      REQUEST_DENIED = 'REQUEST_DENIED'.freeze,
+
+      # TODO: Write general description for UNKNOWN_ERROR
+      UNKNOWN_ERROR = 'UNKNOWN_ERROR'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      DIRECTIONS_STATUS.include?(value)
+    end
+
+    def self.from_value(value, default_value = OK)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'ok' then OK
+      when 'not_found' then NOT_FOUND
+      when 'zero_results' then ZERO_RESULTS
+      when 'max_waypoints_exceeded' then MAX_WAYPOINTS_EXCEEDED
+      when 'max_route_length_exceeded' then MAX_ROUTE_LENGTH_EXCEEDED
+      when 'invalid_request' then INVALID_REQUEST
+      when 'over_daily_limit' then OVER_DAILY_LIMIT
+      when 'over_query_limit' then OVER_QUERY_LIMIT
+      when 'request_denied' then REQUEST_DENIED
+      when 'unknown_error' then UNKNOWN_ERROR
+      else
+        default_value
+      end
+    end
+  end
+end

data/lib/google_maps_platform/models/directions_step.rb

@@ -0,0 +1,216 @@
+# google_maps_platform
+#
+# This file was automatically generated by APIMATIC
+# v3.0 ( https://www.apimatic.io ).
+
+module GoogleMapsPlatform
+  # Each element in the steps array defines a single step of the calculated
+  # directions. A step is the most atomic unit of a direction's route,
+  # containing a single step describing a specific, single instruction on the
+  # journey. E.g. "Turn left at W. 4th St." The step not only describes the
+  # instruction but also contains distance and duration information relating to
+  # how this step relates to the following step. For example, a step denoted as
+  # "Merge onto I-80 West" may contain a duration of "37 miles" and "40
+  # minutes," indicating that the next step is 37 miles/40 minutes from this
+  # step. When using the Directions API to search for transit directions, the
+  # steps array will include additional transit details in the form of a
+  # transit_details array. If the directions include multiple modes of
+  # transportation, detailed directions will be provided for walking or driving
+  # steps in an inner steps array. For example, a walking step will include
+  # directions from the start and end locations: "Walk to Innes Ave & Fitch St".
+  # That step will include detailed walking directions for that route in the
+  # inner steps array, such as: "Head north-west", "Turn left onto Arelious
+  # Walker", and "Turn left onto Innes Ave".
+  class DirectionsStep < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # An object containing a numeric value and its formatted text
+    # representation.
+    # @return [TextValueObject]
+    attr_accessor :distance
+
+    # An object containing a numeric value and its formatted text
+    # representation.
+    # @return [TextValueObject]
+    attr_accessor :duration
+
+    # An object describing a specific location with Latitude and Longitude in
+    # decimal degrees.
+    # @return [LatLngLiteral]
+    attr_accessor :end_location
+
+    # Contains formatted instructions for this step, presented as an HTML text
+    # string. This content is meant to be read as-is. Do not programmatically
+    # parse this display-only content.
+    # @return [String]
+    attr_accessor :html_instructions
+
+    # Contains the action to take for the current step (turn left, merge,
+    # straight, etc.). Values are subject to change, and new values may be
+    # introduced without prior notice.
+    # @return [Maneuver]
+    attr_accessor :maneuver
+
+    # [Polyline
+    # encoding](https://developers.google.com/maps/documentation/utilities/polyl
+    # inealgorithm) is a lossy compression algorithm that allows you to store a
+    # series of coordinates as a single string. Point coordinates are encoded
+    # using signed values. If you only have a few static points, you may also
+    # wish to use the interactive polyline encoding utility.
+    # The encoding process converts a binary value into a series of character
+    # codes for ASCII characters using the familiar base64 encoding scheme: to
+    # ensure proper display of these characters, encoded values are summed with
+    # 63 (the ASCII character '?') before converting them into ASCII. The
+    # algorithm also checks for additional character codes for a given point by
+    # checking the least significant bit of each byte group; if this bit is set
+    # to 1, the point is not yet fully formed and additional data must follow.
+    # Additionally, to conserve space, points only include the offset from the
+    # previous point (except of course for the first point). All points are
+    # encoded in Base64 as signed integers, as latitudes and longitudes are
+    # signed values. The encoding format within a polyline needs to represent
+    # two coordinates representing latitude and longitude to a reasonable
+    # precision. Given a maximum longitude of +/- 180 degrees to a precision of
+    # 5 decimal places (180.00000 to -180.00000), this results in the need for a
+    # 32 bit signed binary integer value.
+    # @return [DirectionsPolyline]
+    attr_accessor :polyline
+
+    # An object describing a specific location with Latitude and Longitude in
+    # decimal degrees.
+    # @return [LatLngLiteral]
+    attr_accessor :start_location
+
+    # Additional information that is not relevant for other modes of
+    # transportation.
+    # @return [DirectionsTransitDetails]
+    attr_accessor :transit_details
+
+    # - `DRIVING` (default) indicates calculation using the road network.
+    # - `BICYCLING` requests calculation for bicycling via bicycle paths &
+    # preferred streets (where available).
+    # - `TRANSIT` requests calculation via public transit routes (where
+    # available). 
+    # - `WALKING` requests calculation for walking via pedestrian paths &
+    # sidewalks (where available).
+    # @return [TravelMode]
+    attr_accessor :travel_mode
+
+    # Contains detailed directions for walking or driving steps in transit
+    # directions. Substeps are only available when travel_mode is set to
+    # "transit". The inner steps array is of the same type as steps.
+    # @return [Object]
+    attr_accessor :steps
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['distance'] = 'distance'
+      @_hash['duration'] = 'duration'
+      @_hash['end_location'] = 'end_location'
+      @_hash['html_instructions'] = 'html_instructions'
+      @_hash['maneuver'] = 'maneuver'
+      @_hash['polyline'] = 'polyline'
+      @_hash['start_location'] = 'start_location'
+      @_hash['transit_details'] = 'transit_details'
+      @_hash['travel_mode'] = 'travel_mode'
+      @_hash['steps'] = 'steps'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        distance
+        maneuver
+        transit_details
+        steps
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(duration:, end_location:, html_instructions:, polyline:,
+                   start_location:, travel_mode:, distance: SKIP,
+                   maneuver: SKIP, transit_details: SKIP, steps: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @distance = distance unless distance == SKIP
+      @duration = duration
+      @end_location = end_location
+      @html_instructions = html_instructions
+      @maneuver = maneuver unless maneuver == SKIP
+      @polyline = polyline
+      @start_location = start_location
+      @transit_details = transit_details unless transit_details == SKIP
+      @travel_mode = travel_mode
+      @steps = steps unless steps == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      duration = TextValueObject.from_hash(hash['duration']) if hash['duration']
+      end_location = LatLngLiteral.from_hash(hash['end_location']) if hash['end_location']
+      html_instructions =
+        hash.key?('html_instructions') ? hash['html_instructions'] : nil
+      polyline = DirectionsPolyline.from_hash(hash['polyline']) if hash['polyline']
+      start_location = LatLngLiteral.from_hash(hash['start_location']) if hash['start_location']
+      travel_mode = hash.key?('travel_mode') ? hash['travel_mode'] : nil
+      distance = TextValueObject.from_hash(hash['distance']) if hash['distance']
+      maneuver = hash.key?('maneuver') ? hash['maneuver'] : SKIP
+      transit_details = DirectionsTransitDetails.from_hash(hash['transit_details']) if
+        hash['transit_details']
+      steps = hash.key?('steps') ? hash['steps'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      DirectionsStep.new(duration: duration,
+                         end_location: end_location,
+                         html_instructions: html_instructions,
+                         polyline: polyline,
+                         start_location: start_location,
+                         travel_mode: travel_mode,
+                         distance: distance,
+                         maneuver: maneuver,
+                         transit_details: transit_details,
+                         steps: steps,
+                         additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} distance: #{@distance}, duration: #{@duration}, end_location:"\
+      " #{@end_location}, html_instructions: #{@html_instructions}, maneuver: #{@maneuver},"\
+      " polyline: #{@polyline}, start_location: #{@start_location}, transit_details:"\
+      " #{@transit_details}, travel_mode: #{@travel_mode}, steps: #{@steps},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} distance: #{@distance.inspect}, duration: #{@duration.inspect},"\
+      " end_location: #{@end_location.inspect}, html_instructions: #{@html_instructions.inspect},"\
+      " maneuver: #{@maneuver.inspect}, polyline: #{@polyline.inspect}, start_location:"\
+      " #{@start_location.inspect}, transit_details: #{@transit_details.inspect}, travel_mode:"\
+      " #{@travel_mode.inspect}, steps: #{@steps.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end

data/lib/google_maps_platform/models/directions_traffic_speed_entry.rb

@@ -0,0 +1,84 @@
+# google_maps_platform
+#
+# This file was automatically generated by APIMATIC
+# v3.0 ( https://www.apimatic.io ).
+
+module GoogleMapsPlatform
+  # DirectionsTrafficSpeedEntry Model.
+  class DirectionsTrafficSpeedEntry < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The current traffic/speed conditions on this portion of a path.
+    # @return [String]
+    attr_accessor :speed_category
+
+    # The offset along the path (in meters) up to which this speed category is
+    # valid.
+    # @return [Float]
+    attr_accessor :offset_meters
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['speed_category'] = 'speed_category'
+      @_hash['offset_meters'] = 'offset_meters'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(speed_category:, offset_meters:, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @speed_category = speed_category
+      @offset_meters = offset_meters
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      speed_category =
+        hash.key?('speed_category') ? hash['speed_category'] : nil
+      offset_meters = hash.key?('offset_meters') ? hash['offset_meters'] : nil
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      DirectionsTrafficSpeedEntry.new(speed_category: speed_category,
+                                      offset_meters: offset_meters,
+                                      additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} speed_category: #{@speed_category}, offset_meters: #{@offset_meters},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} speed_category: #{@speed_category.inspect}, offset_meters:"\
+      " #{@offset_meters.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/google_maps_platform/models/directions_transit_agency.rb

@@ -0,0 +1,95 @@
+# google_maps_platform
+#
+# This file was automatically generated by APIMATIC
+# v3.0 ( https://www.apimatic.io ).
+
+module GoogleMapsPlatform
+  # DirectionsTransitAgency Model.
+  class DirectionsTransitAgency < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The name of this transit agency.
+    # @return [String]
+    attr_accessor :name
+
+    # The transit agency's phone number.
+    # @return [String]
+    attr_accessor :phone
+
+    # The transit agency's URL.
+    # @return [String]
+    attr_accessor :url
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['name'] = 'name'
+      @_hash['phone'] = 'phone'
+      @_hash['url'] = 'url'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        name
+        phone
+        url
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(name: SKIP, phone: SKIP, url: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @name = name unless name == SKIP
+      @phone = phone unless phone == SKIP
+      @url = url unless url == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      name = hash.key?('name') ? hash['name'] : SKIP
+      phone = hash.key?('phone') ? hash['phone'] : SKIP
+      url = hash.key?('url') ? hash['url'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      DirectionsTransitAgency.new(name: name,
+                                  phone: phone,
+                                  url: url,
+                                  additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, phone: #{@phone}, url: #{@url}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, phone: #{@phone.inspect}, url: #{@url.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end