aws-sdk-locationservice 1.11.0 → 1.15.0

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

@@ -119,7 +119,9 @@ module Aws::LocationService
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -480,6 +482,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.
@@ -498,8 +505,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
     #       },
     #     ],
@@ -550,9 +563,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
@@ -633,10 +649,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>
     #
@@ -656,8 +683,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
     #       },
     #     ],
@@ -682,7 +715,7 @@ module Aws::LocationService
 
     # [Calculates a route][1] given the following required parameters:
     # `DeparturePostiton` and `DestinationPosition`. Requires that you first
-    # [create a route calculator resource][2]
+    # [create a route calculator resource][2].
     #
     # 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
@@ -695,7 +728,8 @@ module Aws::LocationService
     #   data at the given time.
     #
     #   <note markdown="1"> You can't specify both `DepartureTime` and `DepartureNow` in a
-    #   single request. Specifying both parameters returns an error message.
+    #   single request. Specifying both parameters returns a validation
+    #   error.
     #
     #    </note>
     #
@@ -714,7 +748,7 @@ module Aws::LocationService
     #
     # @option params [required, String] :calculator_name
     #   The name of the route calculator resource that you want to use to
-    #   calculate a route.
+    #   calculate the route.
     #
     # @option params [Types::CalculateRouteCarModeOptions] :car_mode_options
     #   Specifies route preferences when traveling by `Car`, such as avoiding
@@ -755,8 +789,8 @@ module Aws::LocationService
     #
     # @option params [Time,DateTime,Date,Integer,String] :departure_time
     #   Specifies the desired time of departure. Uses the given time to
-    #   calculate a route. Otherwise, the best time of day to travel with the
-    #   best traffic conditions is used to calculate the route.
+    #   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.
@@ -954,8 +988,9 @@ module Aws::LocationService
     #
     #   [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.
+    # @option params [String] :pricing_plan
+    #   Optionally specifies the pricing plan for the geofence collection.
+    #   Defaults to `RequestBasedUsage`.
     #
     #   For additional details and restrictions on each pricing plan option,
     #   see the [Amazon Location Service pricing page][1].
@@ -1009,6 +1044,8 @@ module Aws::LocationService
     #   * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
     #     characters: + - = . \_ : / @.
     #
+    #   * Cannot use "aws:" as a prefix for a key.
+    #
     # @return [Types::CreateGeofenceCollectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateGeofenceCollectionResponse#collection_arn #collection_arn} => String
@@ -1021,7 +1058,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",
@@ -1064,8 +1101,9 @@ module Aws::LocationService
     #
     #   * No spaces allowed. For example, `ExampleMap`.
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for your map resource.
+    # @option params [String] :pricing_plan
+    #   Optionally specifies the pricing plan for the map resource. Defaults
+    #   to `RequestBasedUsage`.
     #
     #   For additional details and restrictions on each pricing plan option,
     #   see [Amazon Location Service pricing][1].
@@ -1094,6 +1132,8 @@ module Aws::LocationService
     #   * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
     #     characters: + - = . \_ : / @.
     #
+    #   * Cannot use "aws:" as a prefix for a key.
+    #
     # @return [Types::CreateMapResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateMapResponse#create_time #create_time} => Time
@@ -1108,7 +1148,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",
     #     },
@@ -1129,11 +1169,15 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Creates a place index resource in your AWS account, which supports
-    # functions with geospatial data sourced from your chosen data provider.
+    # 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, and enable
+    # autosuggestions by using the `SearchPlaceIndexForSuggestions`
+    # operation.
     #
     # @option params [required, String] :data_source
-    #   Specifies the data provider of geospatial data.
+    #   Specifies the geospatial data provider for the new place index.
     #
     #   <note markdown="1"> This field is case-sensitive. Enter the valid values as shown. For
     #   example, entering `HERE` returns an error.
@@ -1150,8 +1194,8 @@ module Aws::LocationService
     #     coverage in your region of interest, see [HERE details on goecoding
     #     coverage][4].
     #
-    #     Place index resources using HERE Technologies as a data provider
-    #     can't [store results][5] for locations in Japan. For more
+    #     If you specify HERE Technologies (`Here`) as the data provider, you
+    #     may not [store results][5] for locations in Japan. For more
     #     information, see the [AWS Service Terms][6] for Amazon Location
     #     Service.
     #
@@ -1186,8 +1230,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.
+    # @option params [String] :pricing_plan
+    #   Optionally specifies the pricing plan for the place index resource.
+    #   Defaults to `RequestBasedUsage`.
     #
     #   For additional details and restrictions on each pricing plan option,
     #   see [Amazon Location Service pricing][1].
