aws-sdk-locationservice 1.14.0 → 1.18.0

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

@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +75,8 @@ module Aws::LocationService
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -175,6 +179,10 @@ module Aws::LocationService
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -297,7 +305,7 @@ module Aws::LocationService
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -313,6 +321,9 @@ module Aws::LocationService
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -714,7 +725,7 @@ module Aws::LocationService
     end
 
     # [Calculates a route][1] given the following required parameters:
-    # `DeparturePostiton` and `DestinationPosition`. Requires that you first
+    # `DeparturePosition` and `DestinationPosition`. Requires that you first
     # [create a route calculator resource][2].
     #
     # By default, a request that doesn't specify a departure time uses the
@@ -724,27 +735,25 @@ module Aws::LocationService
     # Additional options include:
     #
     # * [Specifying a departure time][3] using either `DepartureTime` or
-    #   `DepartureNow`. This calculates a route based on predictive traffic
+    #   `DepartNow`. This calculates a route based on predictive traffic
     #   data at the given time.
     #
-    #   <note markdown="1"> You can't specify both `DepartureTime` and `DepartureNow` in a
-    #   single request. Specifying both parameters returns a validation
-    #   error.
+    #   <note markdown="1"> You can't specify both `DepartureTime` and `DepartNow` in a single
+    #   request. Specifying both parameters returns a validation error.
     #
     #    </note>
     #
-    # * [Specifying a travel mode][4] using TravelMode. This lets you
-    #   specify an additional route preference such as `CarModeOptions` if
+    # * [Specifying a travel mode][4] using TravelMode sets the
+    #   transportation mode used to calculate the routes. This also lets you
+    #   specify additional route preferences in `CarModeOptions` if
     #   traveling by `Car`, or `TruckModeOptions` if traveling by `Truck`.
     #
     #
     #
-    #
-    #
     # [1]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html
     # [2]: https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html
-    # [3]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#departure-time
-    # [4]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#travel-mode
+    # [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 [required, String] :calculator_name
     #   The name of the route calculator resource that you want to use to
@@ -785,7 +794,7 @@ module Aws::LocationService
     #
     #
     #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
-    #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road
+    #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html
     #
     # @option params [Time,DateTime,Date,Integer,String] :departure_time
     #   Specifies the desired time of departure. Uses the given time to
@@ -824,7 +833,7 @@ module Aws::LocationService
     #
     #
     #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
-    #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road
+    #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html
     #
     # @option params [String] :distance_unit
     #   Set the unit system to specify the distance.
@@ -843,7 +852,7 @@ module Aws::LocationService
     #   Specifies the mode of transport when calculating a route. Used in
     #   estimating the speed of travel and road compatibility.
     #
-    #   The `TravelMode` you specify determines how you specify route
+    #   The `TravelMode` you specify also determines how you specify route
     #   preferences:
     #
     #   * If traveling by `Car` use the `CarModeOptions` parameter.
@@ -886,7 +895,7 @@ module Aws::LocationService
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html
     #
     # @return [Types::CalculateRouteResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -963,65 +972,267 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Creates a geofence collection, which manages and stores geofences.
+    # [ Calculates a route matrix][1] given the following required
+    # parameters: `DeparturePositions` and `DestinationPositions`.
+    # `CalculateRouteMatrix` calculates routes and returns the travel time
+    # and travel distance from each departure position to each destination
+    # position in the request. For example, given departure positions A and
+    # B, and destination positions X and Y, `CalculateRouteMatrix` will
+    # return time and distance for routes from A to X, A to Y, B to X, and B
+    # to Y (in that order). The number of results returned (and routes
+    # calculated) will be the number of `DeparturePositions` times the
+    # number of `DestinationPositions`.
     #
-    # @option params [required, String] :collection_name
-    #   A custom name for the geofence collection.
+    # <note markdown="1"> Your account is charged for each route calculated, not the number of
+    # requests.
     #
