aws-sdk-locationservice 1.13.0 → 1.39.0

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

@@ -27,7 +27,11 @@ 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/signature_v4.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
+require 'aws-sdk-core/plugins/request_compression.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
+require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:locationservice)
@@ -73,8 +77,13 @@ module Aws::LocationService
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
-    add_plugin(Aws::Plugins::SignatureV4)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
+    add_plugin(Aws::Plugins::RequestCompression)
+    add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
+    add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestJson)
+    add_plugin(Aws::LocationService::Plugins::Endpoints)
 
     # @overload initialize(options)
     #   @param [Hash] options
@@ -175,10 +184,18 @@ 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.
     #
+    #   @option options [Boolean] :disable_request_compression (false)
+    #     When set to 'true' the request body will not be compressed
+    #     for supported operations.
+    #
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
@@ -199,6 +216,10 @@ module Aws::LocationService
     #   @option options [Boolean] :endpoint_discovery (false)
     #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
+    #   @option options [Boolean] :ignore_configured_endpoint_urls
+    #     Setting to true disables use of endpoint URLs provided via environment
+    #     variables and the shared configuration file.
+    #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
     #
@@ -219,6 +240,11 @@ module Aws::LocationService
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Integer] :request_min_compression_size_bytes (10240)
+    #     The minimum size in bytes that triggers compression for request
+    #     bodies. The value must be non-negative integer value between 0
+    #     and 10485780 bytes inclusive.
+    #
     #   @option options [Proc] :retry_backoff
     #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
     #     This option is only used in the `legacy` retry mode.
@@ -264,6 +290,11 @@ module Aws::LocationService
     #       in the future.
     #
     #
+    #   @option options [String] :sdk_ua_app_id
+    #     A unique and opaque application ID that is appended to the
+    #     User-Agent header as app/<sdk_ua_app_id>. It should have a
+    #     maximum length of 50.
+    #
     #   @option options [String] :secret_access_key
     #
     #   @option options [String] :session_token
@@ -277,6 +308,19 @@ module Aws::LocationService
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::TokenProvider] :token_provider
+    #     A Bearer Token Provider. This can be an instance of any one of the
+    #     following classes:
+    #
+    #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
+    #       tokens.
+    #
+    #     * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
+    #     will be used to search for tokens configured for your profile in shared configuration files.
+    #
     #   @option options [Boolean] :use_dualstack_endpoint
     #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
     #     will be used if available.
@@ -290,6 +334,9 @@ module Aws::LocationService
     #     When `true`, request parameters are validated before
     #     sending the request.
     #
+    #   @option options [Aws::LocationService::EndpointProvider] :endpoint_provider
+    #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::LocationService::EndpointParameters`
+    #
     #   @option options [URI::HTTP,String] :http_proxy A proxy to send
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
@@ -297,7 +344,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 +360,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`.
     #
@@ -354,7 +404,7 @@ module Aws::LocationService
     # @option params [required, String] :consumer_arn
     #   The Amazon Resource Name (ARN) for the geofence collection to be
     #   associated to tracker resource. Used when you need to specify a
-    #   resource across all AWS.
+    #   resource across all Amazon Web Services.
     #
     #   * Format example:
     #     `arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer`
@@ -482,6 +532,16 @@ 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>
+    #
+    # <note markdown="1"> The `DeviceID` is used as a string to represent the device. You do not
+    # need to have a `Tracker` associated with the `DeviceID`.
+    #
+    #  </note>
+    #
     # @option params [required, String] :collection_name
     #   The geofence collection used in evaluating the position of devices
     #   against its geofences.
@@ -500,8 +560,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 +618,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
@@ -593,7 +662,14 @@ module Aws::LocationService
     #     entries: [ # required
     #       {
     #         geofence_id: "Id", # required
+    #         geofence_properties: {
+    #           "PropertyMapKeyString" => "PropertyMapValueString",
+    #         },
     #         geometry: { # required
+    #           circle: {
+    #             center: [1.0], # required
+    #             radius: 1.0, # required
+    #           },
     #           polygon: [
     #             [
     #               [1.0],
@@ -625,9 +701,9 @@ module Aws::LocationService
     end
 
     # Uploads position update data for one or more devices to a tracker
-    # resource. Amazon Location uses the data when it reports the last known
-    # device position and position history. Amazon Location retains location
-    # data for 30 days.
+    # resource (up to 10 devices per batch). Amazon Location uses the data
+    # when it reports the last known device position and position history.
+    # Amazon Location retains location data for 30 days.
     #
     # <note markdown="1"> Position updates are handled based on the `PositionFiltering` property
     # of the tracker. When `PositionFiltering` is set to `TimeBased`,
@@ -635,10 +711,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>
     #
@@ -646,7 +733,8 @@ module Aws::LocationService
     #   The name of the tracker resource to update.
     #
     # @option params [required, Array<Types::DevicePositionUpdate>] :updates
-    #   Contains the position update details for each device.
+    #   Contains the position update details for each device, up to 10
+    #   devices.
     #
     # @return [Types::BatchUpdateDevicePositionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -658,8 +746,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 +777,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 +787,30 @@ 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`.
     #
+    #   <note markdown="1"> If you specify `walking` for the travel mode and your data provider
+    #   is Esri, the start and destination must be within 40km.
     #
+    #    </note>
     #
     #
     #
     # [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
@@ -735,8 +832,8 @@ module Aws::LocationService
     #   Valid Values: `false` \| `true`
     #
     # @option params [required, Array<Float>] :departure_position
-    #   The start position for the route. Defined in [WGS 84][1] format:
-    #   `[longitude, latitude]`.
+    #   The start position for the route. Defined in [World Geodetic System
+    #   (WGS 84)][1] format: `[longitude, latitude]`.
     #
     #   * For example, `[-123.115, 49.285]`
     #
@@ -753,8 +850,8 @@ 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
+    #   [1]: https://earth-info.nga.mil/index.php?dir=wgs84&amp;action=wgs84
+    #   [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
@@ -776,8 +873,8 @@ module Aws::LocationService
     #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
     #
     # @option params [required, Array<Float>] :destination_position
-    #   The finish position for the route. Defined in [WGS 84][1] format:
-    #   `[longitude, latitude]`.
+    #   The finish position for the route. Defined in [World Geodetic System
+    #   (WGS 84)][1] format: `[longitude, latitude]`.
     #
     #   * For example, `[-122.339, 47.615]`
     #
@@ -792,8 +889,8 @@ 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
+    #   [1]: https://earth-info.nga.mil/index.php?dir=wgs84&amp;action=wgs84
+    #   [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.
@@ -808,11 +905,31 @@ module Aws::LocationService
     #
     #   Valid Values: `false` \| `true`
     #
+    # @option params [String] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @option params [String] :travel_mode
     #   Specifies the mode of transport when calculating a route. Used in
-    #   estimating the speed of travel and road compatibility.
+    #   estimating the speed of travel and road compatibility. You can choose
+    #   `Car`, `Truck`, `Walking`, `Bicycle` or `Motorcycle` as options for
+    #   the `TravelMode`.
+    #
+    #   <note markdown="1"> `Bicycle` and `Motorcycle` are only valid when using Grab as a data
+    #   provider, and only within Southeast Asia.
+    #
+    #    `Truck` is not available for Grab.
+    #
+    #    For more details on the using Grab for routing, including areas of
+    #   coverage, see [GrabMaps][1] in the *Amazon Location Service Developer
+    #   Guide*.
     #
-    #   The `TravelMode` you specify determines how you specify route
+    #    </note>
+    #
+    #   The `TravelMode` you specify also determines how you specify route
     #   preferences:
     #
     #   * If traveling by `Car` use the `CarModeOptions` parameter.
@@ -821,6 +938,10 @@ module Aws::LocationService
     #
     #   Default Value: `Car`
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html
+    #
     # @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
@@ -855,7 +976,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:
     #
@@ -876,7 +997,8 @@ module Aws::LocationService
     #     destination_position: [1.0], # required
     #     distance_unit: "Kilometers", # accepts Kilometers, Miles
     #     include_leg_geometry: false,
