aws-sdk-locationservice 1.41.0 → 1.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcdd1e94874251d822eb6051a35cd999ad50b91ba54dbab0f6607b51c8a3f326
-  data.tar.gz: 6c5b03537b41260ac54a8f4a4c6bcc2e8217f1f291072860a076b8de853e5d50
+  metadata.gz: 2c9148cd30da04794444674a5191403c06f5d33ec019a67cc7d676dc2718df47
+  data.tar.gz: d5742794621f3d515ef85d57c35dd8f5ec8656c1178085d01a48593be34aa6b1
 SHA512:
-  metadata.gz: 713322d418a4aa888f70af0ad9182ea7fe992f86c2e08f376fb80248da9fb37ca0250adcbedd95479eb1bf24192e89475045f0b9c632fcc5dc0ad78b218ba19c
-  data.tar.gz: 04c10b1ecbc53404c357f2e3cf0becae5bc80040e8e503e4a05ca2ee4249f044c53dcb2f4cd2922fe95c7c4fe535a702f9929462de83bcd2df5458fe70747ccd
+  metadata.gz: 5b452b4c2828bf5aff2a7461129c8039f54683decd790c5469b2484b9461def941aa225dd530215ca40a4bbce3ee4010c6575e94b598ff2cb8c094d6a43f281c
+  data.tar.gz: 9b4d7d1e873eb08abdbc3110995525effe90f6f59af23f80e2ce701228d3e9898046578f7d91c44a1d9d5b4c4182789e26a827cc8bee2c1cb7f9228246a50fde

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.43.0 (2023-12-12)
+------------------
+
+* Feature - This release 1)  adds sub-municipality field in Places API for searching and getting places information, and 2) allows optimizing route calculation based on expected arrival time.
+
+1.42.0 (2023-11-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.41.0 (2023-11-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.41.0
+1.43.0

data/lib/aws-sdk-locationservice/client.rb

@@ -812,6 +812,15 @@ module Aws::LocationService
     # [3]: https://docs.aws.amazon.com/location/latest/developerguide/departure-time.html
     # [4]: https://docs.aws.amazon.com/location/latest/developerguide/travel-mode.html
     #
+    # @option params [Time,DateTime,Date,Integer,String] :arrival_time
+    #   Specifies the desired time of arrival. Uses the given time to
+    #   calculate the route. Otherwise, the best time of day to travel with
+    #   the best traffic conditions is used to calculate the route.
+    #
+    #   <note markdown="1"> ArrivalTime is not supported Esri.
+    #
+    #    </note>
+    #
     # @option params [required, String] :calculator_name
     #   The name of the route calculator resource that you want to use to
     #   calculate the route.
@@ -858,11 +867,6 @@ module Aws::LocationService
     #   calculate the route. Otherwise, the best time of day to travel with
     #   the best traffic conditions is used to calculate the route.
     #
-    #   <note markdown="1"> Setting a departure time in the past returns a `400
-    #   ValidationException` error.
-    #
-    #    </note>
-    #
     #   * In [ISO 8601][1] format: `YYYY-MM-DDThh:mm:ss.sssZ`. For example,
     #     `2020–07-2T12:15:20.000Z+01:00`
     #
@@ -912,6 +916,9 @@ module Aws::LocationService
     #
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
     #
+    # @option params [String] :optimize_for
+    #   Specifies the distance to optimize for when calculating a route.
+    #
     # @option params [String] :travel_mode
     #   Specifies the mode of transport when calculating a route. Used in
     #   estimating the speed of travel and road compatibility. You can choose
@@ -986,6 +993,7 @@ module Aws::LocationService
     # @example Request syntax with placeholder values
     #
     #   resp = client.calculate_route({
+    #     arrival_time: Time.now,
     #     calculator_name: "ResourceName", # required
     #     car_mode_options: {
     #       avoid_ferries: false,
@@ -998,6 +1006,7 @@ module Aws::LocationService
     #     distance_unit: "Kilometers", # accepts Kilometers, Miles
     #     include_leg_geometry: false,
     #     key: "ApiKey",
+    #     optimize_for: "FastestRoute", # accepts FastestRoute, ShortestRoute
     #     travel_mode: "Car", # accepts Car, Truck, Walking, Bicycle, Motorcycle
     #     truck_mode_options: {
     #       avoid_ferries: false,
@@ -3066,6 +3075,7 @@ module Aws::LocationService
     #   resp.place.postal_code #=> String
     #   resp.place.region #=> String
     #   resp.place.street #=> String
+    #   resp.place.sub_municipality #=> String
     #   resp.place.sub_region #=> String
     #   resp.place.supplemental_categories #=> Array
     #   resp.place.supplemental_categories[0] #=> String
@@ -3086,7 +3096,7 @@ module Aws::LocationService
     # A batch request to retrieve all device positions.
     #
     # @option params [Types::TrackingFilterGeometry] :filter_geometry
-    #   The geomerty used to filter device positions.
+    #   The geometry used to filter device positions.
     #
     # @option params [Integer] :max_results
     #   An optional limit for the number of entries returned in a single call.
@@ -3745,6 +3755,7 @@ module Aws::LocationService
     #   resp.results[0].place.postal_code #=> String
     #   resp.results[0].place.region #=> String
     #   resp.results[0].place.street #=> String
+    #   resp.results[0].place.sub_municipality #=> String
     #   resp.results[0].place.sub_region #=> String
     #   resp.results[0].place.supplemental_categories #=> Array
     #   resp.results[0].place.supplemental_categories[0] #=> String
@@ -4095,6 +4106,7 @@ module Aws::LocationService
     #   resp.results[0].place.postal_code #=> String
     #   resp.results[0].place.region #=> String
     #   resp.results[0].place.street #=> String
+    #   resp.results[0].place.sub_municipality #=> String
     #   resp.results[0].place.sub_region #=> String
     #   resp.results[0].place.supplemental_categories #=> Array
     #   resp.results[0].place.supplemental_categories[0] #=> String
@@ -4590,7 +4602,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.43.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-locationservice/client_api.rb

@@ -220,6 +220,7 @@ module Aws::LocationService
     MapConfiguration = Shapes::StructureShape.new(name: 'MapConfiguration')
     MapConfigurationUpdate = Shapes::StructureShape.new(name: 'MapConfigurationUpdate')
     MapStyle = Shapes::StringShape.new(name: 'MapStyle')
+    OptimizationMode = Shapes::StringShape.new(name: 'OptimizationMode')
     Place = Shapes::StructureShape.new(name: 'Place')
     PlaceCategory = Shapes::StringShape.new(name: 'PlaceCategory')
     PlaceCategoryList = Shapes::ListShape.new(name: 'PlaceCategoryList')
@@ -490,6 +491,7 @@ module Aws::LocationService
     CalculateRouteMatrixSummary.add_member(:route_count, Shapes::ShapeRef.new(shape: CalculateRouteMatrixSummaryRouteCountInteger, required: true, location_name: "RouteCount"))
     CalculateRouteMatrixSummary.struct_class = Types::CalculateRouteMatrixSummary
 
+    CalculateRouteRequest.add_member(:arrival_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "ArrivalTime"))
     CalculateRouteRequest.add_member(:calculator_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "CalculatorName"))
     CalculateRouteRequest.add_member(:car_mode_options, Shapes::ShapeRef.new(shape: CalculateRouteCarModeOptions, location_name: "CarModeOptions"))
     CalculateRouteRequest.add_member(:depart_now, Shapes::ShapeRef.new(shape: Boolean, location_name: "DepartNow"))
