aws-sdk-locationservice 1.8.0 → 1.12.0

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

@@ -646,7 +646,7 @@ module Aws::LocationService
     #
     # @!attribute [rw] calculator_name
     #   The name of the route calculator resource that you want to use to
-    #   calculate a route.
+    #   calculate the route.
     #   @return [String]
     #
     # @!attribute [rw] car_mode_options
@@ -675,7 +675,9 @@ module Aws::LocationService
     #   ^
     #
     #   <note markdown="1"> If you specify a departure that's not located on a road, Amazon
-    #   Location [moves the position to the nearest road][2].
+    #   Location [moves the position to the nearest road][2]. If Esri is the
+    #   provider for your route calculator, specifying a route that is
+    #   longer than 400 km returns a `400 RoutesValidationException` error.
     #
     #    </note>
     #
@@ -689,7 +691,7 @@ module Aws::LocationService
     #
     # @!attribute [rw] 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
+    #   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
@@ -782,6 +784,10 @@ module Aws::LocationService
     #    Specifying more than 23 waypoints returns a `400
     #   ValidationException` error.
     #
+    #    If Esri is the provider for your route calculator, specifying a
+    #   route that is longer than 400 km returns a `400
+    #   RoutesValidationException` error.
+    #
     #    </note>
     #
     #   Valid Values: `[-180 to 180,-90 to 90]`
@@ -878,15 +884,15 @@ module Aws::LocationService
     #   The total distance covered by the route. The sum of the distance
     #   travelled between every stop on the route.
     #
-    #   <note markdown="1"> The route `distance` can't be greater than 250 km. If the route
-    #   exceeds 250 km, the response returns a `400
-    #   RoutesValidationException` error.
+    #   <note markdown="1"> If Esri is the data source for the route calculator, the route
+    #   distance can’t be greater than 400 km. If the route exceeds 400 km,
+    #   the response is a `400 RoutesValidationException` error.
     #
     #    </note>
     #   @return [Float]
     #
     # @!attribute [rw] distance_unit
-    #   The unit of measurement for the distance.
+    #   The unit of measurement for route distances.
     #   @return [String]
     #
     # @!attribute [rw] duration_seconds
@@ -912,8 +918,8 @@ module Aws::LocationService
     #   * The third `bbox` position is the X coordinate, or longitude of the
     #     upper northeast corner.
     #
-    #   * The fourth `bbox` position is the Y coordinate, or longitude of
-    #     the upper northeast corner.
+    #   * The fourth `bbox` position is the Y coordinate, or latitude of the
+    #     upper northeast corner.
     #   @return [Array<Float>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CalculateRouteSummary AWS API Documentation