-    #   Requirements:
+    #  </note>
     #
-    #   * Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-),
-    #     periods (.), and underscores (\_).
+    # Requires that you first [create a route calculator resource][2].
     #
-    #   * Must be a unique geofence collection name.
+    # By default, a request that doesn't specify a departure time uses the
+    # best time of day to travel with the best traffic conditions when
+    # calculating routes.
     #
-    #   * No spaces allowed. For example, `ExampleGeofenceCollection`.
+    # Additional options include:
     #
-    # @option params [String] :description
-    #   An optional description for the geofence collection.
+    # * [ Specifying a departure time][3] using either `DepartureTime` or
+    #   `DepartNow`. This calculates routes based on predictive traffic data
+    #   at the given time.
     #
-    # @option params [String] :kms_key_id
-    #   A key identifier for an [AWS KMS customer managed key][1]. Enter a key
-    #   ID, key ARN, alias name, or alias ARN.
+    #   <note markdown="1"> You can't specify both `DepartureTime` and `DepartNow` in a single
+    #   request. Specifying both parameters returns a validation error.
     #
+    #    </note>
     #
+    # * [Specifying a travel mode][4] using TravelMode sets the
+    #   transportation mode used to calculate the routes. This also lets you
+    #   specify additional route preferences in `CarModeOptions` if
+    #   traveling by `Car`, or `TruckModeOptions` if traveling by `Truck`.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for the geofence collection.
     #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    # [1]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix.html
+    # [2]: https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html
+    # [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 [required, String] :calculator_name
+    #   The name of the route calculator resource that you want to use to
+    #   calculate the route matrix.
     #
+    # @option params [Types::CalculateRouteCarModeOptions] :car_mode_options
+    #   Specifies route preferences when traveling by `Car`, such as avoiding
+    #   routes that use ferries or tolls.
     #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   Requirements: `TravelMode` must be specified as `Car`.
     #
-    # @option params [String] :pricing_plan_data_source
-    #   Specifies the data provider for the geofence collection.
+    # @option params [Boolean] :depart_now
+    #   Sets the time of departure as the current time. Uses the current time
+    #   to calculate the route matrix. You can't set both `DepartureTime` and
+    #   `DepartNow`. If neither is set, the best time of day to travel with
+    #   the best traffic conditions is used to calculate the route matrix.
+    #
+    #   Default Value: `false`
+    #
+    #   Valid Values: `false` \| `true`
+    #
+    # @option params [required, Array<Array>] :departure_positions
+    #   The list of departure (origin) positions for the route matrix. An
+    #   array of points, each of which is itself a 2-value array defined in
+    #   [WGS 84][1] format: `[longitude, latitude]`. For example, `[-123.115,
+    #   49.285]`.
+    #
+    #   Depending on the data provider selected in the route calculator
+    #   resource there may be additional restrictions on the inputs you can
+    #   choose. See [ Position restrictions][2] in the *Amazon Location
+    #   Service Developer Guide*.
+    #
+    #   <note markdown="1"> For route calculators that use Esri as the data provider, if you
+    #   specify a departure that's not located on a road, Amazon Location [
+    #   moves the position to the nearest road][3]. The snapped value is
+    #   available in the result in `SnappedDeparturePositions`.
+    #
+    #    </note>
+    #
+    #   Valid Values: `[-180 to 180,-90 to 90]`
+    #
+    #
+    #
+    #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
+    #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix.html#matrix-routing-position-limits
+    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :departure_time
+    #   Specifies the desired time of departure. Uses the given time to
+    #   calculate the route matrix. You can't set both `DepartureTime` and
+    #   `DepartNow`. If neither is set, the best time of day to travel with
+    #   the best traffic conditions is used to calculate the route matrix.
+    #
+    #   <note markdown="1"> Setting a departure time in the past returns a `400
+    #   ValidationException` error.
+    #
+    #    </note>
     #
