aws-sdk-locationservice 1.20.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f57fb3d98a3fd7344d1aad96040808c19a48ddff4ba87060efddf025bcad44bf
-  data.tar.gz: 104a5fcd3d8ccbd030f87e9a2f9ee740aceae4608741857b92f9c26e26c6c3f8
+  metadata.gz: 5f9baf3628589cb756d9e91dc23595a6456e14efb5344d2f01415bbdf27f3096
+  data.tar.gz: 330e97f7b16b30e5fc8dc01f657f57810078b5c022e09b615d96066cc486024e
 SHA512:
-  metadata.gz: 825a0cf329d4664a34cb9e9d1b86832726764f4127370cfa3be93e0414402a82cbb58d71ef51c5138dabf159e701c50618535c4b372c9897389ace1896739c11
-  data.tar.gz: 0e2480ec974bf2bd142ee159290463fb2a52ccb3ad7b877c259484119b9726465c0f7dcd43383a14151ba163cfcebe82bff0fc5761d504abfded54291373f0cc
+  metadata.gz: d538941a32333bb81fa609e42d527cbd8de09ed150e523469300a4f82624c24557a7b909d361e4aebddfbb879ced104dfc673e0178f62bf73967e9bcaa50355b
+  data.tar.gz: 1a5d4301ba00d91853eaf2fb86bead0aa9a5a768e861f431532964c2052827ab9ee394fca146c53f822d26886d689d01320ded6fcd84e2d423c1571b9e20d480

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.23.0 (2022-08-09)
+------------------
+
+* Feature - Amazon Location Service now allows circular geofences in BatchPutGeofence, PutGeofence, and GetGeofence  APIs.
+
+1.22.0 (2022-05-06)
+------------------
+
+* Feature - Amazon Location Service now includes a MaxResults parameter for ListGeofences requests.
+
+1.21.0 (2022-03-22)
+------------------
+
+* Feature - Amazon Location Service now includes a MaxResults parameter for GetDevicePositionHistory requests.
+
 1.20.0 (2022-03-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.20.0
+1.23.0

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

@@ -500,6 +500,11 @@ module Aws::LocationService
     #
     #  </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.
@@ -621,6 +626,10 @@ module Aws::LocationService
     #       {
     #         geofence_id: "Id", # required
     #         geometry: { # required
+    #           circle: {
+    #             center: [1.0], # required
+    #             radius: 1.0, # required
+    #           },
     #           polygon: [
     #             [
     #               [1.0],
@@ -750,6 +759,11 @@ module Aws::LocationService
     #   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
@@ -777,8 +791,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]`
     #
@@ -795,7 +809,7 @@ module Aws::LocationService
     #
     #
     #
-    #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
+    #   [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
@@ -818,8 +832,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]`
     #
@@ -834,7 +848,7 @@ module Aws::LocationService
     #
     #
     #
-    #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
+    #   [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
@@ -852,7 +866,8 @@ module Aws::LocationService
     #
     # @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`, or `Walking` as options for the `TravelMode`.
     #
     #   The `TravelMode` you specify also determines how you specify route
     #   preferences:
@@ -2243,6 +2258,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.
@@ -2281,6 +2302,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
@@ -2335,6 +2357,9 @@ module Aws::LocationService
     #
     #   resp.create_time #=> Time
     #   resp.geofence_id #=> 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
@@ -2377,7 +2402,7 @@ 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 – `Firo GO Italic` \|
     #     `Fira GO Map` \| `Fira GO Map Bold` \| `Noto Sans CJK JP Bold` \|
@@ -2661,6 +2686,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.
@@ -2678,6 +2709,7 @@ module Aws::LocationService
     #
     #   resp = client.list_geofences({
     #     collection_name: "ResourceName", # required
+    #     max_results: 1,
     #     next_token: "Token",
     #   })
     #
@@ -2686,6 +2718,9 @@ 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].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
@@ -2990,9 +3025,11 @@ module Aws::LocationService
     #   An identifier for the geofence. For example, `ExampleGeofence-1`.
     #
     # @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>
     #
@@ -3012,6 +3049,10 @@ module Aws::LocationService
     #     collection_name: "ResourceName", # required
     #     geofence_id: "Id", # required
     #     geometry: { # required