@@ -1097,6 +1103,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 [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateGeofenceCollectionRequest AWS API Documentation
@@ -1185,7 +1193,7 @@ module Aws::LocationService
     #   Specifies the pricing plan for your map resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -1211,6 +1219,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 [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateMapRequest AWS API Documentation
@@ -1274,7 +1284,7 @@ module Aws::LocationService
     #       }
     #
     # @!attribute [rw] 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.
@@ -1287,12 +1297,12 @@ module Aws::LocationService
     #     your region of interest, see [Esri details on geocoding
     #     coverage][2].
     #
-    #   * `Here` – For additional information about [HERE
-    #     Technologies][3]'s coverage in your region of interest, see [HERE
-    #     details on goecoding coverage][4].
+    #   * `Here` – For additional information about [HERE Technologies][3]'
+    #     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.
     #
@@ -1335,7 +1345,7 @@ module Aws::LocationService
     #   Specifies the pricing plan for your place index resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -1344,23 +1354,26 @@ module Aws::LocationService
     #
     # @!attribute [rw] 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 [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreatePlaceIndexRequest AWS API Documentation
@@ -1439,7 +1452,9 @@ module Aws::LocationService
     #   Specifies the data provider of traffic and road network data.
     #
     #   <note markdown="1"> This field is case-sensitive. Enter the valid values as shown. For
-    #   example, entering `HERE` returns an error.
+    #   example, entering `HERE` returns an error. Route calculators that
+    #   use Esri as a data source only calculate routes that are shorter
+    #   than 400 km.
     #
     #    </note>
     #
@@ -1449,9 +1464,9 @@ module Aws::LocationService
     #     your region of interest, see [Esri details on street networks and
     #     traffic coverage][2].
     #
-    #   * `Here` – For additional information about [HERE
-    #     Technologies][3]'s coverage in your region of interest, see [HERE
-    #     car routing coverage][4] and [HERE truck routing coverage][5].
+    #   * `Here` – For additional information about [HERE Technologies][3]'
+    #     coverage in your region of interest, see [HERE car routing
+    #     coverage][4] and [HERE truck routing coverage][5].
     #
     #   For additional information , see [Data providers][6] on the *Amazon
     #   Location Service Developer Guide*.
@@ -1504,6 +1519,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 [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateRouteCalculatorRequest AWS API Documentation
@@ -1565,6 +1582,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_data_source: "String",
     #         tags: {
@@ -1586,11 +1604,33 @@ module Aws::LocationService
     #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
     #   @return [String]
     #
+    # @!attribute [rw] position_filtering
+    #   Specifies the position filtering for the tracker resource.
+    #
+    #   Valid values:
+    #
+    #   * `TimeBased` - Location updates are evaluated against linked
+    #     geofence collections, but not every location update is stored. If
+    #     your update frequency is more often than 30 seconds, only one
+    #     update per 30 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
+    #     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.
+    #
+    #   This field is optional. If not specified, the default value is
+    #   `TimeBased`.
+    #   @return [String]
+    #
     # @!attribute [rw] pricing_plan
     #   Specifies the pricing plan for the tracker resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -1615,7 +1655,7 @@ module Aws::LocationService
     #
     #    </note>
     #
-    #   Valid Values: `Esri` \| `Here`
+    #   Valid values: `Esri` \| `Here`
     #
     #
     #
@@ -1642,6 +1682,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 [Hash<String,String>]
     #
     # @!attribute [rw] tracker_name
@@ -1662,6 +1704,7 @@ module Aws::LocationService
     class CreateTrackerRequest < Struct.new(
       :description,
       :kms_key_id,
+      :position_filtering,
       :pricing_plan,
       :pricing_plan_data_source,
       :tags,
@@ -2022,7 +2065,7 @@ module Aws::LocationService
     # @!attribute [rw] pricing_plan
     #   The pricing plan selected for the specified map resource.
     #
-    #        <p>For additional details and restrictions on each pricing plan option, see the <a href="https://aws.amazon.com/location/pricing/">Amazon Location Service pricing page</a>.</p>
+    #        <p>For additional details and restrictions on each pricing plan option, see <a href="https://aws.amazon.com/location/pricing/">Amazon Location Service pricing</a>.</p>
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -2083,15 +2126,15 @@ module Aws::LocationService
     #   @return [Time]
     #
     # @!attribute [rw] data_source
-    #   The data provider of geospatial data. Indicates one of the available
-    #   providers:
+    #   The data provider of geospatial data. Values can be one of the
+    #   following:
     #
     #   * `Esri`
     #
     #   * `Here`
     #
-    #   For additional details on data providers, see the [Amazon Location
-    #   Service data providers page][1].
+    #   For more information about data providers, see [Amazon Location
+    #   Service data providers][1].
     #
     #
     #
@@ -2124,7 +2167,7 @@ module Aws::LocationService
     #   The pricing plan selected for the specified place index resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -2311,11 +2354,15 @@ module Aws::LocationService
     #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
     #   @return [String]
     #
+    # @!attribute [rw] position_filtering
+    #   The position filtering method of the tracker resource.
+    #   @return [String]
+    #
     # @!attribute [rw] pricing_plan
     #   The pricing plan selected for the specified tracker resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -2359,6 +2406,7 @@ module Aws::LocationService
       :create_time,
       :description,
       :kms_key_id,
+      :position_filtering,
       :pricing_plan,
       :pricing_plan_data_source,
       :tags,
@@ -2776,7 +2824,7 @@ module Aws::LocationService
     #   A comma-separated list of fonts to load glyphs from in order of
     #   preference. For example, `Noto Sans Regular, Arial Unicode`.
     #
-    #   Valid fonts for [Esri][1] styles:
+    #   Valid fonts stacks for [Esri][1] styles:
     #
     #   * VectorEsriDarkGrayCanvas – `Ubuntu Medium Italic` \| `Ubuntu
     #     Medium` \| `Ubuntu Italic` \| `Ubuntu Regular` \| `Ubuntu Bold`
@@ -2794,9 +2842,9 @@ module Aws::LocationService
     #   * VectorEsriNavigation – `Arial Regular` \| `Arial Italic` \| `Arial
     #     Bold`
     #
-    #   Valid fonts for [HERE Technologies][2] styles:
+    #   Valid font stacks for [HERE Technologies][2] styles:
     #
-    #   * `VectorHereBerlin` – `Fira GO Regular` \| `Fira GO Bold`
+    #   * VectorHereBerlin – `Fira GO Regular` \| `Fira GO Bold`
     #
     #   ^
     #
@@ -3500,7 +3548,7 @@ module Aws::LocationService
     #   The pricing plan for the specified map resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -3566,9 +3614,9 @@ module Aws::LocationService
     #   @return [Array<Types::ListPlaceIndexesResponseEntry>]
     #
     # @!attribute [rw] next_token
-    #   A pagination token indicating there are additional pages available.
-    #   You can use the token in a following request to fetch the next set
-    #   of results.
+    #   A pagination token indicating that there are additional pages
+    #   available. You can use the token in a new request to fetch the next
+    #   page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/ListPlaceIndexesResponse AWS API Documentation
@@ -3592,15 +3640,15 @@ module Aws::LocationService
     #   @return [Time]
     #
     # @!attribute [rw] data_source
-    #   The data provider of geospatial data. Indicates one of the available
-    #   providers:
+    #   The data provider of geospatial data. Values can be one of the
+    #   following:
     #
     #   * `Esri`
     #
     #   * `Here`
     #
-    #   For additional details on data providers, see the [Amazon Location
-    #   Service data providers page][1].
+    #   For more information about data providers, see [Amazon Location
+    #   Service data providers][1].
     #
     #
     #
@@ -3619,7 +3667,7 @@ module Aws::LocationService
     #   The pricing plan for the specified place index resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -3947,7 +3995,7 @@ module Aws::LocationService
     #   The pricing plan for the specified tracker resource.
     #
     #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   see [Amazon Location Service pricing][1].
     #
     #
     #
@@ -3995,13 +4043,8 @@ module Aws::LocationService
     #
     # @!attribute [rw] style
     #   Specifies the map style selected from an available data provider.
-    #   For additional information on each map style and to preview each map
-    #   style, see [Esri map
-    #   styles](location/latest/developerguide/esri.html#esri-map-styles)
-    #   and [HERE map
-    #   styles](location/latest/developerguide/HERE.html#HERE-map-styles).
     #
-    #   Valid [Esri][1] styles:
+    #   Valid [Esri map styles][1]\:
     #
     #   * `VectorEsriDarkGrayCanvas` – The Esri Dark Gray Canvas map style.
     #     A vector basemap with a dark gray, neutral background with minimal
@@ -4031,7 +4074,7 @@ module Aws::LocationService
     #     custom navigation map style that's designed for use during the
     #     day in mobile devices.
     #
-    #   Valid [HERE Technologies][2] styles:
+    #   Valid [HERE Technologies map styles][2]\:
     #
     #   * `VectorHereBerlin` – The HERE Berlin map style is a high contrast
     #     detailed base map of the world that blends 3D and 2D rendering.
@@ -4078,6 +4121,19 @@ module Aws::LocationService
     #   Places uses a point geometry to specify a location or a Place.
     #   @return [Types::PlaceGeometry]
     #
+    # @!attribute [rw] interpolated
+    #   `True` if the result is interpolated from other known places.
+    #
+    #   `False` if the Place is a known place.
+    #
+    #   Not returned when the partner does not provide the information.
+    #
+    #   For example, returns `False` for an address location that is found
+    #   in the partner data, but returns `True` if an address does not exist
+    #   in the partner data and its location is calculated by interpolating
+    #   between other known addresses.
+    #   @return [Boolean]
+    #
     # @!attribute [rw] label
     #   The full name and address of the point of interest such as a city,
     #   region, or country. For example, `123 Any Street, Any Town, USA`.
@@ -4108,23 +4164,30 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] sub_region
-    #   A country, or an area that's part of a larger region . For example,
+    #   A country, or an area that's part of a larger region. For example,
     #   `Metro Vancouver`.
     #   @return [String]
     #
+    # @!attribute [rw] time_zone
+    #   The time zone in which the `Place` is located. Returned only when
+    #   using Here as the selected partner.
+    #   @return [Types::TimeZone]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/Place AWS API Documentation
     #
     class Place < Struct.new(
       :address_number,
       :country,
       :geometry,
+      :interpolated,
       :label,
       :municipality,
       :neighborhood,
       :postal_code,
       :region,
       :street,
-      :sub_region)
+      :sub_region,
+      :time_zone)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4243,32 +4306,65 @@ module Aws::LocationService
       include Aws::Structure
     end
 
-    # Specifies a single point of interest, or Place as a result of a search
-    # query obtained from a dataset configured in the place index resource.
+    # Contains a search result from a position search query that is run on a
+    # place index resource.
+    #
+    # @!attribute [rw] distance
+    #   The distance in meters of a great-circle arc between the query
+    #   position and the result.
+    #
+    #   <note markdown="1"> A great-circle arc is the shortest path on a sphere, in this case
+    #   the Earth. This returns the shortest distance between two locations.
+    #
+    #    </note>
+    #   @return [Float]
     #
     # @!attribute [rw] place
-    #   Contains details about the relevant point of interest.
+    #   Details about the search result, such as its address and position.
     #   @return [Types::Place]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchForPositionResult AWS API Documentation
     #
     class SearchForPositionResult < Struct.new(
+      :distance,
       :place)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Contains relevant Places returned by calling
-    # `SearchPlaceIndexForText`.
+    # Contains a search result from a text search query that is run on a
+    # place index resource.
+    #
+    # @!attribute [rw] distance
+    #   The distance in meters of a great-circle arc between the bias
+    #   position specified and the result. `Distance` will be returned only
+    #   if a bias position was specified in the query.
+    #
+    #   <note markdown="1"> A great-circle arc is the shortest path on a sphere, in this case
+    #   the Earth. This returns the shortest distance between two locations.
+    #
+    #    </note>
+    #   @return [Float]
     #
     # @!attribute [rw] place
-    #   Contains details about the relevant point of interest.
+    #   Details about the search result, such as its address and position.
     #   @return [Types::Place]
     #
+    # @!attribute [rw] relevance
+    #   The relative confidence in the match for a result among the results
+    #   returned. For example, if more fields for an address match
+    #   (including house number, street, city, country/region, and postal
+    #   code), the relevance score is closer to 1.
+    #
+    #   Returned only when the partner selected is Esri.
+    #   @return [Float]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchForTextResult AWS API Documentation
     #
     class SearchForTextResult < Struct.new(
-      :place)
+      :distance,
+      :place,
+      :relevance)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4278,6 +4374,7 @@ module Aws::LocationService
     #
     #       {
     #         index_name: "ResourceName", # required