-    #   * Required value for the following pricing plans: `MobileAssetTracking
-    #     `\| `MobileAssetManagement`
+    #   * In [ISO 8601][1] format: `YYYY-MM-DDThh:mm:ss.sssZ`. For example,
+    #     `2020–07-2T12:15:20.000Z+01:00`
     #
     #   ^
     #
-    #   For more information about [Data Providers][1], and [Pricing
-    #   plans][2], see the Amazon Location Service product page.
     #
-    #   <note markdown="1"> Amazon Location Service only uses `PricingPlanDataSource` to calculate
-    #   billing for your geofence collection. Your data won't be shared with
-    #   the data provider, and will remain in your AWS account or Region
-    #   unless you move it.
+    #
+    #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
+    #
+    # @option params [required, Array<Array>] :destination_positions
+    #   The list of destination positions for the route matrix. An array of
+    #   points, each of which is itself a 2-value array defined in [WGS 84][1]
+    #   format: `[longitude, latitude]`. For example, `[-122.339, 47.615]`
+    #
+    #   Depending on the data provider selected in the route calculator
+    #   resource there may be additional restrictions on the inputs you can
+    #   choose. See [ Position restrictions][2] in the *Amazon Location
+    #   Service Developer Guide*.
+    #
+    #   <note markdown="1"> For route calculators that use Esri as the data provider, if you
+    #   specify a destination that's not located on a road, Amazon Location [
+    #   moves the position to the nearest road][3]. The snapped value is
+    #   available in the result in `SnappedDestinationPositions`.
     #
     #    </note>
     #
-    #   Valid Values: `Esri `\| `Here`
+    #   Valid Values: `[-180 to 180,-90 to 90]`
+    #
+    #
+    #
+    #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
+    #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix.html#matrix-routing-position-limits
+    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html
+    #
+    # @option params [String] :distance_unit
+    #   Set the unit system to specify the distance.
+    #
+    #   Default Value: `Kilometers`
+    #
+    # @option params [String] :travel_mode
+    #   Specifies the mode of transport when calculating a route. Used in
+    #   estimating the speed of travel and road compatibility.
+    #
+    #   The `TravelMode` you specify also determines how you specify route
+    #   preferences:
+    #
+    #   * If traveling by `Car` use the `CarModeOptions` parameter.
+    #
+    #   * If traveling by `Truck` use the `TruckModeOptions` parameter.
+    #
+    #   Default Value: `Car`
+    #
+    # @option params [Types::CalculateRouteTruckModeOptions] :truck_mode_options
+    #   Specifies route preferences when traveling by `Truck`, such as
+    #   avoiding routes that use ferries or tolls, and truck specifications to
+    #   consider when choosing an optimal road.
+    #
+    #   Requirements: `TravelMode` must be specified as `Truck`.
+    #
+    # @return [Types::CalculateRouteMatrixResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CalculateRouteMatrixResponse#route_matrix #route_matrix} => Array&lt;Array&lt;Types::RouteMatrixEntry&gt;&gt;
+    #   * {Types::CalculateRouteMatrixResponse#snapped_departure_positions #snapped_departure_positions} => Array&lt;Array&lt;Float&gt;&gt;
+    #   * {Types::CalculateRouteMatrixResponse#snapped_destination_positions #snapped_destination_positions} => Array&lt;Array&lt;Float&gt;&gt;
+    #   * {Types::CalculateRouteMatrixResponse#summary #summary} => Types::CalculateRouteMatrixSummary
+    #
+    # @example Request syntax with placeholder values
     #