@@ -1198,23 +1243,26 @@ module Aws::LocationService
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the place index resource. A tag is a
-    #   key-value pair helps manage, identify, search, and filter your
-    #   resources by labelling them.
+    #   key-value pair that helps you manage, identify, search, and filter
+    #   your resources.
     #
     #   Format: `"key" : "value"`
     #
     #   Restrictions:
     #
-    #   * Maximum 50 tags per resource
+    #   * Maximum 50 tags per resource.
     #
-    #   * Each resource tag must be unique with a maximum of one value.
+    #   * Each tag key must be unique and must have exactly one associated
+    #     value.
     #
-    #   * Maximum key length: 128 Unicode characters in UTF-8
+    #   * Maximum key length: 128 Unicode characters in UTF-8.
     #
-    #   * Maximum value length: 256 Unicode characters in UTF-8
+    #   * Maximum value length: 256 Unicode characters in UTF-8.
     #
     #   * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
-    #     characters: + - = . \_ : / @.
+    #     characters: + - = . \_ : / @
+    #
+    #   * Cannot use "aws:" as a prefix for a key.
     #
     # @return [Types::CreatePlaceIndexResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1231,7 +1279,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",
     #     },
@@ -1305,8 +1353,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.
+    # @option params [String] :pricing_plan
+    #   Optionally specifies the pricing plan for the route calculator
+    #   resource. Defaults to `RequestBasedUsage`.
     #
     #   For additional details and restrictions on each pricing plan option,
     #   see [Amazon Location Service pricing][1].
@@ -1339,6 +1388,8 @@ module Aws::LocationService
     #   * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
     #     characters: + - = . \_ : / @.
     #
+    #   * Cannot use "aws:" as a prefix for a key.
+    #
     # @return [Types::CreateRouteCalculatorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateRouteCalculatorResponse#calculator_arn #calculator_arn} => String
@@ -1351,7 +1402,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",
     #     },
@@ -1397,18 +1448,29 @@ module Aws::LocationService
     #     seconds is stored for each unique device ID.
     #
     #   * `DistanceBased` - If the device has moved less than 30 m (98.4 ft),
-    #     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.
+    #     location updates are ignored. Location updates within this area are
+    #     neither evaluated against linked geofence collections, nor stored.
+    #     This helps control costs by reducing the number of geofence
+    #     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 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.
+    # @option params [String] :pricing_plan
+    #   Optionally specifies the pricing plan for the tracker resource.
+    #   Defaults to `RequestBasedUsage`.
     #
     #   For additional details and restrictions on each pricing plan option,
     #   see [Amazon Location Service pricing][1].
@@ -1462,6 +1524,8 @@ module Aws::LocationService
     #   * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
     #     characters: + - = . \_ : / @.
     #
+    #   * Cannot use "aws:" as a prefix for a key.
+    #
     # @option params [required, String] :tracker_name
     #   The name for the tracker resource.
     #
@@ -1485,8 +1549,8 @@ module Aws::LocationService
     #   resp = client.create_tracker({
     #     description: "ResourceDescription",
     #     kms_key_id: "KmsKeyId",
-    #     position_filtering: "TimeBased", # accepts TimeBased, DistanceBased
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     position_filtering: "TimeBased", # accepts TimeBased, DistanceBased, AccuracyBased
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     pricing_plan_data_source: "String",
     #     tags: {
     #       "TagKey" => "TagValue",
@@ -1851,7 +1915,7 @@ module Aws::LocationService
     #   resp.create_time #=> Time
     #   resp.description #=> String
     #   resp.kms_key_id #=> String
-    #   resp.position_filtering #=> String, one of "TimeBased", "DistanceBased"
+    #   resp.position_filtering #=> String, one of "TimeBased", "DistanceBased", "AccuracyBased"
     #   resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
     #   resp.pricing_plan_data_source #=> String
     #   resp.tags #=> Hash
@@ -1924,8 +1988,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
     #
@@ -1938,9 +2004,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
     #
@@ -2025,9 +2094,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
@@ -2321,9 +2393,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
     #
@@ -2770,21 +2845,34 @@ module Aws::LocationService
     # @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.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/search/bcp47
+    #
     # @option params [Integer] :max_results
-    #   An optional paramer. The maximum number of results returned per
+    #   An optional parameter. The maximum number of results returned per
     #   request.
     #
     #   Default value: `50`
     #
     # @option params [required, Array<Float>] :position