+    #       circle: {
+    #         center: [1.0], # required
+    #         radius: 1.0, # required
+    #       },
     #       polygon: [
     #         [
     #           [1.0],
@@ -3046,10 +3087,21 @@ module Aws::LocationService
     #   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.
     #
     #
     #
@@ -3190,12 +3242,19 @@ module Aws::LocationService
     #   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. 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 `Αθήνα, Ελλάδα`.
     #
-    #   Used only when the partner selected is Here.
+    #   If the data provider does not have a value for Greek, the result will
+    #   be in a language that the provider does support.
     #
     #
     #
@@ -3225,7 +3284,7 @@ module Aws::LocationService
     #     index_name: "ResourceName", # required
     #     language: "LanguageTag",
     #     max_results: 1,
-    #     text: "SyntheticSearchPlaceIndexForSuggestionsRequestString", # required
+    #     text: "SearchPlaceIndexForSuggestionsRequestTextString", # required
     #   })
     #
     # @example Response structure
@@ -3324,10 +3383,20 @@ module Aws::LocationService
     #   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.
     #
     #
     #
@@ -3357,7 +3426,7 @@ module Aws::LocationService
     #     index_name: "ResourceName", # required
     #     language: "LanguageTag",
     #     max_results: 1,
-    #     text: "SyntheticSearchPlaceIndexForTextRequestString", # required
+    #     text: "SearchPlaceIndexForTextRequestTextString", # required
     #   })
     #
     # @example Response structure
@@ -3752,7 +3821,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.20.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -74,6 +74,7 @@ module Aws::LocationService
     CalculateRouteSummaryDistanceDouble = Shapes::FloatShape.new(name: 'CalculateRouteSummaryDistanceDouble')
     CalculateRouteSummaryDurationSecondsDouble = Shapes::FloatShape.new(name: 'CalculateRouteSummaryDurationSecondsDouble')
     CalculateRouteTruckModeOptions = Shapes::StructureShape.new(name: 'CalculateRouteTruckModeOptions')
+    Circle = Shapes::StructureShape.new(name: 'Circle')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     CountryCode = Shapes::StringShape.new(name: 'CountryCode')
     CountryCodeList = Shapes::ListShape.new(name: 'CountryCodeList')
@@ -118,6 +119,7 @@ module Aws::LocationService
     Double = Shapes::FloatShape.new(name: 'Double')
     GeofenceGeometry = Shapes::StructureShape.new(name: 'GeofenceGeometry')
     GetDevicePositionHistoryRequest = Shapes::StructureShape.new(name: 'GetDevicePositionHistoryRequest')
+    GetDevicePositionHistoryRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'GetDevicePositionHistoryRequestMaxResultsInteger')
     GetDevicePositionHistoryResponse = Shapes::StructureShape.new(name: 'GetDevicePositionHistoryResponse')
     GetDevicePositionRequest = Shapes::StructureShape.new(name: 'GetDevicePositionRequest')
     GetDevicePositionResponse = Shapes::StructureShape.new(name: 'GetDevicePositionResponse')
@@ -163,6 +165,7 @@ module Aws::LocationService
     ListGeofenceResponseEntry = Shapes::StructureShape.new(name: 'ListGeofenceResponseEntry')
     ListGeofenceResponseEntryList = Shapes::ListShape.new(name: 'ListGeofenceResponseEntryList')
     ListGeofencesRequest = Shapes::StructureShape.new(name: 'ListGeofencesRequest')
+    ListGeofencesRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'ListGeofencesRequestMaxResultsInteger')
     ListGeofencesResponse = Shapes::StructureShape.new(name: 'ListGeofencesResponse')
     ListMapsRequest = Shapes::StructureShape.new(name: 'ListMapsRequest')
     ListMapsRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'ListMapsRequestMaxResultsInteger')
@@ -228,11 +231,14 @@ module Aws::LocationService
     SearchPlaceIndexForPositionSummary = Shapes::StructureShape.new(name: 'SearchPlaceIndexForPositionSummary')
     SearchPlaceIndexForSuggestionsRequest = Shapes::StructureShape.new(name: 'SearchPlaceIndexForSuggestionsRequest')
     SearchPlaceIndexForSuggestionsRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'SearchPlaceIndexForSuggestionsRequestMaxResultsInteger')
