aws-sdk-locationservice 1.13.0 → 1.17.0

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

@@ -27,6 +27,7 @@ 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/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +74,7 @@ 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::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -175,6 +177,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 +303,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 +319,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`.
     #
@@ -482,6 +491,11 @@ module Aws::LocationService
     #
     #  </note>
     #
+    # <note markdown="1"> Geofence evaluation uses the given device position. It does not
+    # account for the optional `Accuracy` of a `DevicePositionUpdate`.
+    #
+    #  </note>
+    #
     # @option params [required, String] :collection_name
     #   The geofence collection used in evaluating the position of devices
     #   against its geofences.
@@ -500,8 +514,14 @@ module Aws::LocationService
     #     collection_name: "ResourceName", # required
     #     device_position_updates: [ # required
     #       {
+    #         accuracy: {
+    #           horizontal: 1.0, # required
+    #         },
     #         device_id: "Id", # required
     #         position: [1.0], # required
+    #         position_properties: {
+    #           "PropertyMapKeyString" => "PropertyMapValueString",
+    #         },
     #         sample_time: Time.now, # required
     #       },
     #     ],
@@ -552,9 +572,12 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.device_positions #=> Array
+    #   resp.device_positions[0].accuracy.horizontal #=> Float
     #   resp.device_positions[0].device_id #=> String
     #   resp.device_positions[0].position #=> Array
     #   resp.device_positions[0].position[0] #=> Float
+    #   resp.device_positions[0].position_properties #=> Hash
+    #   resp.device_positions[0].position_properties["PropertyMapKeyString"] #=> String
     #   resp.device_positions[0].received_time #=> Time
     #   resp.device_positions[0].sample_time #=> Time
     #   resp.errors #=> Array
@@ -635,10 +658,21 @@ module Aws::LocationService
     # location data is stored at a maximum of one position per 30 second
     # interval. If your update frequency is more often than every 30
     # seconds, only one update per 30 seconds is stored for each unique
-    # device ID. When `PositionFiltering` is set to `DistanceBased`
-    # filtering, location data is stored and evaluated against linked
-    # geofence collections only if the device has moved more than 30 m (98.4
-    # ft).
+    # device ID.
+    #
+    #  When `PositionFiltering` is set to `DistanceBased` filtering, location
+    # data is stored and evaluated against linked geofence collections only
+    # if the device has moved more than 30 m (98.4 ft).
+    #
+    #  When `PositionFiltering` is set to `AccuracyBased` filtering, location
+    # data is stored and evaluated against linked geofence collections only
+    # if the device has moved more than the measured accuracy. For example,
+    # if two consecutive updates from a device have a horizontal accuracy of
+    # 5 m and 10 m, the second update is neither stored or evaluated if the
+    # device has moved less than 15 m. If `PositionFiltering` is set to
+    # `AccuracyBased` filtering, Amazon Location uses the default value `\{
+    # "Horizontal": 0\}` when accuracy is not provided on a
+    # `DevicePositionUpdate`.
     #
     #  </note>
     #
@@ -658,8 +692,14 @@ module Aws::LocationService
     #     tracker_name: "ResourceName", # required
     #     updates: [ # required
     #       {
+    #         accuracy: {
+    #           horizontal: 1.0, # required
+    #         },
     #         device_id: "Id", # required
     #         position: [1.0], # required
+    #         position_properties: {
+    #           "PropertyMapKeyString" => "PropertyMapValueString",
+    #         },
     #         sample_time: Time.now, # required
     #       },
     #     ],
@@ -683,7 +723,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
@@ -693,27 +733,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
@@ -754,7 +792,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
@@ -793,7 +831,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.
@@ -812,7 +850,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.
@@ -855,7 +893,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:
     #
@@ -932,65 +970,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]`.
     #
-    #   * Required value for the following pricing plans: `MobileAssetTracking
-    #     `\| `MobileAssetManagement`
+    #   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>
+    #
+    #   * 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
+    #
+    #   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://aws.amazon.com/location/data-providers/
-    #   [2]: https://aws.amazon.com/location/pricing/
+    #
+    #   [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
@@ -1026,7 +1266,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",
@@ -1051,6 +1291,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.
     #
@@ -1069,15 +1320,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
@@ -1115,7 +1360,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",
     #     },
@@ -1139,7 +1384,20 @@ module Aws::LocationService
     # Creates a place index resource in your AWS account. Use a place index
     # resource to geocode addresses and other text queries by using the
     # `SearchPlaceIndexForText` operation, and reverse geocode coordinates
-    # by using the `SearchPlaceIndexForPosition` operation.
+    # by using the `SearchPlaceIndexForPosition` operation, and enable
+    # 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.
@@ -1195,15 +1453,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
@@ -1243,7 +1495,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",
     #     },
@@ -1270,6 +1522,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.
     #
@@ -1317,15 +1580,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
@@ -1365,7 +1622,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",
     #     },
@@ -1418,43 +1675,25 @@ module Aws::LocationService
     #     Distance-based filtering can also reduce the effects of GPS noise
     #     when displaying device trajectories on a map.
     #