-    #     travel_mode: "Car", # accepts Car, Truck, Walking
+    #     key: "ApiKey",
+    #     travel_mode: "Car", # accepts Car, Truck, Walking, Bicycle, Motorcycle
     #     truck_mode_options: {
     #       avoid_ferries: false,
     #       avoid_tolls: false,
@@ -932,65 +1054,289 @@ 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`.
+    #
+    # <note markdown="1"> Your account is charged for each route calculated, not the number of
+    # requests.
     #
-    # @option params [required, String] :collection_name
-    #   A custom name for the geofence collection.
+    #  </note>
     #
-    #   Requirements:
+    # Requires that you first [create a route calculator resource][2].
     #
-    #   * Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-),
-    #     periods (.), and underscores (\_).
+    # 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.
     #
-    #   * Must be a unique geofence collection name.
+    # Additional options include:
     #
-    #   * No spaces allowed. For example, `ExampleGeofenceCollection`.
+    # * [ 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] :description
-    #   An optional description for the geofence collection.
+    #   <note markdown="1"> You can't specify both `DepartureTime` and `DepartNow` in a single
+    #   request. Specifying both parameters returns a validation error.
     #
-    # @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>
+    #
+    # * [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
+    # [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 [required, String] :pricing_plan
-    #   Specifies the pricing plan for the geofence collection.
+    # @option params [Types::CalculateRouteCarModeOptions] :car_mode_options
+    #   Specifies route preferences when traveling by `Car`, such as avoiding
+    #   routes that use ferries or tolls.
+    #
+    #   Requirements: `TravelMode` must be specified as `Car`.
+    #
+    # @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.
     #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see the [Amazon Location Service pricing page][1].
+    #   Default Value: `false`
+    #
+    #   Valid Values: `false` \| `true`
     #
+    # @option params [required, Array<Array>] :departure_positions
+    #   The list of departure (origin) positions for the route matrix. An
+    #   array of points, each of which is itself a 2-value array defined in
+    #   [WGS 84][1] format: `[longitude, latitude]`. For example, `[-123.115,
+    #   49.285]`.
     #
+    #   Depending on the data provider selected in the route calculator
+    #   resource there may be additional restrictions on the inputs you can
+    #   choose. See [ Position restrictions][2] in the *Amazon Location
+    #   Service Developer Guide*.
     #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    #   <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]`
     #
-    # @option params [String] :pricing_plan_data_source
-    #   Specifies the data provider for the geofence collection.
     #
-    #   * Required value for the following pricing plans: `MobileAssetTracking
-    #     `\| `MobileAssetManagement`
+    #
+    #   [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: `[-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] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
+    # @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.
+    #
+    #   <note markdown="1"> `Bicycle` or `Motorcycle` are only valid when using `Grab` as a data
+    #   provider, and only within Southeast Asia.
+    #
+    #    `Truck` is not available for Grab.
+    #
+    #    For more information about using Grab as a data provider, see
+    #   [GrabMaps][1] in the *Amazon Location Service Developer Guide*.
     #
     #    </note>
     #
-    #   Valid Values: `Esri `\| `Here`
+    #   Default Value: `Car`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html
+    #
+    # @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
+    #     key: "ApiKey",
+    #     travel_mode: "Car", # accepts Car, Truck, Walking, Bicycle, Motorcycle
+    #     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 [Amazon Web Services 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 +1372,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",
@@ -1048,40 +1394,52 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Creates a map resource in your AWS account, which provides map tiles
-    # of different styles sourced from global location data providers.
+    # Creates an API key resource in your Amazon Web Services account, which
+    # lets you grant actions for Amazon Location resources to the API key
+    # bearer.
     #
-    # @option params [required, Types::MapConfiguration] :configuration
-    #   Specifies the map style selected from an available data provider.
+    # <note markdown="1"> For more information, see [Using API keys][1].
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
     #
     # @option params [String] :description
-    #   An optional description for the map resource.
+    #   An optional description for the API key resource.
     #
-    # @option params [required, String] :map_name
-    #   The name for the map resource.
+    # @option params [Time,DateTime,Date,Integer,String] :expire_time
+    #   The optional timestamp for when the API key resource will expire in [
+    #   ISO 8601][1] format: `YYYY-MM-DDThh:mm:ss.sssZ`. One of `NoExpiry` or
+    #   `ExpireTime` must be set.
     #
-    #   Requirements:
     #
-    #   * Must contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens
-    #     (-), periods (.), and underscores (\_).
     #
-    #   * Must be a unique map resource name.
+    #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
     #
-    #   * No spaces allowed. For example, `ExampleMap`.
+    # @option params [required, String] :key_name
+    #   A custom name for the API key resource.
+    #
+    #   Requirements:
     #
-    # @option params [required, String] :pricing_plan
-    #   Specifies the pricing plan for your map resource.
+    #   * Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-),
+    #     periods (.), and underscores (\_).
     #
-    #   For additional details and restrictions on each pricing plan option,
-    #   see [Amazon Location Service pricing][1].
+    #   * Must be a unique API key name.
     #
+    #   * No spaces allowed. For example, `ExampleAPIKey`.
     #
+    # @option params [Boolean] :no_expiry
+    #   Optionally set to `true` to set no expiration time for the API key.
+    #   One of `NoExpiry` or `ExpireTime` must be set.
     #
-    #   [1]: https://aws.amazon.com/location/pricing/
+    # @option params [required, Types::ApiKeyRestrictions] :restrictions
+    #   The API key restrictions for the API key resource.
     #
     # @option params [Hash<String,String>] :tags
     #   Applies one or more tags to the map resource. A tag is a key-value
-    #   pair helps manage, identify, search, and filter your resources by
+    #   pair that helps manage, identify, search, and filter your resources by
     #   labelling them.
     #
     #   Format: `"key" : "value"`
@@ -1101,21 +1459,25 @@ module Aws::LocationService
     #
     #   * 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:
+    # @return [Types::CreateKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::CreateMapResponse#create_time #create_time} => Time
-    #   * {Types::CreateMapResponse#map_arn #map_arn} => String
-    #   * {Types::CreateMapResponse#map_name #map_name} => String
+    #   * {Types::CreateKeyResponse#create_time #create_time} => Time
+    #   * {Types::CreateKeyResponse#key #key} => String
+    #   * {Types::CreateKeyResponse#key_arn #key_arn} => String
+    #   * {Types::CreateKeyResponse#key_name #key_name} => String
     #
     # @example Request syntax with placeholder values
     #
-    #   resp = client.create_map({
-    #     configuration: { # required
-    #       style: "MapStyle", # required
-    #     },
+    #   resp = client.create_key({
     #     description: "ResourceDescription",
-    #     map_name: "ResourceName", # required
-    #     pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     expire_time: Time.now,
+    #     key_name: "ResourceName", # required
+    #     no_expiry: false,
+    #     restrictions: { # required
+    #       allow_actions: ["ApiKeyAction"], # required
+    #       allow_referers: ["RefererPattern"],
+    #       allow_resources: ["GeoArn"], # required
+    #     },
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
@@ -1124,58 +1486,175 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.create_time #=> Time
-    #   resp.map_arn #=> String
-    #   resp.map_name #=> String
+    #   resp.key #=> String
+    #   resp.key_arn #=> String
+    #   resp.key_name #=> String
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateMap AWS API Documentation
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateKey AWS API Documentation
     #
-    # @overload create_map(params = {})
+    # @overload create_key(params = {})
     # @param [Hash] params ({})
-    def create_map(params = {}, options = {})
-      req = build_request(:create_map, params)
+    def create_key(params = {}, options = {})
+      req = build_request(:create_key, params)
       req.send_request(options)
     end
 
-    # 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.
-    #
-    # @option params [required, String] :data_source
-    #   Specifies the geospatial data provider for the new place index.
+    # Creates a map resource in your Amazon Web Services account, which
+    # provides map tiles of different styles sourced from global location
+    # data providers.
     #
-    #   <note markdown="1"> This field is case-sensitive. Enter the valid values as shown. For
-    #   example, entering `HERE` returns an error.
+    # <note markdown="1"> If your application is tracking or routing assets you use in your
+    # business, such as delivery vehicles or employees, you must not use
+    # Esri as your geolocation provider. See section 82 of the [Amazon Web
+    # Services service terms][1] for more details.
     #
-    #    </note>
+    #  </note>
     #
-    #   Valid values include:
     #
-    #   * `Esri` – For additional information about [Esri][1]'s coverage in
-    #     your region of interest, see [Esri details on geocoding
-    #     coverage][2].
     #
-    #   * `Here` – For additional information about [HERE Technologies][3]'
-    #     coverage in your region of interest, see [HERE details on goecoding
-    #     coverage][4].
+    # [1]: http://aws.amazon.com/service-terms
     #
-    #     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.
+    # @option params [required, Types::MapConfiguration] :configuration
+    #   Specifies the `MapConfiguration`, including the map style, for the map
+    #   resource that you create. The map style defines the look of maps and
+    #   the data provider for your map resource.
     #
-    #   For additional information , see [Data providers][7] on the *Amazon
+    # @option params [String] :description
+    #   An optional description for the map resource.
+    #
+    # @option params [required, String] :map_name
+    #   The name for the map resource.
+    #
+    #   Requirements:
+    #
+    #   * Must contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens
+    #     (-), periods (.), and underscores (\_).
+    #
+    #   * Must be a unique map resource name.
+    #
+    #   * No spaces allowed. For example, `ExampleMap`.
+    #
+    # @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
+    #   pair helps manage, identify, search, and filter your resources by
+    #   labelling them.
+    #
+    #   Format: `"key" : "value"`
+    #
+    #   Restrictions:
+    #
+    #   * Maximum 50 tags per resource
+    #
+    #   * Each resource tag must be unique with a maximum of one 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 [Types::CreateMapResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateMapResponse#create_time #create_time} => Time
+    #   * {Types::CreateMapResponse#map_arn #map_arn} => String
+    #   * {Types::CreateMapResponse#map_name #map_name} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_map({
+    #     configuration: { # required
+    #       political_view: "CountryCode3",
+    #       style: "MapStyle", # required
+    #     },
+    #     description: "ResourceDescription",
+    #     map_name: "ResourceName", # required
+    #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.create_time #=> Time
+    #   resp.map_arn #=> String
+    #   resp.map_name #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateMap AWS API Documentation
+    #
+    # @overload create_map(params = {})
+    # @param [Hash] params ({})
+    def create_map(params = {}, options = {})
+      req = build_request(:create_map, params)
+      req.send_request(options)
+    end
+
+    # Creates a place index resource in your Amazon Web Services 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.
+    #
+    # <note markdown="1"> If your application is tracking or routing assets you use in your
+    # business, such as delivery vehicles or employees, you must not use
+    # Esri as your geolocation provider. See section 82 of the [Amazon Web
+    # Services 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.
+    #
+    #   <note markdown="1"> This field is case-sensitive. Enter the valid values as shown. For
+    #   example, entering `HERE` returns an error.
+    #
+    #    </note>
+    #
+    #   Valid values include:
+    #
+    #   * `Esri` – For additional information about [Esri][1]'s coverage in
+    #     your region of interest, see [Esri details on geocoding
+    #     coverage][2].
+    #
+    #   * `Grab` – Grab provides place index functionality for Southeast Asia.
+    #     For additional information about [GrabMaps][3]' coverage, see
+    #     [GrabMaps countries and areas covered][4].
+    #
+    #   * `Here` – For additional information about [HERE Technologies][5]'
+    #     coverage in your region of interest, see [HERE details on goecoding
+    #     coverage][6].
+    #
+    #     If you specify HERE Technologies (`Here`) as the data provider, you
+    #     may not [store results][7] for locations in Japan. For more
+    #     information, see the [Amazon Web Services Service Terms][8] for
+    #     Amazon Location Service.
+    #
+    #   For additional information , see [Data providers][9] on the *Amazon
     #   Location Service Developer Guide*.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/esri.html
     #   [2]: https://developers.arcgis.com/rest/geocode/api-reference/geocode-coverage.htm
-    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/HERE.html
-    #   [4]: https://developer.here.com/documentation/geocoder/dev_guide/topics/coverage-geocoder.html
-    #   [5]: https://docs.aws.amazon.com/location-places/latest/APIReference/API_DataSourceConfiguration.html
-    #   [6]: https://aws.amazon.com/service-terms/
-    #   [7]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
+    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html
+    #   [4]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html#grab-coverage-area
+    #   [5]: https://docs.aws.amazon.com/location/latest/developerguide/HERE.html
+    #   [6]: https://developer.here.com/documentation/geocoder/dev_guide/topics/coverage-geocoder.html
+    #   [7]: https://docs.aws.amazon.com/location-places/latest/APIReference/API_DataSourceConfiguration.html
+    #   [8]: http://aws.amazon.com/service-terms/
+    #   [9]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
     #
     # @option params [Types::DataSourceConfiguration] :data_source_configuration
     #   Specifies the data storage option requesting Places.
@@ -1195,15 +1674,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 +1716,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",
     #     },
@@ -1264,12 +1737,24 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Creates a route calculator resource in your AWS account.
+    # Creates a route calculator resource in your Amazon Web Services
+    # account.
     #
     # You can send requests to a route calculator resource to estimate
     # 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 must not use
+    # Esri as your geolocation provider. See section 82 of the [Amazon Web
+    # Services 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.
     #
@@ -1286,9 +1771,7 @@ 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. Route calculators that use
-    #   Esri as a data source only calculate routes that are shorter than 400
-    #   km.
+    #   example, entering `HERE` returns an error.
     #
     #    </note>
     #
@@ -1298,34 +1781,37 @@ 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]'
+    #     Route calculators that use Esri as a data source only calculate
+    #     routes that are shorter than 400 km.
+    #
+    #   * `Grab` – Grab provides routing functionality for Southeast Asia. For
+    #     additional information about [GrabMaps][3]' coverage, see [GrabMaps
+    #     countries and areas covered][4].
+    #
+    #   * `Here` – For additional information about [HERE Technologies][5]'
     #     coverage in your region of interest, see [HERE car routing