+    SearchPlaceIndexForSuggestionsRequestTextString = Shapes::StringShape.new(name: 'SearchPlaceIndexForSuggestionsRequestTextString')
     SearchPlaceIndexForSuggestionsResponse = Shapes::StructureShape.new(name: 'SearchPlaceIndexForSuggestionsResponse')
     SearchPlaceIndexForSuggestionsSummary = Shapes::StructureShape.new(name: 'SearchPlaceIndexForSuggestionsSummary')
     SearchPlaceIndexForTextRequest = Shapes::StructureShape.new(name: 'SearchPlaceIndexForTextRequest')
+    SearchPlaceIndexForTextRequestTextString = Shapes::StringShape.new(name: 'SearchPlaceIndexForTextRequestTextString')
     SearchPlaceIndexForTextResponse = Shapes::StructureShape.new(name: 'SearchPlaceIndexForTextResponse')
     SearchPlaceIndexForTextSummary = Shapes::StructureShape.new(name: 'SearchPlaceIndexForTextSummary')
+    SensitiveString = Shapes::StringShape.new(name: 'SensitiveString')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
     Step = Shapes::StructureShape.new(name: 'Step')
     StepDistanceDouble = Shapes::FloatShape.new(name: 'StepDistanceDouble')
@@ -240,10 +246,6 @@ module Aws::LocationService
     StepGeometryOffsetInteger = Shapes::IntegerShape.new(name: 'StepGeometryOffsetInteger')
     StepList = Shapes::ListShape.new(name: 'StepList')
     String = Shapes::StringShape.new(name: 'String')
-    SyntheticSearchPlaceIndexForSuggestionsRequestString = Shapes::StringShape.new(name: 'SyntheticSearchPlaceIndexForSuggestionsRequestString')
-    SyntheticSearchPlaceIndexForSuggestionsSummaryString = Shapes::StringShape.new(name: 'SyntheticSearchPlaceIndexForSuggestionsSummaryString')
-    SyntheticSearchPlaceIndexForTextRequestString = Shapes::StringShape.new(name: 'SyntheticSearchPlaceIndexForTextRequestString')
-    SyntheticSearchPlaceIndexForTextSummaryString = Shapes::StringShape.new(name: 'SyntheticSearchPlaceIndexForTextSummaryString')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagKeys = Shapes::ListShape.new(name: 'TagKeys')
     TagMap = Shapes::MapShape.new(name: 'TagMap')
@@ -468,6 +470,10 @@ module Aws::LocationService
     CalculateRouteTruckModeOptions.add_member(:weight, Shapes::ShapeRef.new(shape: TruckWeight, location_name: "Weight"))
     CalculateRouteTruckModeOptions.struct_class = Types::CalculateRouteTruckModeOptions
 
+    Circle.add_member(:center, Shapes::ShapeRef.new(shape: Position, required: true, location_name: "Center"))
+    Circle.add_member(:radius, Shapes::ShapeRef.new(shape: Double, required: true, location_name: "Radius"))
+    Circle.struct_class = Types::Circle
+
     ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     ConflictException.struct_class = Types::ConflictException
 
@@ -658,11 +664,13 @@ module Aws::LocationService
 
     DisassociateTrackerConsumerResponse.struct_class = Types::DisassociateTrackerConsumerResponse
 
+    GeofenceGeometry.add_member(:circle, Shapes::ShapeRef.new(shape: Circle, location_name: "Circle"))
     GeofenceGeometry.add_member(:polygon, Shapes::ShapeRef.new(shape: LinearRings, location_name: "Polygon"))
     GeofenceGeometry.struct_class = Types::GeofenceGeometry
 
     GetDevicePositionHistoryRequest.add_member(:device_id, Shapes::ShapeRef.new(shape: Id, required: true, location: "uri", location_name: "DeviceId"))
     GetDevicePositionHistoryRequest.add_member(:end_time_exclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTimeExclusive"))
+    GetDevicePositionHistoryRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: GetDevicePositionHistoryRequestMaxResultsInteger, location_name: "MaxResults"))
     GetDevicePositionHistoryRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
     GetDevicePositionHistoryRequest.add_member(:start_time_inclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StartTimeInclusive"))
     GetDevicePositionHistoryRequest.add_member(:tracker_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "TrackerName"))