+    #         language: "LanguageTag",
     #         max_results: 1,
     #         position: [1.0], # required
     #       }
@@ -4286,28 +4383,43 @@ module Aws::LocationService
     #   The name of the place index resource you want to use for the search.
     #   @return [String]
     #
+    # @!attribute [rw] 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
+    #   @return [String]
+    #
     # @!attribute [rw] 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`
     #   @return [Integer]
     #
     # @!attribute [rw] 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 [Array<Float>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchPlaceIndexForPositionRequest AWS API Documentation
     #
     class SearchPlaceIndexForPositionRequest < Struct.new(
       :index_name,
+      :language,
       :max_results,
       :position)
       SENSITIVE = [:position]
@@ -4320,7 +4432,9 @@ module Aws::LocationService
     #   @return [Array<Types::SearchForPositionResult>]
     #
     # @!attribute [rw] summary
-    #   Contains a summary of the request.
+    #   Contains a summary of the request. Echoes the input values for
+    #   `Position`, `Language`, `MaxResults`, and the `DataSource` of the
+    #   place index.
     #   @return [Types::SearchPlaceIndexForPositionSummary]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchPlaceIndexForPositionResponse AWS API Documentation
@@ -4332,40 +4446,50 @@ module Aws::LocationService
       include Aws::Structure
     end
 