-    #     coverage][4] and [HERE truck routing coverage][5].
+    #     coverage][6] and [HERE truck routing coverage][7].
     #
-    #   For additional information , see [Data providers][6] on the *Amazon
+    #   For additional information , see [Data providers][8] on the *Amazon
     #   Location Service Developer Guide*.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/esri.html
     #   [2]: https://doc.arcgis.com/en/arcgis-online/reference/network-coverage.htm
-    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/HERE.html
-    #   [4]: https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/car-routing.html
-    #   [5]: https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/truck-routing.html
-    #   [6]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
+    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html
+    #   [4]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html#grab-coverage-area
+    #   [5]: https://docs.aws.amazon.com/location/latest/developerguide/HERE.html
+    #   [6]: https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/car-routing.html
+    #   [7]: https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/truck-routing.html
+    #   [8]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
     #
     # @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 +1851,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",
     #     },
@@ -1386,15 +1872,49 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Creates a tracker resource in your AWS account, which lets you
-    # retrieve current and historical location of devices.
+    # Creates a tracker resource in your Amazon Web Services account, which
+    # lets you retrieve current and historical location of devices.
     #
     # @option params [String] :description
     #   An optional description for the tracker resource.
     #
+    # @option params [Boolean] :event_bridge_enabled
+    #   Whether to enable position `UPDATE` events from this tracker to be
+    #   sent to EventBridge.
+    #
+    #   <note markdown="1"> You do not need enable this feature to get `ENTER` and `EXIT` events
+    #   for geofences with this tracker. Those events are always sent to
+    #   EventBridge.
+    #
+    #    </note>
+    #
+    # @option params [Boolean] :kms_key_enable_geospatial_queries
+    #   Enables `GeospatialQueries` for a tracker that uses a [Amazon Web
+    #   Services KMS customer managed key][1].
+    #
+    #   This parameter is only used if you are using a KMS customer managed
+    #   key.
+    #
+    #   <note markdown="1"> If you wish to encrypt your data using your own KMS customer managed
+    #   key, then the Bounding Polygon Queries feature will be disabled by
+    #   default. This is because by using this feature, a representation of
+    #   your device positions will not be encrypted using the your KMS managed
+    #   key. The exact device position, however; is still encrypted using your
+    #   managed key.
+    #
+    #    You can choose to opt-in to the Bounding Polygon Quseries feature.
+    #   This is done by setting the `KmsKeyEnableGeospatialQueries` parameter
+    #   to true when creating or updating a Tracker.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
+    #
     # @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.