+    #   resp = client.calculate_route_matrix({
+    #     calculator_name: "ResourceName", # required
+    #     car_mode_options: {
+    #       avoid_ferries: false,
+    #       avoid_tolls: false,
+    #     },
+    #     depart_now: false,
+    #     departure_positions: [ # required
+    #       [1.0],
+    #     ],
+    #     departure_time: Time.now,
+    #     destination_positions: [ # required
+    #       [1.0],
+    #     ],
+    #     distance_unit: "Kilometers", # accepts Kilometers, Miles
+    #     travel_mode: "Car", # accepts Car, Truck, Walking
+    #     truck_mode_options: {
+    #       avoid_ferries: false,
+    #       avoid_tolls: false,
+    #       dimensions: {
+    #         height: 1.0,
+    #         length: 1.0,
+    #         unit: "Meters", # accepts Meters, Feet
+    #         width: 1.0,
+    #       },
+    #       weight: {
+    #         total: 1.0,
+    #         unit: "Kilograms", # accepts Kilograms, Pounds
+    #       },
+    #     },
+    #   })
     #
+    # @example Response structure
     #
-    #   [1]: https://aws.amazon.com/location/data-providers/
-    #   [2]: https://aws.amazon.com/location/pricing/
+    #   resp.route_matrix #=> Array
+    #   resp.route_matrix[0] #=> Array
+    #   resp.route_matrix[0][0].distance #=> Float
+    #   resp.route_matrix[0][0].duration_seconds #=> Float
+    #   resp.route_matrix[0][0].error.code #=> String, one of "RouteNotFound", "RouteTooLong", "PositionsNotFound", "DestinationPositionNotFound", "DeparturePositionNotFound", "OtherValidationError"
+    #   resp.route_matrix[0][0].error.message #=> String
+    #   resp.snapped_departure_positions #=> Array
+    #   resp.snapped_departure_positions[0] #=> Array
+    #   resp.snapped_departure_positions[0][0] #=> Float
+    #   resp.snapped_destination_positions #=> Array
+    #   resp.snapped_destination_positions[0] #=> Array
+    #   resp.snapped_destination_positions[0][0] #=> Float
+    #   resp.summary.data_source #=> String
+    #   resp.summary.distance_unit #=> String, one of "Kilometers", "Miles"
+    #   resp.summary.error_count #=> Integer
+    #   resp.summary.route_count #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CalculateRouteMatrix AWS API Documentation
+    #
+    # @overload calculate_route_matrix(params = {})
+    # @param [Hash] params ({})
+    def calculate_route_matrix(params = {}, options = {})
+      req = build_request(:calculate_route_matrix, params)
+      req.send_request(options)
+    end
+
+    # Creates a geofence collection, which manages and stores geofences.
+    #
+    # @option params [required, String] :collection_name
+    #   A custom name for the geofence collection.
+    #
+    #   Requirements:
+    #
+    #   * Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-),
+    #     periods (.), and underscores (\_).
+    #
+    #   * Must be a unique geofence collection name.
+    #
+    #   * No spaces allowed. For example, `ExampleGeofenceCollection`.
+    #
+    # @option params [String] :description
+    #   An optional description for the geofence collection.
+    #
+    # @option params [String] :kms_key_id
+    #   A key identifier for an [AWS KMS customer managed key][1]. Enter a key
+    #   ID, key ARN, alias name, or alias ARN.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
+    #
+    # @option params [String] :pricing_plan
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
+    #
+    # @option params [String] :pricing_plan_data_source
+    #   This parameter is no longer used.
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the geofence collection. A tag is a
@@ -1057,7 +1268,7 @@ module Aws::LocationService
     #     collection_name: "ResourceName", # required
     #     description: "ResourceDescription",
     #     kms_key_id: "KmsKeyId",
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     pricing_plan_data_source: "String",
     #     tags: {
     #       "TagKey" => "TagValue",
@@ -1082,6 +1293,17 @@ module Aws::LocationService
     # Creates a map resource in your AWS account, which provides map tiles
     # of different styles sourced from global location data providers.
     #
+    # <note markdown="1"> If your application is tracking or routing assets you use in your
+    # business, such as delivery vehicles or employees, you may only use
+    # HERE as your geolocation provider. See section 82 of the [AWS service
+    # terms][1] for more details.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: http://aws.amazon.com/service-terms
+    #
     # @option params [required, Types::MapConfiguration] :configuration
     #   Specifies the map style selected from an available data provider.
     #