@@ -805,6 +813,7 @@ module Aws::LocationService
     ListGeofenceResponseEntryList.member = Shapes::ShapeRef.new(shape: ListGeofenceResponseEntry)
 
     ListGeofencesRequest.add_member(:collection_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "CollectionName"))
+    ListGeofencesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListGeofencesRequestMaxResultsInteger, location_name: "MaxResults"))
     ListGeofencesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
     ListGeofencesRequest.struct_class = Types::ListGeofencesRequest
 
@@ -993,7 +1002,7 @@ module Aws::LocationService
     SearchPlaceIndexForSuggestionsRequest.add_member(:index_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "IndexName"))
     SearchPlaceIndexForSuggestionsRequest.add_member(:language, Shapes::ShapeRef.new(shape: LanguageTag, location_name: "Language"))
     SearchPlaceIndexForSuggestionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: SearchPlaceIndexForSuggestionsRequestMaxResultsInteger, location_name: "MaxResults"))
-    SearchPlaceIndexForSuggestionsRequest.add_member(:text, Shapes::ShapeRef.new(shape: SyntheticSearchPlaceIndexForSuggestionsRequestString, required: true, location_name: "Text"))
+    SearchPlaceIndexForSuggestionsRequest.add_member(:text, Shapes::ShapeRef.new(shape: SearchPlaceIndexForSuggestionsRequestTextString, required: true, location_name: "Text"))
     SearchPlaceIndexForSuggestionsRequest.struct_class = Types::SearchPlaceIndexForSuggestionsRequest
 
     SearchPlaceIndexForSuggestionsResponse.add_member(:results, Shapes::ShapeRef.new(shape: SearchForSuggestionsResultList, required: true, location_name: "Results"))
@@ -1006,7 +1015,7 @@ module Aws::LocationService
     SearchPlaceIndexForSuggestionsSummary.add_member(:filter_countries, Shapes::ShapeRef.new(shape: CountryCodeList, location_name: "FilterCountries"))
     SearchPlaceIndexForSuggestionsSummary.add_member(:language, Shapes::ShapeRef.new(shape: LanguageTag, location_name: "Language"))
     SearchPlaceIndexForSuggestionsSummary.add_member(:max_results, Shapes::ShapeRef.new(shape: Integer, location_name: "MaxResults"))
-    SearchPlaceIndexForSuggestionsSummary.add_member(:text, Shapes::ShapeRef.new(shape: SyntheticSearchPlaceIndexForSuggestionsSummaryString, required: true, location_name: "Text"))
+    SearchPlaceIndexForSuggestionsSummary.add_member(:text, Shapes::ShapeRef.new(shape: SensitiveString, required: true, location_name: "Text"))
     SearchPlaceIndexForSuggestionsSummary.struct_class = Types::SearchPlaceIndexForSuggestionsSummary
 
     SearchPlaceIndexForTextRequest.add_member(:bias_position, Shapes::ShapeRef.new(shape: Position, location_name: "BiasPosition"))
@@ -1015,7 +1024,7 @@ module Aws::LocationService
     SearchPlaceIndexForTextRequest.add_member(:index_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "IndexName"))
     SearchPlaceIndexForTextRequest.add_member(:language, Shapes::ShapeRef.new(shape: LanguageTag, location_name: "Language"))
     SearchPlaceIndexForTextRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: PlaceIndexSearchResultLimit, location_name: "MaxResults"))
-    SearchPlaceIndexForTextRequest.add_member(:text, Shapes::ShapeRef.new(shape: SyntheticSearchPlaceIndexForTextRequestString, required: true, location_name: "Text"))
+    SearchPlaceIndexForTextRequest.add_member(:text, Shapes::ShapeRef.new(shape: SearchPlaceIndexForTextRequestTextString, required: true, location_name: "Text"))
     SearchPlaceIndexForTextRequest.struct_class = Types::SearchPlaceIndexForTextRequest
 
     SearchPlaceIndexForTextResponse.add_member(:results, Shapes::ShapeRef.new(shape: SearchForTextResultList, required: true, location_name: "Results"))
@@ -1029,7 +1038,7 @@ module Aws::LocationService
     SearchPlaceIndexForTextSummary.add_member(:language, Shapes::ShapeRef.new(shape: LanguageTag, location_name: "Language"))
     SearchPlaceIndexForTextSummary.add_member(:max_results, Shapes::ShapeRef.new(shape: PlaceIndexSearchResultLimit, location_name: "MaxResults"))
     SearchPlaceIndexForTextSummary.add_member(:result_b_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "ResultBBox"))