+    #   * `AccuracyBased` - If the device has moved less than the measured
+    #     accuracy, location updates are ignored. For example, if two
+    #     consecutive updates from a device have a horizontal accuracy of 5 m
+    #     and 10 m, the second update is ignored if the device has moved less
+    #     than 15 m. Ignored location updates are neither evaluated against
+    #     linked geofence collections, nor stored. This can reduce the effects
+    #     of GPS noise when displaying device trajectories on a map, and can
+    #     help control your costs by reducing the number of geofence
+    #     evaluations.
+    #
     #   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
@@ -1502,7 +1741,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",
@@ -1940,8 +2179,10 @@ module Aws::LocationService
     #
     # @return [Types::GetDevicePositionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
+    #   * {Types::GetDevicePositionResponse#accuracy #accuracy} => Types::PositionalAccuracy
     #   * {Types::GetDevicePositionResponse#device_id #device_id} => String
     #   * {Types::GetDevicePositionResponse#position #position} => Array&lt;Float&gt;
+    #   * {Types::GetDevicePositionResponse#position_properties #position_properties} => Hash&lt;String,String&gt;
     #   * {Types::GetDevicePositionResponse#received_time #received_time} => Time
     #   * {Types::GetDevicePositionResponse#sample_time #sample_time} => Time
     #
@@ -1954,9 +2195,12 @@ module Aws::LocationService
     #
     # @example Response structure
     #
+    #   resp.accuracy.horizontal #=> Float
     #   resp.device_id #=> String
     #   resp.position #=> Array
     #   resp.position[0] #=> Float
+    #   resp.position_properties #=> Hash
+    #   resp.position_properties["PropertyMapKeyString"] #=> String
     #   resp.received_time #=> Time
     #   resp.sample_time #=> Time
     #
@@ -2041,9 +2285,12 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.device_positions #=> Array
+    #   resp.device_positions[0].accuracy.horizontal #=> Float
     #   resp.device_positions[0].device_id #=> String
     #   resp.device_positions[0].position #=> Array
     #   resp.device_positions[0].position[0] #=> Float
+    #   resp.device_positions[0].position_properties #=> Hash
+    #   resp.device_positions[0].position_properties["PropertyMapKeyString"] #=> String
     #   resp.device_positions[0].received_time #=> Time
     #   resp.device_positions[0].sample_time #=> Time
     #   resp.next_token #=> String
@@ -2337,9 +2584,12 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.data.entries #=> Array
+    #   resp.data.entries[0].accuracy.horizontal #=> Float
     #   resp.data.entries[0].device_id #=> String
     #   resp.data.entries[0].position #=> Array
     #   resp.data.entries[0].position[0] #=> Float
+    #   resp.data.entries[0].position_properties #=> Hash
+    #   resp.data.entries[0].position_properties["PropertyMapKeyString"] #=> String
     #   resp.data.entries[0].sample_time #=> Time
     #   resp.next_token #=> String
     #
@@ -2862,6 +3112,140 @@ module Aws::LocationService
       req.send_request(options)
     end
 