@@ -1100,15 +1322,9 @@ module Aws::LocationService
     #
     #   * No spaces allowed. For example, `ExampleMap`.
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for your map resource.
-    #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    # @option params [String] :pricing_plan
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the map resource. A tag is a key-value
@@ -1146,7 +1362,7 @@ module Aws::LocationService
     #     },
     #     description: "ResourceDescription",
     #     map_name: "ResourceName", # required
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
@@ -1174,6 +1390,17 @@ module Aws::LocationService
     # autosuggestions by using the `SearchPlaceIndexForSuggestions`
     # operation.
     #
+    # <note markdown="1"> If your application is tracking or routing assets you use in your
+    # business, such as delivery vehicles or employees, you may only use
+    # HERE as your geolocation provider. See section 82 of the [AWS service
+    # terms][1] for more details.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: http://aws.amazon.com/service-terms
+    #
     # @option params [required, String] :data_source
     #   Specifies the geospatial data provider for the new place index.
     #
@@ -1228,15 +1455,9 @@ module Aws::LocationService
     #
     #   * No spaces allowed. For example, `ExamplePlaceIndex`.
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for your place index resource.
-    #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    # @option params [String] :pricing_plan
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the place index resource. A tag is a
@@ -1276,7 +1497,7 @@ module Aws::LocationService
     #     },
     #     description: "ResourceDescription",
     #     index_name: "ResourceName", # required
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
@@ -1303,6 +1524,17 @@ module Aws::LocationService
     # travel time, distance, and get directions. A route calculator sources
     # traffic and road network data from your chosen data provider.
     #
+    # <note markdown="1"> If your application is tracking or routing assets you use in your
+    # business, such as delivery vehicles or employees, you may only use
+    # HERE as your geolocation provider. See section 82 of the [AWS service
+    # terms][1] for more details.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: http://aws.amazon.com/service-terms
+    #
     # @option params [required, String] :calculator_name
     #   The name of the route calculator resource.
     #
@@ -1350,15 +1582,9 @@ module Aws::LocationService
     # @option params [String] :description
     #   The optional description for the route calculator resource.
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for your route calculator resource.
-    #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    # @option params [String] :pricing_plan
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the route calculator resource. A tag is a
@@ -1398,7 +1624,7 @@ module Aws::LocationService
     #     calculator_name: "ResourceName", # required
     #     data_source: "String", # required
     #     description: "ResourceDescription",
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
@@ -1464,40 +1690,12 @@ module Aws::LocationService
     #   This field is optional. If not specified, the default value is
     #   `TimeBased`.
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for the tracker resource.
-    #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    # @option params [String] :pricing_plan
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @option params [String] :pricing_plan_data_source
-    #   Specifies the data provider for the tracker resource.
-    #
-    #   * Required value for the following pricing plans: `MobileAssetTracking
-    #     `\| `MobileAssetManagement`
-    #
-    #   ^
-    #
-    #   For more information about [Data Providers][1], and [Pricing
-    #   plans][2], see the Amazon Location Service product page.
-    #
-    #   <note markdown="1"> Amazon Location Service only uses `PricingPlanDataSource` to calculate
-    #   billing for your tracker resource. Your data will not be shared with
-    #   the data provider, and will remain in your AWS account or Region
-    #   unless you move it.
-    #
-    #    </note>
-    #
-    #   Valid values: `Esri` \| `Here`
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/data-providers/
-    #   [2]: https://aws.amazon.com/location/pricing/
+    #   This parameter is no longer used.
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the tracker resource. A tag is a key-value
@@ -1545,7 +1743,7 @@ module Aws::LocationService
     #     description: "ResourceDescription",
     #     kms_key_id: "KmsKeyId",
     #     position_filtering: "TimeBased", # accepts TimeBased, DistanceBased, AccuracyBased
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     pricing_plan_data_source: "String",
     #     tags: {
     #       "TagKey" => "TagValue",