-    # A summary of the reverse geocoding request sent using
-    # `SearchPlaceIndexForPosition`.
+    # A summary of the request sent by using `SearchPlaceIndexForPosition`.
     #
     # @!attribute [rw] data_source
-    #   The data provider of geospatial data. Indicates one of the available
-    #   providers:
+    #   The geospatial data provider attached to the place index resource
+    #   specified in the request. Values can be one of the following:
     #
     #   * Esri
     #
-    #   * HERE
+    #   * Here
     #
-    #   For additional details on data providers, see the [Amazon Location
-    #   Service data providers page][1].
+    #   For more information about data providers, see [Amazon Location
+    #   Service data providers][1].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
     #   @return [String]
     #
+    # @!attribute [rw] language
+    #   The preferred language used to return results. Matches the language
+    #   in the request. The value is a valid [BCP 47][1] language tag, for
+    #   example, `en` for English.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/search/bcp47
+    #   @return [String]
+    #
     # @!attribute [rw] max_results
-    #   An optional parameter. The maximum number of results returned per
+    #   Contains the optional result count limit that is specified in the
     #   request.
     #
     #   Default value: `50`
     #   @return [Integer]
     #
     # @!attribute [rw] position
-    #   The position given in the reverse geocoding request.
+    #   The position specified in the request.
     #   @return [Array<Float>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchPlaceIndexForPositionSummary AWS API Documentation
     #
     class SearchPlaceIndexForPositionSummary < Struct.new(
       :data_source,
+      :language,
       :max_results,
       :position)
       SENSITIVE = [:position]