+    #   A key identifier for an [Amazon Web Services KMS customer managed
+    #   key][1]. Enter a key ID, key ARN, alias name, or alias ARN.
     #
     #
     #
@@ -1418,43 +1938,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
@@ -1500,9 +2002,11 @@ module Aws::LocationService
     #
     #   resp = client.create_tracker({
     #     description: "ResourceDescription",
+    #     event_bridge_enabled: false,
+    #     kms_key_enable_geospatial_queries: false,
     #     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",
@@ -1525,7 +2029,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Deletes a geofence collection from your AWS account.
+    # Deletes a geofence collection from your Amazon Web Services account.
     #
     # <note markdown="1"> This operation deletes the resource permanently. If the geofence
     # collection is the target of a tracker resource, the devices will no
@@ -1553,7 +2057,30 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Deletes a map resource from your AWS account.
+    # Deletes the specified API key. The API key must have been deactivated
+    # more than 90 days previously.
+    #
+    # @option params [required, String] :key_name
+    #   The name of the API key to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_key({
+    #     key_name: "ResourceName", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DeleteKey AWS API Documentation
+    #
+    # @overload delete_key(params = {})
+    # @param [Hash] params ({})
+    def delete_key(params = {}, options = {})
+      req = build_request(:delete_key, params)
+      req.send_request(options)
+    end
+
+    # Deletes a map resource from your Amazon Web Services account.
     #
     # <note markdown="1"> This operation deletes the resource permanently. If the map is being
     # used in an application, the map may not render.
@@ -1580,7 +2107,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Deletes a place index resource from your AWS account.
+    # Deletes a place index resource from your Amazon Web Services account.
     #
     # <note markdown="1"> This operation deletes the resource permanently.
     #
@@ -1606,7 +2133,8 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Deletes a route calculator resource from your AWS account.
+    # Deletes a route calculator resource from your Amazon Web Services
+    # account.
     #
     # <note markdown="1"> This operation deletes the resource permanently.
     #
@@ -1632,7 +2160,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Deletes a tracker resource from your AWS account.
+    # Deletes a tracker resource from your Amazon Web Services account.
     #
     # <note markdown="1"> This operation deletes the resource permanently. If the tracker
     # resource is in use, you may encounter an error. Make sure that the
@@ -1671,6 +2199,7 @@ module Aws::LocationService
     #   * {Types::DescribeGeofenceCollectionResponse#collection_name #collection_name} => String
     #   * {Types::DescribeGeofenceCollectionResponse#create_time #create_time} => Time
     #   * {Types::DescribeGeofenceCollectionResponse#description #description} => String
+    #   * {Types::DescribeGeofenceCollectionResponse#geofence_count #geofence_count} => Integer
     #   * {Types::DescribeGeofenceCollectionResponse#kms_key_id #kms_key_id} => String
     #   * {Types::DescribeGeofenceCollectionResponse#pricing_plan #pricing_plan} => String
     #   * {Types::DescribeGeofenceCollectionResponse#pricing_plan_data_source #pricing_plan_data_source} => String
@@ -1689,6 +2218,7 @@ module Aws::LocationService
     #   resp.collection_name #=> String
     #   resp.create_time #=> Time
     #   resp.description #=> String
+    #   resp.geofence_count #=> Integer
     #   resp.kms_key_id #=> String
     #   resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
     #   resp.pricing_plan_data_source #=> String
@@ -1705,6 +2235,56 @@ module Aws::LocationService
       req.send_request(options)
     end
 
+    # Retrieves the API key resource details.
+    #
+    # @option params [required, String] :key_name
+    #   The name of the API key resource.
+    #
+    # @return [Types::DescribeKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeKeyResponse#create_time #create_time} => Time
+    #   * {Types::DescribeKeyResponse#description #description} => String
+    #   * {Types::DescribeKeyResponse#expire_time #expire_time} => Time
+    #   * {Types::DescribeKeyResponse#key #key} => String
+    #   * {Types::DescribeKeyResponse#key_arn #key_arn} => String
+    #   * {Types::DescribeKeyResponse#key_name #key_name} => String
+    #   * {Types::DescribeKeyResponse#restrictions #restrictions} => Types::ApiKeyRestrictions
+    #   * {Types::DescribeKeyResponse#tags #tags} => Hash&lt;String,String&gt;
+    #   * {Types::DescribeKeyResponse#update_time #update_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_key({
+    #     key_name: "ResourceName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.create_time #=> Time
+    #   resp.description #=> String
+    #   resp.expire_time #=> Time
+    #   resp.key #=> String
+    #   resp.key_arn #=> String
+    #   resp.key_name #=> String
+    #   resp.restrictions.allow_actions #=> Array
+    #   resp.restrictions.allow_actions[0] #=> String
+    #   resp.restrictions.allow_referers #=> Array
+    #   resp.restrictions.allow_referers[0] #=> String
+    #   resp.restrictions.allow_resources #=> Array
+    #   resp.restrictions.allow_resources[0] #=> String
+    #   resp.tags #=> Hash
+    #   resp.tags["TagKey"] #=> String
+    #   resp.update_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DescribeKey AWS API Documentation
+    #
+    # @overload describe_key(params = {})
+    # @param [Hash] params ({})
+    def describe_key(params = {}, options = {})
+      req = build_request(:describe_key, params)
+      req.send_request(options)
+    end
+
     # Retrieves the map resource details.
     #
     # @option params [required, String] :map_name
@@ -1730,6 +2310,7 @@ module Aws::LocationService
     #
     # @example Response structure
     #
+    #   resp.configuration.political_view #=> String
     #   resp.configuration.style #=> String
     #   resp.create_time #=> Time
     #   resp.data_source #=> String
@@ -1847,6 +2428,8 @@ module Aws::LocationService
     #
     #   * {Types::DescribeTrackerResponse#create_time #create_time} => Time
     #   * {Types::DescribeTrackerResponse#description #description} => String
+    #   * {Types::DescribeTrackerResponse#event_bridge_enabled #event_bridge_enabled} => Boolean
+    #   * {Types::DescribeTrackerResponse#kms_key_enable_geospatial_queries #kms_key_enable_geospatial_queries} => Boolean
     #   * {Types::DescribeTrackerResponse#kms_key_id #kms_key_id} => String
     #   * {Types::DescribeTrackerResponse#position_filtering #position_filtering} => String
     #   * {Types::DescribeTrackerResponse#pricing_plan #pricing_plan} => String
@@ -1866,6 +2449,8 @@ module Aws::LocationService
     #
     #   resp.create_time #=> Time
     #   resp.description #=> String
+    #   resp.event_bridge_enabled #=> Boolean
+    #   resp.kms_key_enable_geospatial_queries #=> Boolean
     #   resp.kms_key_id #=> String
     #   resp.position_filtering #=> String, one of "TimeBased", "DistanceBased", "AccuracyBased"
     #   resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
@@ -1897,7 +2482,7 @@ module Aws::LocationService
     # @option params [required, String] :consumer_arn
     #   The Amazon Resource Name (ARN) for the geofence collection to be
     #   disassociated from the tracker resource. Used when you need to specify
-    #   a resource across all AWS.
+    #   a resource across all Amazon Web Services.
     #
     #   * Format example:
     #     `arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer`
@@ -1940,8 +2525,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 +2541,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
     #
@@ -1995,6 +2585,12 @@ module Aws::LocationService
     #
     #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
     #
+    # @option params [Integer] :max_results
+    #   An optional limit for the number of device positions returned in a
+    #   single call.
+    #
+    #   Default value: `100`
+    #
     # @option params [String] :next_token
     #   The pagination token specifying which page of results to return in the
     #   response. If no token is provided, the default page is the first page.
@@ -2033,6 +2629,7 @@ module Aws::LocationService
     #   resp = client.get_device_position_history({
     #     device_id: "Id", # required
     #     end_time_exclusive: Time.now,