-    #   Specifies a coordinate for the query defined by a longitude, and
-    #   latitude.
-    #
-    #   * The first position is the X coordinate, or longitude.
+    #   Specifies the longitude and latitude of the position to query.
     #
-    #   * The second position is the Y coordinate, or latitude.
+    #   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, `position=xLongitude&position=yLatitude` .
+    #   For example, `[-123.1174, 49.2847]` represents a position with
+    #   longitude `-123.1174` and latitude `49.2847`.
     #
     # @return [Types::SearchPlaceIndexForPositionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2795,6 +2883,7 @@ module Aws::LocationService
     #
     #   resp = client.search_place_index_for_position({
     #     index_name: "ResourceName", # required
+    #     language: "LanguageTag",
     #     max_results: 1,
     #     position: [1.0], # required
     #   })
@@ -2802,10 +2891,12 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.results #=> Array
+    #   resp.results[0].distance #=> Float
     #   resp.results[0].place.address_number #=> String
     #   resp.results[0].place.country #=> String
     #   resp.results[0].place.geometry.point #=> Array
     #   resp.results[0].place.geometry.point[0] #=> Float
+    #   resp.results[0].place.interpolated #=> Boolean
     #   resp.results[0].place.label #=> String
     #   resp.results[0].place.municipality #=> String
     #   resp.results[0].place.neighborhood #=> String
@@ -2813,7 +2904,10 @@ module Aws::LocationService
     #   resp.results[0].place.region #=> String
     #   resp.results[0].place.street #=> String
     #   resp.results[0].place.sub_region #=> String
+    #   resp.results[0].place.time_zone.name #=> String
+    #   resp.results[0].place.time_zone.offset #=> Integer
     #   resp.summary.data_source #=> String
+    #   resp.summary.language #=> String
     #   resp.summary.max_results #=> Integer
     #   resp.summary.position #=> Array
     #   resp.summary.position[0] #=> Float
@@ -2827,11 +2921,146 @@ 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.
     #
-    # Includes the option to apply additional parameters to narrow your list
-    # of results.
+    # 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 places near a given position using `BiasPosition`,
     # or filter results within a bounding box using `FilterBBox`. Providing
@@ -2839,46 +3068,51 @@ module Aws::LocationService
     #
     #  </note>
     #
-    # @option params [Array<Float>] :bias_position
-    #   Searches for results closest to the given position. An optional
-    #   parameter defined by longitude, and latitude.
-    #
-    #   * The first `bias` position is the X coordinate, or longitude.
+    # Search results are returned in order of highest to lowest relevance.
     #
-    #   * The second `bias` position is the Y coordinate, or latitude.
+    # @option params [Array<Float>] :bias_position
+    #   An optional parameter that indicates a preference for places that are
+    #   closer to a specified position.
     #
-    #   For example, `bias=xLongitude&bias=yLatitude`.
+    #   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.
     #
-    # @option params [Array<Float>] :filter_b_box
-    #   Filters the results by returning only Places within the provided
-    #   bounding box. An optional parameter.
+    #   For example, `[-123.1174, 49.2847]` represents the position with
+    #   longitude `-123.1174` and latitude `49.2847`.
     #
-    #   The first 2 `bbox` parameters describe the lower southwest corner:
+    #   <note markdown="1"> `BiasPosition` and `FilterBBox` are mutually exclusive. Specifying
+    #   both options results in an error.
     #
-    #   * The first `bbox` position is the X coordinate or longitude of the
-    #     lower southwest corner.
-    #
-    #   * The second `bbox` position is the Y coordinate or latitude of the
-    #     lower southwest corner.
+    #    </note>
     #
-    #   For example, `bbox=xLongitudeSW&bbox=yLatitudeSW`.
+    # @option params [Array<Float>] :filter_b_box
+    #   An optional parameter that limits the search results by returning only
+    #   places that are within the provided bounding box.
     #
-    #   The next `bbox` parameters describe the upper northeast corner:
+    #   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.
     #
-    #   * The third `bbox` position is the X coordinate, or longitude of the
-    #     upper northeast corner.
+    #   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`.
     #
-    #   * The fourth `bbox` position is the Y coordinate, or longitude of the
-    #     upper northeast corner.
+    #   <note markdown="1"> `FilterBBox` and `BiasPosition` are mutually exclusive. Specifying
+    #   both options results in an error.
     #
-    #   For example, `bbox=xLongitudeNE&bbox=yLatitudeNE`
+    #    </note>
     #
     # @option params [Array<String>] :filter_countries