@@ -3297,38 +3495,11 @@ module Aws::LocationService
     #   Updates the description for the geofence collection.
     #
     # @option params [String] :pricing_plan
-    #   Updates the pricing plan for the geofence collection.
-    #
-    #   For more information about each pricing plan option restrictions, see
-    #   [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @option params [String] :pricing_plan_data_source
-    #   Updates the data provider for the geofence collection.
-    #
-    #   A required value for the following pricing plans:
-    #   `MobileAssetTracking`\| `MobileAssetManagement`
-    #
-    #   For more information about [data providers][1] and [pricing plans][2],
-    #   see the Amazon Location Service product page.
-    #
-    #   <note markdown="1"> This can only be updated when updating the `PricingPlan` in the same
-    #   request.
-    #
-    #    Amazon Location Service uses `PricingPlanDataSource` to calculate
-    #   billing for your geofence collection. Your data won't be shared with
-    #   the data provider, and will remain in your AWS account and Region
-    #   unless you move it.
-    #
-    #    </note>
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/data-providers/
-    #   [2]: https://aws.amazon.com/location/pricing/
+    #   This parameter is no longer used.
     #
     # @return [Types::UpdateGeofenceCollectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3369,14 +3540,8 @@ module Aws::LocationService
     #   The name of the map resource to update.
     #
     # @option params [String] :pricing_plan
-    #   Updates the pricing plan for the map resource.
-    #
-    #   For more information about each pricing plan option restrictions, see
-    #   [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @return [Types::UpdateMapResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3419,14 +3584,8 @@ module Aws::LocationService
     #   The name of the place index resource to update.
     #
     # @option params [String] :pricing_plan
-    #   Updates the pricing plan for the place index resource.
-    #
-    #   For more information about each pricing plan option restrictions, see
-    #   [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @return [Types::UpdatePlaceIndexResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3470,14 +3629,8 @@ module Aws::LocationService
     #   Updates the description for the route calculator resource.
     #
     # @option params [String] :pricing_plan
-    #   Updates the pricing plan for the route calculator resource.
-    #
-    #   For more information about each pricing plan option restrictions, see
-    #   [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @return [Types::UpdateRouteCalculatorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3542,38 +3695,11 @@ module Aws::LocationService
     #     evaluations.
     #
     # @option params [String] :pricing_plan
-    #   Updates the pricing plan for the tracker resource.
-    #
-    #   For more information about each pricing plan option restrictions, see
-    #   [Amazon Location Service pricing][1].
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   No longer used. If included, the only allowed value is
+    #   `RequestBasedUsage`.
     #
     # @option params [String] :pricing_plan_data_source
-    #   Updates the data provider for the tracker resource.
-    #
-    #   A required value for the following pricing plans:
-    #   `MobileAssetTracking`\| `MobileAssetManagement`
-    #
-    #   For more information about [data providers][1] and [pricing plans][2],
-    #   see the Amazon Location Service product page
-    #
-    #   <note markdown="1"> This can only be updated when updating the `PricingPlan` in the same
-    #   request.
-    #
-    #    Amazon Location Service uses `PricingPlanDataSource` to calculate
-    #   billing for your tracker resource. Your data won't be shared with the
-    #   data provider, and will remain in your AWS account and Region unless
-    #   you move it.
-    #
-    #    </note>
-    #
-    #
-    #
-    #   [1]: https://aws.amazon.com/location/data-providers/
-    #   [2]: https://aws.amazon.com/location/pricing/
+    #   This parameter is no longer used.
     #
     # @option params [required, String] :tracker_name
     #   The name of the tracker resource to update.
@@ -3622,7 +3748,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.14.0'
+      context[:gem_version] = '1.18.0'
       Seahorse::Client::Request.new(handlers, context)
     end