+    # Generates suggestions for addresses and points of interest based on
+    # partial or misspelled free-form text. This operation is also known as
+    # autocomplete, autosuggest, or fuzzy matching.
+    #
+    # Optional parameters let you narrow your search results by bounding box
+    # or country, or bias your search toward a specific position on the
+    # globe.
+    #
+    # <note markdown="1"> You can search for suggested place names near a specified position by
+    # using `BiasPosition`, or filter results within a bounding box by using
+    # `FilterBBox`. These parameters are mutually exclusive; using both
+    # `BiasPosition` and `FilterBBox` in the same command returns an error.
+    #
+    #  </note>
+    #
+    # @option params [Array<Float>] :bias_position
+    #   An optional parameter that indicates a preference for place
+    #   suggestions that are closer to a specified position.
+    #
+    #   If provided, this parameter must contain a pair of numbers. The first
+    #   number represents the X coordinate, or longitude; the second number
+    #   represents the Y coordinate, or latitude.
+    #
+    #   For example, `[-123.1174, 49.2847]` represents the position with
+    #   longitude `-123.1174` and latitude `49.2847`.
+    #
+    #   <note markdown="1"> `BiasPosition` and `FilterBBox` are mutually exclusive. Specifying
+    #   both options results in an error.
+    #
+    #    </note>
+    #
+    # @option params [Array<Float>] :filter_b_box
+    #   An optional parameter that limits the search results by returning only
+    #   suggestions within a specified bounding box.
+    #
+    #   If provided, this parameter must contain a total of four consecutive
+    #   numbers in two pairs. The first pair of numbers represents the X and Y
+    #   coordinates (longitude and latitude, respectively) of the southwest
+    #   corner of the bounding box; the second pair of numbers represents the
+    #   X and Y coordinates (longitude and latitude, respectively) of the
+    #   northeast corner of the bounding box.
+    #
+    #   For example, `[-12.7935, -37.4835, -12.0684, -36.9542]` represents a
+    #   bounding box where the southwest corner has longitude `-12.7935` and
+    #   latitude `-37.4835`, and the northeast corner has longitude `-12.0684`
+    #   and latitude `-36.9542`.
+    #
+    #   <note markdown="1"> `FilterBBox` and `BiasPosition` are mutually exclusive. Specifying
+    #   both options results in an error.
+    #
+    #    </note>
+    #
+    # @option params [Array<String>] :filter_countries
+    #   An optional parameter that limits the search results by returning only
+    #   suggestions within the provided list of countries.
+    #
+    #   * Use the [ISO 3166][1] 3-digit country code. For example, Australia
+    #     uses three upper-case characters: `AUS`.
+    #
+    #   ^
+    #
+    #
+    #
+    #   [1]: https://www.iso.org/iso-3166-country-codes.html
+    #
+    # @option params [required, String] :index_name
+    #   The name of the place index resource you want to use for the search.
+    #
+    # @option params [String] :language
+    #   The preferred language used to return results. The value must be a
+    #   valid [BCP 47][1] language tag, for example, `en` for English.
+    #
+    #   This setting affects the languages used in the results. It does not
+    #   change which results are returned. If the language is not specified,
+    #   or not supported for a particular result, the partner automatically
+    #   chooses a language for the result.
+    #
+    #   Used only when the partner selected is Here.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/search/bcp47
+    #
+    # @option params [Integer] :max_results
+    #   An optional parameter. The maximum number of results returned per
+    #   request.
+    #
+    #   The default: `5`
+    #
+    # @option params [required, String] :text
+    #   The free-form partial text to use to generate place suggestions. For
+    #   example, `eiffel tow`.
+    #
+    # @return [Types::SearchPlaceIndexForSuggestionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::SearchPlaceIndexForSuggestionsResponse#results #results} => Array&lt;Types::SearchForSuggestionsResult&gt;
+    #   * {Types::SearchPlaceIndexForSuggestionsResponse#summary #summary} => Types::SearchPlaceIndexForSuggestionsSummary
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.search_place_index_for_suggestions({
+    #     bias_position: [1.0],
+    #     filter_b_box: [1.0],
+    #     filter_countries: ["CountryCode"],
+    #     index_name: "ResourceName", # required
+    #     language: "LanguageTag",
+    #     max_results: 1,
+    #     text: "SyntheticSearchPlaceIndexForSuggestionsRequestString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.results #=> Array
+    #   resp.results[0].text #=> String
+    #   resp.summary.bias_position #=> Array
+    #   resp.summary.bias_position[0] #=> Float
+    #   resp.summary.data_source #=> String
+    #   resp.summary.filter_b_box #=> Array
+    #   resp.summary.filter_b_box[0] #=> Float
+    #   resp.summary.filter_countries #=> Array
+    #   resp.summary.filter_countries[0] #=> String
+    #   resp.summary.language #=> String
+    #   resp.summary.max_results #=> Integer
+    #   resp.summary.text #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchPlaceIndexForSuggestions AWS API Documentation
+    #
+    # @overload search_place_index_for_suggestions(params = {})
+    # @param [Hash] params ({})
+    def search_place_index_for_suggestions(params = {}, options = {})
+      req = build_request(:search_place_index_for_suggestions, params)
+      req.send_request(options)
+    end
+
     # Geocodes free-form text, such as an address, name, city, or region to
     # allow you to search for Places or points of interest.
     #
@@ -3109,38 +3493,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:
     #
@@ -3181,14 +3538,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:
     #
@@ -3231,14 +3582,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:
     #
@@ -3282,14 +3627,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:
     #
@@ -3339,43 +3678,26 @@ module Aws::LocationService
     #     location updates are ignored. Location updates within this distance
     #     are neither evaluated against linked geofence collections, nor
     #     stored. This helps control costs by reducing the number of geofence
-    #     evaluations and device positions to retrieve. Distance-based
-    #     filtering can also reduce the jitter effect when displaying device
-    #     trajectory on a map.
-    #
-    # @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].
-    #
+    #     evaluations and historical device positions to paginate through.
+    #     Distance-based filtering can also reduce the effects of GPS noise
+    #     when displaying device trajectories on a map.
     #
+    #   * `AccuracyBased` - If the device has moved less than the measured
+    #     accuracy, location updates are ignored. For example, if two
+    #     consecutive updates from a device have a horizontal accuracy of 5 m
+    #     and 10 m, the second update is ignored if the device has moved less
+    #     than 15 m. Ignored location updates are neither evaluated against
+    #     linked geofence collections, nor stored. This helps educe the
+    #     effects of GPS noise when displaying device trajectories on a map,
+    #     and can help control costs by reducing the number of geofence
+    #     evaluations.
     #
-    #   [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
-    #   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.
@@ -3424,7 +3746,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.13.0'
+      context[:gem_version] = '1.17.0'
       Seahorse::Client::Request.new(handlers, context)
     end