-    #   Limits the search to the given a list of countries/regions. An
-    #   optional parameter.
+    #   An optional parameter that limits the search results by returning only
+    #   places that are in a specified list of countries.
     #
-    #   * Use the [ISO 3166][1] 3-digit country code. For example, Australia
-    #     uses three upper-case characters: `AUS`.
+    #   * Valid values include [ISO 3166][1] 3-digit country codes. For
+    #     example, Australia uses three upper-case characters: `AUS`.
     #
     #   ^
     #
@@ -2889,6 +3123,19 @@ module Aws::LocationService
     # @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.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/search/bcp47
+    #
     # @option params [Integer] :max_results
     #   An optional parameter. The maximum number of results returned per
     #   request.
@@ -2896,7 +3143,7 @@ module Aws::LocationService
     #   The default: `50`
     #
     # @option params [required, String] :text
-    #   The address, name, city, or region to be used in the search. In
+    #   The address, name, city, or region to be used in the search in
     #   free-form text format. For example, `123 Any Street`.
     #
     # @return [Types::SearchPlaceIndexForTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2911,6 +3158,7 @@ module Aws::LocationService
     #     filter_b_box: [1.0],
     #     filter_countries: ["CountryCode"],
     #     index_name: "ResourceName", # required
+    #     language: "LanguageTag",
     #     max_results: 1,
     #     text: "SyntheticSearchPlaceIndexForTextRequestString", # required
     #   })
@@ -2918,10 +3166,12 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.results #=> Array
+    #   resp.results[0].distance #=> Float
     #   resp.results[0].place.address_number #=> String
     #   resp.results[0].place.country #=> String
     #   resp.results[0].place.geometry.point #=> Array
     #   resp.results[0].place.geometry.point[0] #=> Float
+    #   resp.results[0].place.interpolated #=> Boolean
     #   resp.results[0].place.label #=> String
     #   resp.results[0].place.municipality #=> String
     #   resp.results[0].place.neighborhood #=> String
@@ -2929,6 +3179,9 @@ module Aws::LocationService
     #   resp.results[0].place.region #=> String
     #   resp.results[0].place.street #=> String
     #   resp.results[0].place.sub_region #=> String
+    #   resp.results[0].place.time_zone.name #=> String
+    #   resp.results[0].place.time_zone.offset #=> Integer
+    #   resp.results[0].relevance #=> Float
     #   resp.summary.bias_position #=> Array
     #   resp.summary.bias_position[0] #=> Float
     #   resp.summary.data_source #=> String
@@ -2936,6 +3189,7 @@ module Aws::LocationService
     #   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.result_b_box #=> Array
     #   resp.summary.result_b_box[0] #=> Float
@@ -2965,12 +3219,27 @@ module Aws::LocationService
     #   ^
     #
     # @option params [required, Hash<String,String>] :tags
-    #   Tags that have been applied to the specified resource. Tags are mapped
-    #   from the tag key to the tag value: `"TagKey" : "TagValue"`.
+    #   Applies one or more tags to specific resource. A tag is a key-value
+    #   pair that helps you manage, identify, search, and filter your
+    #   resources.
     #
-    #   * Format example: `\{"tag1" : "value1", "tag2" : "value2"\} `
+    #   Format: `"key" : "value"`
     #
-    #   ^
+    #   Restrictions:
+    #
+    #   * Maximum 50 tags per resource.
+    #
+    #   * Each tag key must be unique and must have exactly one associated
+    #     value.
+    #
+    #   * Maximum key length: 128 Unicode characters in UTF-8.
+    #
+    #   * Maximum value length: 256 Unicode characters in UTF-8.
+    #
+    #   * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
+    #     characters: + - = . \_ : / @
+    #
+    #   * Cannot use "aws:" as a prefix for a key.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3263,9 +3532,19 @@ 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.
+    #     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.
     #
     # @option params [String] :pricing_plan
     #   Updates the pricing plan for the tracker resource.
@@ -3314,7 +3593,7 @@ module Aws::LocationService
     #
     #   resp = client.update_tracker({
     #     description: "ResourceDescription",
-    #     position_filtering: "TimeBased", # accepts TimeBased, DistanceBased
+    #     position_filtering: "TimeBased", # accepts TimeBased, DistanceBased, AccuracyBased
     #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     pricing_plan_data_source: "String",
     #     tracker_name: "ResourceName", # required
@@ -3348,7 +3627,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.11.0'
+      context[:gem_version] = '1.15.0'
       Seahorse::Client::Request.new(handlers, context)
     end