-    SearchPlaceIndexForTextSummary.add_member(:text, Shapes::ShapeRef.new(shape: SyntheticSearchPlaceIndexForTextSummaryString, required: true, location_name: "Text"))
+    SearchPlaceIndexForTextSummary.add_member(:text, Shapes::ShapeRef.new(shape: SensitiveString, required: true, location_name: "Text"))
     SearchPlaceIndexForTextSummary.struct_class = Types::SearchPlaceIndexForTextSummary
 
     ServiceQuotaExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -1594,6 +1603,7 @@ module Aws::LocationService
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
           tokens: {
             "next_token" => "next_token"
           }
@@ -1737,6 +1747,7 @@ module Aws::LocationService
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
           tokens: {
             "next_token" => "next_token"
           }

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

@@ -380,6 +380,10 @@ module Aws::LocationService
     #           {
     #             geofence_id: "Id", # required
     #             geometry: { # required
+    #               circle: {
+    #                 center: [1.0], # required
+    #                 radius: 1.0, # required
+    #               },
     #               polygon: [
     #                 [
     #                   [1.0],
@@ -415,6 +419,10 @@ module Aws::LocationService
     #       {
     #         geofence_id: "Id", # required
     #         geometry: { # required
+    #           circle: {
+    #             center: [1.0], # required
+    #             radius: 1.0, # required
+    #           },
     #           polygon: [
     #             [
     #               [1.0],
@@ -429,10 +437,11 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] geometry
-    #   Contains the polygon details to specify the position of the
-    #   geofence.
+    #   Contains the details of 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>
     #
@@ -939,8 +948,8 @@ module Aws::LocationService
     #   @return [Boolean]
     #
     # @!attribute [rw] 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]`
     #
@@ -957,7 +966,7 @@ module Aws::LocationService
     #
     #
     #
-    #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
+    #   [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
     #   @return [Array<Float>]
     #
@@ -982,8 +991,8 @@ module Aws::LocationService
     #   @return [Time]
     #
     # @!attribute [rw] 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]`
     #
@@ -998,7 +1007,7 @@ module Aws::LocationService
     #
     #
     #
-    #   [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
+    #   [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
     #   @return [Array<Float>]
     #
@@ -1019,7 +1028,8 @@ module Aws::LocationService
     #
     # @!attribute [rw] 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`, or `Walking` as options for the `TravelMode`.
     #
     #   The `TravelMode` you specify also determines how you specify route
     #   preferences:
@@ -1266,6 +1276,39 @@ module Aws::LocationService
       include Aws::Structure
     end
 
+    # A circle on the earth, as defined by a center point and a radius.
+    #
+    # @note When making an API call, you may pass Circle
+    #   data as a hash:
+    #
+    #       {
+    #         center: [1.0], # required
+    #         radius: 1.0, # required
+    #       }
+    #
+    # @!attribute [rw] center
+    #   A single point geometry, specifying the center of the circle, using
+    #   [WGS 84][1] coordinates, in the form `[longitude, latitude]`.
+    #
+    #
+    #
+    #   [1]: https://gisgeography.com/wgs84-world-geodetic-system/
+    #   @return [Array<Float>]
+    #
+    # @!attribute [rw] radius
+    #   The radius of the circle in meters. Must be greater than zero and no
+    #   larger than 100,000 (100 kilometers).
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/Circle AWS API Documentation
+    #
+    class Circle < Struct.new(
+      :center,
+      :radius)
+      SENSITIVE = [:center]
+      include Aws::Structure
+    end
+
     # The request was unsuccessful because of a conflict.
     #
     # @!attribute [rw] message
@@ -2745,6 +2788,10 @@ module Aws::LocationService
 
     # Contains the geofence geometry details.
     #
+    # A geofence geometry is made up of either a polygon or a circle. Can be
+    # either a polygon or a circle. Including both will return a validation
+    # error.
+    #
     # <note markdown="1"> Amazon Location doesn't currently support polygons with holes,
     # multipolygons, polygons that are wound clockwise, or that cross the
     # antimeridian.
@@ -2755,6 +2802,10 @@ module Aws::LocationService
     #   data as a hash:
     #
     #       {