+    #     max_results: 1,
     #     next_token: "Token",
     #     start_time_inclusive: Time.now,
     #     tracker_name: "ResourceName", # required
@@ -2041,9 +2638,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
@@ -2069,6 +2669,7 @@ module Aws::LocationService
     #
     #   * {Types::GetGeofenceResponse#create_time #create_time} => Time
     #   * {Types::GetGeofenceResponse#geofence_id #geofence_id} => String
+    #   * {Types::GetGeofenceResponse#geofence_properties #geofence_properties} => Hash&lt;String,String&gt;
     #   * {Types::GetGeofenceResponse#geometry #geometry} => Types::GeofenceGeometry
     #   * {Types::GetGeofenceResponse#status #status} => String
     #   * {Types::GetGeofenceResponse#update_time #update_time} => Time
@@ -2084,6 +2685,11 @@ module Aws::LocationService
     #
     #   resp.create_time #=> Time
     #   resp.geofence_id #=> String
+    #   resp.geofence_properties #=> Hash
+    #   resp.geofence_properties["PropertyMapKeyString"] #=> String
+    #   resp.geometry.circle.center #=> Array
+    #   resp.geometry.circle.center[0] #=> Float
+    #   resp.geometry.circle.radius #=> Float
     #   resp.geometry.polygon #=> Array
     #   resp.geometry.polygon[0] #=> Array
     #   resp.geometry.polygon[0][0] #=> Array
@@ -2106,7 +2712,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 stacks for [Esri][1] styles:
+    #   Valid font stacks for [Esri][1] styles:
     #
     #   * VectorEsriDarkGrayCanvas – `Ubuntu Medium Italic` \| `Ubuntu Medium`
     #     \| `Ubuntu Italic` \| `Ubuntu Regular` \| `Ubuntu Bold`
@@ -2126,14 +2732,51 @@ module Aws::LocationService
     #
     #   Valid font stacks for [HERE Technologies][2] styles:
     #
-    #   * VectorHereBerlin – `Fira GO Regular` \| `Fira GO Bold`
+    #   * VectorHereContrast – `Fira GO Regular` \| `Fira GO Bold`
+    #
+    #   * VectorHereExplore, VectorHereExploreTruck,
+    #     HybridHereExploreSatellite – `Fira GO Italic` \| `Fira GO Map` \|
+    #     `Fira GO Map Bold` \| `Noto Sans CJK JP Bold` \| `Noto Sans CJK JP
+    #     Light` \| `Noto Sans CJK JP Regular`
+    #
+    #   Valid font stacks for [GrabMaps][3] styles:
+    #
+    #   * VectorGrabStandardLight, VectorGrabStandardDark – `Noto Sans
+    #     Regular` \| `Noto Sans Medium` \| `Noto Sans Bold`
+    #
+    #   ^
+    #
+    #   Valid font stacks for [Open Data][4] styles:
+    #
+    #   * VectorOpenDataStandardLight, VectorOpenDataStandardDark,
+    #     VectorOpenDataVisualizationLight, VectorOpenDataVisualizationDark –
+    #     `Amazon Ember Regular,Noto Sans Regular` \| `Amazon Ember Bold,Noto
+    #     Sans Bold` \| `Amazon Ember Medium,Noto Sans Medium` \| `Amazon
+    #     Ember Regular Italic,Noto Sans Italic` \| `Amazon Ember Condensed RC
+    #     Regular,Noto Sans Regular` \| `Amazon Ember Condensed RC Bold,Noto
+    #     Sans Bold` \| `Amazon Ember Regular,Noto Sans Regular,Noto Sans
+    #     Arabic Regular` \| `Amazon Ember Condensed RC Bold,Noto Sans
+    #     Bold,Noto Sans Arabic Condensed Bold` \| `Amazon Ember Bold,Noto
+    #     Sans Bold,Noto Sans Arabic Bold` \| `Amazon Ember Regular
+    #     Italic,Noto Sans Italic,Noto Sans Arabic Regular` \| `Amazon Ember
+    #     Condensed RC Regular,Noto Sans Regular,Noto Sans Arabic Condensed
+    #     Regular` \| `Amazon Ember Medium,Noto Sans Medium,Noto Sans Arabic
+    #     Medium`
     #
     #   ^
     #
+    #   <note markdown="1"> The fonts used by the Open Data map styles are combined fonts that use
+    #   `Amazon Ember` for most glyphs but `Noto Sans` for glyphs unsupported
+    #   by `Amazon Ember`.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/esri.html
     #   [2]: https://docs.aws.amazon.com/location/latest/developerguide/HERE.html
+    #   [3]: https://docs.aws.amazon.com/location/latest/developerguide/grab.html
+    #   [4]: https://docs.aws.amazon.com/location/latest/developerguide/open-data.html
     #
     # @option params [required, String] :font_unicode_range
     #   A Unicode range of characters to download glyphs for. Each response
@@ -2141,12 +2784,20 @@ module Aws::LocationService
     #   characters from range `U+0000` to `00FF`. Must be aligned to multiples
     #   of 256.
     #
+    # @option params [String] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @option params [required, String] :map_name
     #   The map resource associated with the glyph file.
     #
     # @return [Types::GetMapGlyphsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetMapGlyphsResponse#blob #blob} => IO
+    #   * {Types::GetMapGlyphsResponse#cache_control #cache_control} => String
     #   * {Types::GetMapGlyphsResponse#content_type #content_type} => String
     #
     # @example Request syntax with placeholder values
@@ -2154,12 +2805,14 @@ module Aws::LocationService
     #   resp = client.get_map_glyphs({
     #     font_stack: "String", # required
     #     font_unicode_range: "GetMapGlyphsRequestFontUnicodeRangeString", # required
+    #     key: "ApiKey",
     #     map_name: "ResourceName", # required
     #   })
     #
     # @example Response structure
     #
     #   resp.blob #=> IO
+    #   resp.cache_control #=> String
     #   resp.content_type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetMapGlyphs AWS API Documentation
@@ -2183,31 +2836,41 @@ module Aws::LocationService
     #
     #   * `sprites@2x.png` for high pixel density displays
     #
-    #   For the JSON document contain image offsets. Use the following file
+    #   For the JSON document containing image offsets. Use the following file
     #   names:
     #
     #   * `sprites.json`
     #
     #   * `sprites@2x.json` for high pixel density displays
     #
+    # @option params [String] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @option params [required, String] :map_name
     #   The map resource associated with the sprite file.
     #
     # @return [Types::GetMapSpritesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetMapSpritesResponse#blob #blob} => IO
+    #   * {Types::GetMapSpritesResponse#cache_control #cache_control} => String
     #   * {Types::GetMapSpritesResponse#content_type #content_type} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_map_sprites({
     #     file_name: "GetMapSpritesRequestFileNameString", # required
+    #     key: "ApiKey",
     #     map_name: "ResourceName", # required
     #   })
     #
     # @example Response structure
     #
     #   resp.blob #=> IO
+    #   resp.cache_control #=> String
     #   resp.content_type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetMapSprites AWS API Documentation
@@ -2226,23 +2889,33 @@ module Aws::LocationService
     # data in, and the style for the data. Style descriptors follow the
     # Mapbox Style Specification.
     #
+    # @option params [String] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @option params [required, String] :map_name
     #   The map resource to retrieve the style descriptor from.
     #
     # @return [Types::GetMapStyleDescriptorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetMapStyleDescriptorResponse#blob #blob} => IO
+    #   * {Types::GetMapStyleDescriptorResponse#cache_control #cache_control} => String
     #   * {Types::GetMapStyleDescriptorResponse#content_type #content_type} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_map_style_descriptor({
+    #     key: "ApiKey",
     #     map_name: "ResourceName", # required
     #   })
     #
     # @example Response structure
     #
     #   resp.blob #=> IO
+    #   resp.cache_control #=> String
     #   resp.content_type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetMapStyleDescriptor AWS API Documentation
@@ -2263,6 +2936,13 @@ module Aws::LocationService
     # data for the entire world at (0/0/0) will be split into 4 tiles at
     # zoom 1 (1/0/0, 1/0/1, 1/1/0, 1/1/1).
     #
+    # @option params [String] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @option params [required, String] :map_name
     #   The map resource to retrieve the map tiles from.
     #