@@ -4380,52 +4504,56 @@ module Aws::LocationService
     #         filter_b_box: [1.0],
     #         filter_countries: ["CountryCode"],
     #         index_name: "ResourceName", # required
+    #         language: "LanguageTag",
     #         max_results: 1,
     #         text: "SyntheticSearchPlaceIndexForTextRequestString", # required
     #       }
     #
     # @!attribute [rw] bias_position
-    #   Searches for results closest to the given position. An optional
-    #   parameter defined by longitude, and latitude.
+    #   An optional parameter that indicates a preference for places that
+    #   are closer to a specified position.
     #
-    #   * The first `bias` position is the X coordinate, or longitude.
+    #   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.
     #
-    #   * The second `bias` position is the Y coordinate, or latitude.
+    #   For example, `[-123.1174, 49.2847]` represents the position with
+    #   longitude `-123.1174` and latitude `49.2847`.
     #
-    #   For example, `bias=xLongitude&bias=yLatitude`.
+    #   <note markdown="1"> `BiasPosition` and `FilterBBox` are mutually exclusive. Specifying
+    #   both options results in an error.
+    #
+    #    </note>
     #   @return [Array<Float>]
     #
     # @!attribute [rw] filter_b_box
-    #   Filters the results by returning only Places within the provided
-    #   bounding box. An optional parameter.
-    #
-    #   The first 2 `bbox` parameters describe the lower southwest corner:
-    #
-    #   * 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.
-    #
-    #   For example, `bbox=xLongitudeSW&bbox=yLatitudeSW`.
+    #   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>
     #   @return [Array<Float>]
     #
     # @!attribute [rw] 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`.
     #
     #   ^
     #
@@ -4438,6 +4566,20 @@ module Aws::LocationService
     #   The name of the place index resource you want to use for the search.
     #   @return [String]
     #
+    # @!attribute [rw] 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
+    #   @return [String]
+    #
     # @!attribute [rw] max_results
     #   An optional parameter. The maximum number of results returned per
     #   request.
@@ -4446,7 +4588,7 @@ module Aws::LocationService
     #   @return [Integer]
     #
     # @!attribute [rw] 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 [String]
     #
@@ -4457,6 +4599,7 @@ module Aws::LocationService
       :filter_b_box,
       :filter_countries,
       :index_name,
+      :language,
       :max_results,
       :text)
       SENSITIVE = [:bias_position, :filter_b_box, :text]
@@ -4464,15 +4607,16 @@ module Aws::LocationService
     end
 
     # @!attribute [rw] results
-    #   A list of Places closest to the specified position. Each result
-    #   contains additional information about the specific point of
-    #   interest.
+    #   A list of Places matching the input text. Each result contains
+    #   additional information about the specific point of interest.
     #   @return [Array<Types::SearchForTextResult>]
     #
     # @!attribute [rw] summary
-    #   Contains a summary of the request. Contains the `BiasPosition`,
-    #   `DataSource`, `FilterBBox`, `FilterCountries`, `MaxResults`,
-    #   `ResultBBox`, and `Text`.
+    #   Contains a summary of the request. Echoes the input values for
+    #   `BiasPosition`, `FilterBBox`, `FilterCountries`, `Language`,
+    #   `MaxResults`, and `Text`. Also includes the `DataSource` of the
+    #   place index and the bounding box, `ResultBBox`, which surrounds the
+    #   search results.
     #   @return [Types::SearchPlaceIndexForTextSummary]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchPlaceIndexForTextResponse AWS API Documentation
@@ -4484,24 +4628,23 @@ module Aws::LocationService
       include Aws::Structure
     end
 
-    # A summary of the geocoding request sent using
-    # `SearchPlaceIndexForText`.
+    # A summary of the request sent by using `SearchPlaceIndexForText`.
     #
     # @!attribute [rw] bias_position
-    #   Contains the coordinates for the bias position entered in the
-    #   geocoding request.
+    #   Contains the coordinates for the optional bias position specified in
+    #   the request.
     #   @return [Array<Float>]
     #
     # @!attribute [rw] data_source