+    #         circle: {
+    #           center: [1.0], # required
+    #           radius: 1.0, # required
+    #         },
     #         polygon: [
     #           [
     #             [1.0],
@@ -2762,6 +2813,10 @@ module Aws::LocationService
     #         ],
     #       }
     #
+    # @!attribute [rw] circle
+    #   A circle on the earth, as defined by a center point and a radius.
+    #   @return [Types::Circle]
+    #
     # @!attribute [rw] polygon
     #   An array of 1 or more linear rings. A linear ring is an array of 4
     #   or more vertices, where the first and last vertex are the same to
@@ -2775,13 +2830,16 @@ module Aws::LocationService
     #   side is the polygon's exterior. Inner rings must list their
     #   vertices in clockwise order, where the left side is the polygon's
     #   interior.
+    #
+    #   A geofence polygon can consist of between 4 and 1,000 vertices.
     #   @return [Array<Array<Array<Float>>>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GeofenceGeometry AWS API Documentation
     #
     class GeofenceGeometry < Struct.new(
+      :circle,
       :polygon)
-      SENSITIVE = []
+      SENSITIVE = [:circle]
       include Aws::Structure
     end
 
@@ -2791,6 +2849,7 @@ module Aws::LocationService
     #       {
     #         device_id: "Id", # required
     #         end_time_exclusive: Time.now,
+    #         max_results: 1,
     #         next_token: "Token",
     #         start_time_inclusive: Time.now,
     #         tracker_name: "ResourceName", # required
@@ -2817,6 +2876,13 @@ module Aws::LocationService
     #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
     #   @return [Time]
     #
+    # @!attribute [rw] max_results
+    #   An optional limit for the number of device positions returned in a
+    #   single call.
+    #
+    #   Default value: `100`
+    #   @return [Integer]
+    #
     # @!attribute [rw] 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
@@ -2852,6 +2918,7 @@ module Aws::LocationService
     class GetDevicePositionHistoryRequest < Struct.new(
       :device_id,
       :end_time_exclusive,
+      :max_results,
       :next_token,
       :start_time_inclusive,
       :tracker_name)
@@ -2989,7 +3056,8 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] geometry
-    #   Contains the geofence geometry details describing a polygon.
+    #   Contains the geofence geometry details describing a polygon or a
+    #   circle.
     #   @return [Types::GeofenceGeometry]
     #
     # @!attribute [rw] status
@@ -3061,7 +3129,7 @@ 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 – `Firo GO Italic` \|
     #     `Fira GO Map` \| `Fira GO Map Bold` \| `Noto Sans CJK JP Bold` \|
@@ -3605,7 +3673,8 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] geometry
-    #   Contains the geofence geometry details describing a polygon.
+    #   Contains the geofence geometry details describing a polygon or a
+    #   circle.
     #   @return [Types::GeofenceGeometry]
     #
     # @!attribute [rw] status
@@ -3649,6 +3718,7 @@ module Aws::LocationService
     #
     #       {
     #         collection_name: "ResourceName", # required
+    #         max_results: 1,
     #         next_token: "Token",
     #       }
     #
@@ -3656,6 +3726,13 @@ module Aws::LocationService
     #   The name of the geofence collection storing the list of geofences.
     #   @return [String]
     #
+    # @!attribute [rw] max_results
+    #   An optional limit for the number of geofences returned in a single
+    #   call.
+    #
+    #   Default value: `100`
+    #   @return [Integer]
+    #
     # @!attribute [rw] 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
@@ -3668,6 +3745,7 @@ module Aws::LocationService
     #
     class ListGeofencesRequest < Struct.new(
       :collection_name,
+      :max_results,
       :next_token)
       SENSITIVE = []
       include Aws::Structure
@@ -4270,8 +4348,9 @@ module Aws::LocationService
     #
     #   Valid [HERE Technologies map styles][2]\:
     #
-    #   * `VectorHereBerlin` – The HERE Berlin map style is a high contrast
-    #     detailed base map of the world that blends 3D and 2D rendering.
+    #   * `VectorHereContrast` – The HERE Contrast (Berlin) map style is a
+    #     high contrast detailed base map of the world that blends 3D and 2D
+    #     rendering.
     #
     #   * `VectorHereExplore` – A default HERE map style containing a
     #     neutral, global map and its features including roads, buildings,