@@ -2278,11 +2958,13 @@ module Aws::LocationService
     # @return [Types::GetMapTileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetMapTileResponse#blob #blob} => IO
+    #   * {Types::GetMapTileResponse#cache_control #cache_control} => String
     #   * {Types::GetMapTileResponse#content_type #content_type} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_map_tile({
+    #     key: "ApiKey",
     #     map_name: "ResourceName", # required
     #     x: "GetMapTileRequestXString", # required
     #     y: "GetMapTileRequestYString", # required
@@ -2292,6 +2974,7 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.blob #=> IO
+    #   resp.cache_control #=> String
     #   resp.content_type #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetMapTile AWS API Documentation
@@ -2303,43 +2986,153 @@ module Aws::LocationService
       req.send_request(options, &block)
     end
 
-    # A batch request to retrieve all device positions.
+    # Finds a place by its unique ID. A `PlaceId` is returned by other
+    # search operations.
     #
-    # @option params [Integer] :max_results
-    #   An optional limit for the number of entries returned in a single call.
+    # <note markdown="1"> A PlaceId is valid only if all of the following are the same in the
+    # original search request and the call to `GetPlace`.
     #
-    #   Default value: `100`
+    #  * Customer Amazon Web Services account
     #
-    # @option params [String] :next_token
-    #   The pagination token specifying which page of results to return in the
-    #   response. If no token is provided, the default page is the first page.
+    # * Amazon Web Services Region
     #
-    #   Default value: `null`
+    # * Data provider specified in the place index resource
     #
-    # @option params [required, String] :tracker_name
-    #   The tracker resource containing the requested devices.
+    #  </note>
     #
-    # @return [Types::ListDevicePositionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    # @option params [required, String] :index_name
+    #   The name of the place index resource that you want to use for the
+    #   search.
     #
-    #   * {Types::ListDevicePositionsResponse#entries #data.entries} => Array&lt;Types::ListDevicePositionsResponseEntry&gt; (This method conflicts with a method on Response, call it through the data member)
-    #   * {Types::ListDevicePositionsResponse#next_token #next_token} => String
+    # @option params [String] :key
+    #   The optional [API key][1] to authorize the request.
     #
-    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
+    # @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, but not the
+    #   results themselves. If no language is specified, or not supported for
+    #   a particular result, the partner automatically chooses a language for
+    #   the result.
+    #
+    #   For an example, we'll use the Greek language. You search for a
+    #   location around Athens, Greece, with the `language` parameter set to
+    #   `en`. The `city` in the results will most likely be returned as
+    #   `Athens`.
+    #
+    #   If you set the `language` parameter to `el`, for Greek, then the
+    #   `city` in the results will more likely be returned as `Αθήνα`.
+    #
+    #   If the data provider does not have a value for Greek, the result will
+    #   be in a language that the provider does support.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/search/bcp47
+    #
+    # @option params [required, String] :place_id
+    #   The identifier of the place to find.
+    #
+    # @return [Types::GetPlaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetPlaceResponse#place #place} => Types::Place
     #
     # @example Request syntax with placeholder values
     #
-    #   resp = client.list_device_positions({
-    #     max_results: 1,
-    #     next_token: "Token",
-    #     tracker_name: "ResourceName", # required
+    #   resp = client.get_place({
+    #     index_name: "ResourceName", # required
+    #     key: "ApiKey",
+    #     language: "LanguageTag",
+    #     place_id: "PlaceId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.place.address_number #=> String
+    #   resp.place.categories #=> Array
+    #   resp.place.categories[0] #=> String
+    #   resp.place.country #=> String
+    #   resp.place.geometry.point #=> Array
+    #   resp.place.geometry.point[0] #=> Float
+    #   resp.place.interpolated #=> Boolean
+    #   resp.place.label #=> String
+    #   resp.place.municipality #=> String
+    #   resp.place.neighborhood #=> String
+    #   resp.place.postal_code #=> String
+    #   resp.place.region #=> String
+    #   resp.place.street #=> String
+    #   resp.place.sub_region #=> String
+    #   resp.place.supplemental_categories #=> Array
+    #   resp.place.supplemental_categories[0] #=> String
+    #   resp.place.time_zone.name #=> String
+    #   resp.place.time_zone.offset #=> Integer
+    #   resp.place.unit_number #=> String
+    #   resp.place.unit_type #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetPlace AWS API Documentation
+    #
+    # @overload get_place(params = {})
+    # @param [Hash] params ({})
+    def get_place(params = {}, options = {})
+      req = build_request(:get_place, params)
+      req.send_request(options)
+    end
+
+    # A batch request to retrieve all device positions.
+    #
+    # @option params [Types::TrackingFilterGeometry] :filter_geometry
+    #   The geomerty used to filter device positions.
+    #
+    # @option params [Integer] :max_results
+    #   An optional limit for the number of entries returned in a single call.
+    #
+    #   Default value: `100`
+    #
+    # @option params [String] :next_token
+    #   The pagination token specifying which page of results to return in the
+    #   response. If no token is provided, the default page is the first page.
+    #
+    #   Default value: `null`
+    #
+    # @option params [required, String] :tracker_name
+    #   The tracker resource containing the requested devices.
+    #
+    # @return [Types::ListDevicePositionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDevicePositionsResponse#entries #data.entries} => Array&lt;Types::ListDevicePositionsResponseEntry&gt; (This method conflicts with a method on Response, call it through the data member)
+    #   * {Types::ListDevicePositionsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_device_positions({
+    #     filter_geometry: {
+    #       polygon: [
+    #         [
+    #           [1.0],
+    #         ],
+    #       ],
+    #     },
+    #     max_results: 1,
+    #     next_token: "Token",
+    #     tracker_name: "ResourceName", # required
     #   })
     #
     # @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
     #
@@ -2352,7 +3145,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Lists geofence collections in your AWS account.
+    # Lists geofence collections in your Amazon Web Services account.
     #
     # @option params [Integer] :max_results
     #   An optional limit for the number of resources returned in a single
@@ -2405,6 +3198,12 @@ module Aws::LocationService
     # @option params [required, String] :collection_name
     #   The name of the geofence collection storing the list of geofences.
     #
+    # @option params [Integer] :max_results
+    #   An optional limit for the number of geofences returned in a single
+    #   call.
+    #
+    #   Default value: `100`
+    #
     # @option params [String] :next_token
     #   The pagination token specifying which page of results to return in the
     #   response. If no token is provided, the default page is the first page.
@@ -2422,6 +3221,7 @@ module Aws::LocationService
     #
     #   resp = client.list_geofences({
     #     collection_name: "ResourceName", # required
+    #     max_results: 1,
     #     next_token: "Token",
     #   })
     #
@@ -2430,6 +3230,11 @@ module Aws::LocationService
     #   resp.data.entries #=> Array
     #   resp.data.entries[0].create_time #=> Time
     #   resp.data.entries[0].geofence_id #=> String
+    #   resp.data.entries[0].geofence_properties #=> Hash
+    #   resp.data.entries[0].geofence_properties["PropertyMapKeyString"] #=> String
+    #   resp.data.entries[0].geometry.circle.center #=> Array
+    #   resp.data.entries[0].geometry.circle.center[0] #=> Float
+    #   resp.data.entries[0].geometry.circle.radius #=> Float
     #   resp.data.entries[0].geometry.polygon #=> Array
     #   resp.data.entries[0].geometry.polygon[0] #=> Array
     #   resp.data.entries[0].geometry.polygon[0][0] #=> Array