-    #   The data provider of geospatial data. Indicates one of the available
-    #   providers:
+    #   The geospatial data provider attached to the place index resource
+    #   specified in the request. Values can be one of the following:
     #
     #   * Esri
     #
-    #   * HERE
+    #   * Here
     #
-    #   For additional details on data providers, see the [Amazon Location
-    #   Service data providers page][1].
+    #   For more information about data providers, see [Amazon Location
+    #   Service data providers][1].
     #
     #
     #
@@ -4509,27 +4652,39 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] filter_b_box
-    #   Contains the coordinates for the optional bounding box coordinated
-    #   entered in the geocoding request.
+    #   Contains the coordinates for the optional bounding box specified in
+    #   the request.
     #   @return [Array<Float>]
     #
     # @!attribute [rw] filter_countries
-    #   Contains the country filter entered in the geocoding request.
+    #   Contains the optional country filter specified in the request.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] language
+    #   The preferred language used to return results. Matches the language
+    #   in the request. The value is a valid [BCP 47][1] language tag, for
+    #   example, `en` for English.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/search/bcp47
+    #   @return [String]
+    #
     # @!attribute [rw] max_results
-    #   Contains the maximum number of results indicated for the request.
+    #   Contains the optional result count limit specified in the request.
     #   @return [Integer]
     #
     # @!attribute [rw] result_b_box
-    #   A bounding box that contains the search results within the specified
-    #   area indicated by `FilterBBox`. A subset of bounding box specified
-    #   using `FilterBBox`.
+    #   The bounding box that fully contains all search results.
+    #
+    #   <note markdown="1"> If you specified the optional `FilterBBox` parameter in the request,
+    #   `ResultBBox` is contained within `FilterBBox`.
+    #
+    #    </note>
     #   @return [Array<Float>]
     #
     # @!attribute [rw] text
-    #   The address, name, city or region to be used in the geocoding
-    #   request. In free-form text format. For example, `Vancouver`.
+    #   The search text specified in the request.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchPlaceIndexForTextSummary AWS API Documentation
@@ -4539,6 +4694,7 @@ module Aws::LocationService
       :data_source,
       :filter_b_box,
       :filter_countries,
+      :language,
       :max_results,
       :result_b_box,
       :text)
@@ -4634,12 +4790,27 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] 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 [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/TagResourceRequest AWS API Documentation
@@ -4668,6 +4839,31 @@ module Aws::LocationService
       include Aws::Structure
     end
 
+    # Information about a time zone. Includes the name of the time zone and
+    # the offset from UTC in seconds.
+    #
+    # @!attribute [rw] name
+    #   The name of the time zone, following the [ IANA time zone
+    #   standard][1]. For example, `America/Los_Angeles`.
+    #
+    #
+    #
+    #   [1]: https://www.iana.org/time-zones
+    #   @return [String]
+    #
+    # @!attribute [rw] offset
+    #   The time zone's offset, in seconds, from UTC.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/TimeZone AWS API Documentation
+    #
+    class TimeZone < Struct.new(
+      :name,
+      :offset)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains details about the truck dimensions in the unit of measurement
     # that you specify. Used to filter out roads that can't support or
     # allow the specified dimensions for requests that specify `TravelMode`
@@ -5117,6 +5313,7 @@ module Aws::LocationService
     #
     #       {
     #         description: "ResourceDescription",
+    #         position_filtering: "TimeBased", # accepts TimeBased, DistanceBased, AccuracyBased
     #         pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #         pricing_plan_data_source: "String",
     #         tracker_name: "ResourceName", # required
@@ -5126,6 +5323,25 @@ module Aws::LocationService
     #   Updates the description for the tracker resource.
     #   @return [String]
     #
+    # @!attribute [rw] position_filtering
+    #   Updates the position filtering for the tracker resource.
+    #
+    #   Valid values:
+    #
+    #   * `TimeBased` - Location updates are evaluated against linked
+    #     geofence collections, but not every location update is stored. If
+    #     your update frequency is more often than 30 seconds, only one
+    #     update per 30 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.
+    #   @return [String]
+    #
     # @!attribute [rw] pricing_plan
     #   Updates the pricing plan for the tracker resource.
     #
@@ -5170,6 +5386,7 @@ module Aws::LocationService
     #
     class UpdateTrackerRequest < Struct.new(
       :description,
+      :position_filtering,
       :pricing_plan,
       :pricing_plan_data_source,
       :tracker_name)