@@ -4283,6 +4362,12 @@ module Aws::LocationService
     #     symbolized with highlighted segments and icons on top of HERE
     #     Explore to support use cases within transport and logistics.
     #
+    #   <note markdown="1"> The `VectorHereContrast` style has been renamed from
+    #   `VectorHereBerlin`. `VectorHereBerlin` has been deprecated, but will
+    #   continue to work in applications that use it.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/esri.html
@@ -4300,6 +4385,9 @@ module Aws::LocationService
     # Contains details about addresses or points of interest that match the
     # search criteria.
     #
+    # Not all details are included with all responses. Some details may only
+    # be returned by specific data partners.
+    #
     # @!attribute [rw] address_number
     #   The numerical portion of an address, such as a building number.
     #   @return [String]
@@ -4440,6 +4528,10 @@ module Aws::LocationService
     #         collection_name: "ResourceName", # required
     #         geofence_id: "Id", # required
     #         geometry: { # required
+    #           circle: {
+    #             center: [1.0], # required
+    #             radius: 1.0, # required
+    #           },
     #           polygon: [
     #             [
     #               [1.0],
@@ -4457,10 +4549,11 @@ module Aws::LocationService
     #   @return [String]
     #
     # @!attribute [rw] 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>
     #
@@ -4704,10 +4797,21 @@ module Aws::LocationService
     #   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.
     #
     #
     #
@@ -4823,7 +4927,7 @@ module Aws::LocationService
     #         index_name: "ResourceName", # required
     #         language: "LanguageTag",
     #         max_results: 1,
-    #         text: "SyntheticSearchPlaceIndexForSuggestionsRequestString", # required
+    #         text: "SearchPlaceIndexForSuggestionsRequestTextString", # required
     #       }
     #
     # @!attribute [rw] bias_position
@@ -4887,12 +4991,20 @@ module Aws::LocationService
     #   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. 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`.
     #
-    #   Used only when the partner selected is Here.
+    #   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.
     #
     #
     #
@@ -5027,7 +5139,7 @@ module Aws::LocationService
     #         index_name: "ResourceName", # required
     #         language: "LanguageTag",
     #         max_results: 1,
-    #         text: "SyntheticSearchPlaceIndexForTextRequestString", # required
+    #         text: "SearchPlaceIndexForTextRequestTextString", # required
     #       }
     #
     # @!attribute [rw] bias_position
@@ -5091,10 +5203,20 @@ module Aws::LocationService
     #   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.
     #
     #
     #
@@ -5130,6 +5252,9 @@ module Aws::LocationService
     # @!attribute [rw] results
     #   A list of Places matching the input text. Each result contains
     #   additional information about the specific point of interest.
+    #
+    #   Not all response properties are included with all responses. Some
+    #   properties may only be returned by specific data partners.
     #   @return [Array<Types::SearchForTextResult>]
     #
     # @!attribute [rw] summary
@@ -5413,6 +5538,11 @@ module Aws::LocationService
     #   * For example, `4.5`.
     #
     #   ^
+    #
+    #   <note markdown="1"> For routes calculated with a HERE resource, this value must be
+    #   between 0 and 50 meters.
+    #
+    #    </note>
     #   @return [Float]
     #
     # @!attribute [rw] length
@@ -5421,6 +5551,11 @@ module Aws::LocationService
     #   * For example, `15.5`.
     #
     #   ^
+    #
+    #   <note markdown="1"> For routes calculated with a HERE resource, this value must be
+    #   between 0 and 300 meters.
+    #
+    #    </note>
     #   @return [Float]
     #
     # @!attribute [rw] unit
@@ -5435,6 +5570,11 @@ module Aws::LocationService
     #   * For example, `4.5`.
     #
     #   ^
+    #
+    #   <note markdown="1"> For routes calculated with a HERE resource, this value must be
+    #   between 0 and 50 meters.
+    #
+    #    </note>
     #   @return [Float]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/TruckDimensions AWS API Documentation

data/lib/aws-sdk-locationservice.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-locationservice/customizations'
 # @!group service
 module Aws::LocationService
 
-  GEM_VERSION = '1.20.0'
+  GEM_VERSION = '1.23.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-locationservice
 version: !ruby/object:Gem::Version
-  version: 1.20.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-15 00:00:00.000000000 Z
+date: 2022-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core