@@ -2447,7 +3252,66 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Lists map resources in your AWS account.
+    # Lists API key resources in your Amazon Web Services account.
+    #
+    # @option params [Types::ApiKeyFilter] :filter
+    #   Optionally filter the list to only `Active` or `Expired` API keys.
+    #
+    # @option params [Integer] :max_results
+    #   An optional limit for the number of resources returned in a single
+    #   call.
+    #
+    #   Default value: `100`
+    #
+    # @option params [String] :next_token
+    #   The pagination token specifying which page of results to return in the
+    #   response. If no token is provided, the default page is the first page.
+    #
+    #   Default value: `null`
+    #
+    # @return [Types::ListKeysResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListKeysResponse#entries #data.entries} => Array&lt;Types::ListKeysResponseEntry&gt; (This method conflicts with a method on Response, call it through the data member)
+    #   * {Types::ListKeysResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_keys({
+    #     filter: {
+    #       key_status: "Active", # accepts Active, Expired
+    #     },
+    #     max_results: 1,
+    #     next_token: "Token",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.data.entries #=> Array
+    #   resp.data.entries[0].create_time #=> Time
+    #   resp.data.entries[0].description #=> String
+    #   resp.data.entries[0].expire_time #=> Time
+    #   resp.data.entries[0].key_name #=> String
+    #   resp.data.entries[0].restrictions.allow_actions #=> Array
+    #   resp.data.entries[0].restrictions.allow_actions[0] #=> String
+    #   resp.data.entries[0].restrictions.allow_referers #=> Array
+    #   resp.data.entries[0].restrictions.allow_referers[0] #=> String
+    #   resp.data.entries[0].restrictions.allow_resources #=> Array
+    #   resp.data.entries[0].restrictions.allow_resources[0] #=> String
+    #   resp.data.entries[0].update_time #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/ListKeys AWS API Documentation
+    #
+    # @overload list_keys(params = {})
+    # @param [Hash] params ({})
+    def list_keys(params = {}, options = {})
+      req = build_request(:list_keys, params)
+      req.send_request(options)
+    end
+
+    # Lists map resources in your Amazon Web Services account.
     #
     # @option params [Integer] :max_results
     #   An optional limit for the number of resources returned in a single
@@ -2495,7 +3359,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Lists place index resources in your AWS account.
+    # Lists place index resources in your Amazon Web Services account.
     #
     # @option params [Integer] :max_results
     #   An optional limit for the maximum number of results returned in a
@@ -2543,7 +3407,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Lists route calculator resources in your AWS account.
+    # Lists route calculator resources in your Amazon Web Services account.
     #
     # @option params [Integer] :max_results
     #   An optional maximum number of results returned in a single call.
@@ -2675,7 +3539,7 @@ module Aws::LocationService
       req.send_request(options)
     end
 
-    # Lists tracker resources in your AWS account.
+    # Lists tracker resources in your Amazon Web Services account.
     #
     # @option params [Integer] :max_results
     #   An optional limit for the number of resources returned in a single
@@ -2733,10 +3597,19 @@ module Aws::LocationService
     # @option params [required, String] :geofence_id
     #   An identifier for the geofence. For example, `ExampleGeofence-1`.
     #
+    # @option params [Hash<String,String>] :geofence_properties
+    #   Associates one of more properties with the geofence. A property is a
+    #   key-value pair stored with the geofence and added to any geofence
+    #   event triggered with that geofence.
+    #
+    #   Format: `"key" : "value"`
+    #
     # @option params [required, Types::GeofenceGeometry] :geometry
-    #   Contains the polygon details to specify the position of the geofence.
+    #   Contains the details to specify the position of the geofence. Can be
+    #   either a polygon or a circle. Including both will return a validation
+    #   error.
     #
-    #   <note markdown="1"> Each [geofence polygon][1] can have a maximum of 1,000 vertices.
+    #   <note markdown="1"> Each [ geofence polygon][1] can have a maximum of 1,000 vertices.
     #
     #    </note>
     #
@@ -2755,7 +3628,14 @@ module Aws::LocationService
     #   resp = client.put_geofence({
     #     collection_name: "ResourceName", # required
     #     geofence_id: "Id", # required
+    #     geofence_properties: {
+    #       "PropertyMapKeyString" => "PropertyMapValueString",
+    #     },
     #     geometry: { # required
+    #       circle: {
+    #         center: [1.0], # required
+    #         radius: 1.0, # required
+    #       },
     #       polygon: [
     #         [
     #           [1.0],
@@ -2786,14 +3666,32 @@ 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] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @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.
+    #   This setting affects the languages used in the results, but not the
+    #   results themselves. If no language is specified, or not supported for
+    #   a particular result, the partner automatically chooses a language for
+    #   the result.
+    #
+    #   For an example, we'll use the Greek language. You search for a
+    #   location around Athens, Greece, with the `language` parameter set to
+    #   `en`. The `city` in the results will most likely be returned as
+    #   `Athens`.
+    #
+    #   If you set the `language` parameter to `el`, for Greek, then the
+    #   `city` in the results will more likely be returned as `Αθήνα`.
+    #
+    #   If the data provider does not have a value for Greek, the result will
+    #   be in a language that the provider does support.
     #
     #
     #
@@ -2824,6 +3722,7 @@ module Aws::LocationService
     #
     #   resp = client.search_place_index_for_position({
     #     index_name: "ResourceName", # required
+    #     key: "ApiKey",
     #     language: "LanguageTag",
     #     max_results: 1,
     #     position: [1.0], # required
@@ -2834,6 +3733,8 @@ module Aws::LocationService
     #   resp.results #=> Array
     #   resp.results[0].distance #=> Float
     #   resp.results[0].place.address_number #=> String
+    #   resp.results[0].place.categories #=> Array
+    #   resp.results[0].place.categories[0] #=> String
     #   resp.results[0].place.country #=> String
     #   resp.results[0].place.geometry.point #=> Array
     #   resp.results[0].place.geometry.point[0] #=> Float
@@ -2845,8 +3746,13 @@ 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.supplemental_categories #=> Array
+    #   resp.results[0].place.supplemental_categories[0] #=> String
     #   resp.results[0].place.time_zone.name #=> String
     #   resp.results[0].place.time_zone.offset #=> Integer
+    #   resp.results[0].place.unit_number #=> String
+    #   resp.results[0].place.unit_type #=> String
+    #   resp.results[0].place_id #=> String
     #   resp.summary.data_source #=> String
     #   resp.summary.language #=> String
     #   resp.summary.max_results #=> Integer
@@ -2862,6 +3768,176 @@ 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_categories
+    #   A list of one or more Amazon Location categories to filter the
+    #   returned places. If you include more than one category, the results
+    #   will include results that match *any* of the categories listed.
+    #
+    #   For more information about using categories, including a list of
+    #   Amazon Location categories, see [Categories and filtering][1], in the
+    #   *Amazon Location Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/category-filtering.html
+    #
+    # @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] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
+    # @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. If no language
+    #   is specified, or not supported for a particular result, the partner
+    #   automatically chooses a language for the result.
+    #
+    #   For an example, we'll use the Greek language. You search for `Athens,
+    #   Gr` to get suggestions with the `language` parameter set to `en`. The
+    #   results found will most likely be returned as `Athens, Greece`.
+    #
+    #   If you set the `language` parameter to `el`, for Greek, then the
+    #   result found will more likely be returned as `Αθήνα, Ελλάδα`.
+    #
+    #   If the data provider does not have a value for Greek, the result will
+    #   be in a language that the provider does support.
+    #
+    #
+    #
+    #   [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_categories: ["PlaceCategory"],
+    #     filter_countries: ["CountryCode"],
+    #     index_name: "ResourceName", # required
+    #     key: "ApiKey",
+    #     language: "LanguageTag",
+    #     max_results: 1,
+    #     text: "SearchPlaceIndexForSuggestionsRequestTextString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.results #=> Array
+    #   resp.results[0].categories #=> Array
+    #   resp.results[0].categories[0] #=> String
+    #   resp.results[0].place_id #=> String
+    #   resp.results[0].supplemental_categories #=> Array
+    #   resp.results[0].supplemental_categories[0] #=> String
+    #   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_categories #=> Array
+    #   resp.summary.filter_categories[0] #=> String
+    #   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.
     #
@@ -2914,6 +3990,19 @@ module Aws::LocationService
     #
     #    </note>
     #
+    # @option params [Array<String>] :filter_categories
+    #   A list of one or more Amazon Location categories to filter the
+    #   returned places. If you include more than one category, the results
+    #   will include results that match *any* of the categories listed.
+    #
+    #   For more information about using categories, including a list of
+    #   Amazon Location categories, see [Categories and filtering][1], in the
+    #   *Amazon Location Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/category-filtering.html
+    #
     # @option params [Array<String>] :filter_countries
     #   An optional parameter that limits the search results by returning only
     #   places that are in a specified list of countries.