@@ -499,6 +501,7 @@ module Aws::LocationService
     CalculateRouteRequest.add_member(:distance_unit, Shapes::ShapeRef.new(shape: DistanceUnit, location_name: "DistanceUnit"))
     CalculateRouteRequest.add_member(:include_leg_geometry, Shapes::ShapeRef.new(shape: Boolean, location_name: "IncludeLegGeometry"))
     CalculateRouteRequest.add_member(:key, Shapes::ShapeRef.new(shape: ApiKey, location: "querystring", location_name: "key"))
+    CalculateRouteRequest.add_member(:optimize_for, Shapes::ShapeRef.new(shape: OptimizationMode, location_name: "OptimizeFor"))
     CalculateRouteRequest.add_member(:travel_mode, Shapes::ShapeRef.new(shape: TravelMode, location_name: "TravelMode"))
     CalculateRouteRequest.add_member(:truck_mode_options, Shapes::ShapeRef.new(shape: CalculateRouteTruckModeOptions, location_name: "TruckModeOptions"))
     CalculateRouteRequest.add_member(:waypoint_positions, Shapes::ShapeRef.new(shape: CalculateRouteRequestWaypointPositionsList, location_name: "WaypointPositions"))
@@ -1058,6 +1061,7 @@ module Aws::LocationService
     Place.add_member(:postal_code, Shapes::ShapeRef.new(shape: String, location_name: "PostalCode"))
     Place.add_member(:region, Shapes::ShapeRef.new(shape: String, location_name: "Region"))
     Place.add_member(:street, Shapes::ShapeRef.new(shape: String, location_name: "Street"))
+    Place.add_member(:sub_municipality, Shapes::ShapeRef.new(shape: String, location_name: "SubMunicipality"))
     Place.add_member(:sub_region, Shapes::ShapeRef.new(shape: String, location_name: "SubRegion"))
     Place.add_member(:supplemental_categories, Shapes::ShapeRef.new(shape: PlaceSupplementalCategoryList, location_name: "SupplementalCategories"))
     Place.add_member(:time_zone, Shapes::ShapeRef.new(shape: TimeZone, location_name: "TimeZone"))

data/lib/aws-sdk-locationservice/plugins/endpoints.rb

@@ -25,16 +25,17 @@ module Aws::LocationService
       # @api private
       class Handler < Seahorse::Client::Handler
         def call(context)
-          # If endpoint was discovered, do not resolve or apply the endpoint.
           unless context[:discovered_endpoint]
             params = parameters_for_operation(context)
             endpoint = context.config.endpoint_provider.resolve_endpoint(params)
 
             context.http_request.endpoint = endpoint.url
             apply_endpoint_headers(context, endpoint.headers)
+
+            context[:endpoint_params] = params
+            context[:endpoint_properties] = endpoint.properties
           end
 
-          context[:endpoint_params] = params
           context[:auth_scheme] =
             Aws::Endpoints.resolve_auth_scheme(context, endpoint)
 

data/lib/aws-sdk-locationservice/types.rb

@@ -888,6 +888,16 @@ module Aws::LocationService
       include Aws::Structure
     end
 
+    # @!attribute [rw] arrival_time
+    #   Specifies the desired time of arrival. Uses the given time to
+    #   calculate the route. Otherwise, the best time of day to travel with
+    #   the best traffic conditions is used to calculate the route.
+    #
+    #   <note markdown="1"> ArrivalTime is not supported Esri.
+    #
+    #    </note>
+    #   @return [Time]
+    #
     # @!attribute [rw] calculator_name
     #   The name of the route calculator resource that you want to use to
     #   calculate the route.
@@ -938,11 +948,6 @@ module Aws::LocationService
     #   calculate the route. Otherwise, the best time of day to travel with
     #   the best traffic conditions is used to calculate the route.
     #
-    #   <note markdown="1"> Setting a departure time in the past returns a `400
-    #   ValidationException` error.
-    #
-    #    </note>
-    #
     #   * In [ISO 8601][1] format: `YYYY-MM-DDThh:mm:ss.sssZ`. For example,
     #     `2020–07-2T12:15:20.000Z+01:00`
     #
@@ -997,6 +1002,10 @@ module Aws::LocationService
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
     #   @return [String]
     #
+    # @!attribute [rw] optimize_for
+    #   Specifies the distance to optimize for when calculating a route.
+    #   @return [String]
+    #
     # @!attribute [rw] travel_mode
     #   Specifies the mode of transport when calculating a route. Used in
     #   estimating the speed of travel and road compatibility. You can
@@ -1069,6 +1078,7 @@ module Aws::LocationService
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CalculateRouteRequest AWS API Documentation
     #
     class CalculateRouteRequest < Struct.new(
+      :arrival_time,
       :calculator_name,
       :car_mode_options,
       :depart_now,
@@ -1078,6 +1088,7 @@ module Aws::LocationService
       :distance_unit,
       :include_leg_geometry,
       :key,
+      :optimize_for,
       :travel_mode,
       :truck_mode_options,
       :waypoint_positions)
@@ -3656,7 +3667,7 @@ module Aws::LocationService
     end
 
     # @!attribute [rw] filter_geometry
-    #   The geomerty used to filter device positions.
+    #   The geometry used to filter device positions.
     #   @return [Types::TrackingFilterGeometry]
     #
     # @!attribute [rw] max_results
@@ -4802,6 +4813,16 @@ module Aws::LocationService
     #   `Main Street`.
     #   @return [String]
     #
+    # @!attribute [rw] sub_municipality
+    #   An area that's part of a larger municipality. For example,
+    #   `Blissville ` is a submunicipality in the Queen County in New York.
+    #
+    #   <note markdown="1"> This property supported by Esri and OpenData. The Esri property is
+    #   `district`, and the OpenData property is `borough`.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @!attribute [rw] sub_region
     #   A county, or an area that's part of a larger region. For example,
     #   `Metro Vancouver`.
@@ -4850,6 +4871,7 @@ module Aws::LocationService
       :postal_code,
       :region,
       :street,
+      :sub_municipality,
       :sub_region,
       :supplemental_categories,
       :time_zone,

data/lib/aws-sdk-locationservice.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-locationservice/customizations'
 # @!group service
 module Aws::LocationService
 
-  GEM_VERSION = '1.41.0'
+  GEM_VERSION = '1.43.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-locationservice
 version: !ruby/object:Gem::Version
-  version: 1.41.0
+  version: 1.43.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-22 00:00:00.000000000 Z
+date: 2023-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core