@@ -2930,14 +4019,31 @@ 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] :key
+    #   The optional [API key][1] to authorize the request.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html
+    #
     # @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.
+    #   This setting affects the languages used in the results, but not the
+    #   results themselves. If no language is specified, or not supported for
+    #   a particular result, the partner automatically chooses a language for
+    #   the result.
+    #
+    #   For an example, we'll use the Greek language. You search for `Athens,
+    #   Greece`, with the `language` parameter set to `en`. The result found
+    #   will most likely be returned as `Athens`.
+    #
+    #   If you set the `language` parameter to `el`, for Greek, then the
+    #   result found will more likely be returned as `Αθήνα`.
+    #
+    #   If the data provider does not have a value for Greek, the result will
+    #   be in a language that the provider does support.
     #
     #
     #
@@ -2963,11 +4069,13 @@ module Aws::LocationService
     #   resp = client.search_place_index_for_text({
     #     bias_position: [1.0],
     #     filter_b_box: [1.0],
+    #     filter_categories: ["PlaceCategory"],
     #     filter_countries: ["CountryCode"],
     #     index_name: "ResourceName", # required
+    #     key: "ApiKey",
     #     language: "LanguageTag",
     #     max_results: 1,
-    #     text: "SyntheticSearchPlaceIndexForTextRequestString", # required
+    #     text: "SearchPlaceIndexForTextRequestTextString", # required
     #   })
     #
     # @example Response structure
@@ -2975,6 +4083,8 @@ module Aws::LocationService
     #   resp.results #=> Array
     #   resp.results[0].distance #=> Float
     #   resp.results[0].place.address_number #=> String
+    #   resp.results[0].place.categories #=> Array
+    #   resp.results[0].place.categories[0] #=> String
     #   resp.results[0].place.country #=> String
     #   resp.results[0].place.geometry.point #=> Array
     #   resp.results[0].place.geometry.point[0] #=> Float
@@ -2986,14 +4096,21 @@ 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.supplemental_categories #=> Array
+    #   resp.results[0].place.supplemental_categories[0] #=> String
     #   resp.results[0].place.time_zone.name #=> String
     #   resp.results[0].place.time_zone.offset #=> Integer
+    #   resp.results[0].place.unit_number #=> String
+    #   resp.results[0].place.unit_type #=> String
+    #   resp.results[0].place_id #=> String
     #   resp.results[0].relevance #=> Float
     #   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_categories #=> Array
+    #   resp.summary.filter_categories[0] #=> String
     #   resp.summary.filter_countries #=> Array
     #   resp.summary.filter_countries[0] #=> String
     #   resp.summary.language #=> String
@@ -3014,7 +4131,18 @@ module Aws::LocationService
     # Assigns one or more tags (key-value pairs) to the specified Amazon
     # Location Service resource.
     #
-    #      <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with certain tag values.</p> <p>You can use the <code>TagResource</code> operation with an Amazon Location Service resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the tags already associated with the resource. If you specify a tag key that's already associated with the resource, the new tag value that you specify replaces the previous value for that tag. </p> <p>You can associate up to 50 tags with a resource.</p>
+    # Tags can help you organize and categorize your resources. You can also
+    # use them to scope user permissions, by granting a user permission to
+    # access or change only resources with certain tag values.
+    #
+    # You can use the `TagResource` operation with an Amazon Location
+    # Service resource that already has tags. If you specify a new tag key
+    # for the resource, this tag is appended to the tags already associated
+    # with the resource. If you specify a tag key that's already associated
+    # with the resource, the new tag value that you specify replaces the
+    # previous value for that tag.
+    #
+    # You can associate up to 50 tags with a resource.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the resource whose tags you want to
@@ -3109,38 +4237,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:
     #
@@ -3172,8 +4273,82 @@ module Aws::LocationService
       req.send_request(options)
     end
 
+    # Updates the specified properties of a given API key resource.
+    #
+    # @option params [String] :description
+    #   Updates the description for the API key resource.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :expire_time
+    #   Updates the timestamp for when the API key resource will expire in [
+    #   ISO 8601][1] format: `YYYY-MM-DDThh:mm:ss.sssZ`.
+    #
+    #
+    #
+    #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
+    #
+    # @option params [Boolean] :force_update
+    #   The boolean flag to be included for updating `ExpireTime` or
+    #   `Restrictions` details.
+    #
+    #   Must be set to `true` to update an API key resource that has been used
+    #   in the past 7 days.
+    #
+    #   `False` if force update is not preferred
+    #
+    #   Default value: `False`
+    #
+    # @option params [required, String] :key_name
+    #   The name of the API key resource to update.
+    #
+    # @option params [Boolean] :no_expiry
+    #   Whether the API key should expire. Set to `true` to set the API key to
+    #   have no expiration time.
+    #
+    # @option params [Types::ApiKeyRestrictions] :restrictions
+    #   Updates the API key restrictions for the API key resource.
+    #
+    # @return [Types::UpdateKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateKeyResponse#key_arn #key_arn} => String
+    #   * {Types::UpdateKeyResponse#key_name #key_name} => String
+    #   * {Types::UpdateKeyResponse#update_time #update_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_key({
+    #     description: "ResourceDescription",
+    #     expire_time: Time.now,
+    #     force_update: false,
+    #     key_name: "ResourceName", # required
+    #     no_expiry: false,
+    #     restrictions: {
+    #       allow_actions: ["ApiKeyAction"], # required
+    #       allow_referers: ["RefererPattern"],
+    #       allow_resources: ["GeoArn"], # required
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.key_arn #=> String
+    #   resp.key_name #=> String
+    #   resp.update_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/UpdateKey AWS API Documentation
+    #
+    # @overload update_key(params = {})
+    # @param [Hash] params ({})
+    def update_key(params = {}, options = {})
+      req = build_request(:update_key, params)
+      req.send_request(options)
+    end
+
     # Updates the specified properties of a given map resource.
     #
+    # @option params [Types::MapConfigurationUpdate] :configuration_update
+    #   Updates the parts of the map configuration that can be updated,
+    #   including the political view.
+    #
     # @option params [String] :description
     #   Updates the description for the map resource.
     #
@@ -3181,14 +4356,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:
     #
@@ -3199,6 +4368,9 @@ module Aws::LocationService
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_map({
+    #     configuration_update: {
+    #       political_view: "CountryCode3OrEmpty",
+    #     },
     #     description: "ResourceDescription",
     #     map_name: "ResourceName", # required
     #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
@@ -3231,14 +4403,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 +4448,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:
     #
@@ -3325,6 +4485,27 @@ module Aws::LocationService
     # @option params [String] :description
     #   Updates the description for the tracker resource.
     #
+    # @option params [Boolean] :event_bridge_enabled
+    #   Whether to enable position `UPDATE` events from this tracker to be
+    #   sent to EventBridge.
+    #
+    #   <note markdown="1"> You do not need enable this feature to get `ENTER` and `EXIT` events
+    #   for geofences with this tracker. Those events are always sent to
+    #   EventBridge.
+    #
+    #    </note>
+    #
+    # @option params [Boolean] :kms_key_enable_geospatial_queries
+    #   Enables `GeospatialQueries` for a tracker that uses a [Amazon Web
+    #   Services KMS customer managed key][1].
+    #
+    #   This parameter is only used if you are using a KMS customer managed
+    #   key.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
+    #
     # @option params [String] :position_filtering
     #   Updates the position filtering for the tracker resource.
     #
@@ -3339,43 +4520,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.
@@ -3390,6 +4554,8 @@ module Aws::LocationService
     #
     #   resp = client.update_tracker({
     #     description: "ResourceDescription",
+    #     event_bridge_enabled: false,
+    #     kms_key_enable_geospatial_queries: false,
     #     position_filtering: "TimeBased", # accepts TimeBased, DistanceBased, AccuracyBased
     #     pricing_plan: "RequestBasedUsage", # accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
     #     pricing_plan_data_source: "String",
@@ -3424,7 +4590,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.13.0'
+      context[:gem_version] = '1.39.0'
       Seahorse::Client::Request.new(handlers, context)
     end