aws-sdk-locationservice 1.22.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 536a6fab433e456f1b431dc9f88322fcc4dc8fb6b3c53804eaae0661bc37213c
-  data.tar.gz: e81be64160f2ab6701e61780d600eec5ade74a382cd02e1c74dc16df2b2aaa68
+  metadata.gz: e0f85bf02c0d6d0d6493c104f83eb10459d5492c572cd859ab28f831fd60b1fe
+  data.tar.gz: 2406f353903c1a1de829240a93622205796d7543c1dec87381ce70ef2c02ff39
 SHA512:
-  metadata.gz: 17dfd27baad6ab7255699b9d714ef49df0d9779cb87a1906ece5179a344cdcf7ff7e64d0e59e46ef6ebf4d113b6ab24f322597bd3998e1dae79b0be3ac1d189f
-  data.tar.gz: 0cf84b09bd3d148bce57835eb2ea706112b1d24d10aec8c3daaa55d0ca21b6d3197233d93e7bcb44782d8cb9985aa34af7ece4cac5df56d4515024ea19fb0f8f
+  metadata.gz: ceb7c58310dff12b43a28a9320c9009cfa578a4e483d39fd7fa0aae1369dc5fb9b7d8ebc6eb2d54e4fbde28f390b04f9b70907b0b8be3b9055fe065f1e05fda0
+  data.tar.gz: 4b5ec4e884a42cc784fe34a2f9e0936e9b829f80ab88d1535b9a7889c9bcb5ec8a160f6bd36264a7b1d470d9ca5bf73d80a0df5841400c8458eb1bc080f95b5b

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.24.0 (2022-09-27)
+------------------
+
+* Feature - This release adds place IDs, which are unique identifiers of places, along with a new GetPlace operation, which can be used with place IDs to find a place again later. UnitNumber and UnitType are also added as new properties of places.
+
+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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.22.0
+1.24.0

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

@@ -626,6 +626,10 @@ module Aws::LocationService
     #       {
     #         geofence_id: "Id", # required
     #         geometry: { # required
+    #           circle: {
+    #             center: [1.0], # required
+    #             radius: 1.0, # required
+    #           },
     #           polygon: [
     #             [
     #               [1.0],
@@ -755,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
@@ -857,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:
@@ -2347,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
@@ -2389,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` \|
@@ -2448,7 +2461,7 @@ 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`
@@ -2568,6 +2581,91 @@ module Aws::LocationService
       req.send_request(options, &block)
     end
 
+    # Finds a place by its unique ID. A `PlaceId` is returned by other
+    # search operations.
+    #
+    # <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`.
+    #
+    #  * Customer AWS account
+    #
+    # * AWS Region
+    #
+    # * Data provider specified in the place index resource
+    #
+    #  </note>
+    #
+    # @option params [required, String] :index_name
+    #   The name of the place index resource that you want to use for the
+    #   search.
+    #
+    # @option params [String] :language
+    #   The preferred language used to return results. The value must be a
+    #   valid [BCP 47][1] language tag, for example, `en` for English.
+    #
+    #   This setting affects the languages used in the results, 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.get_place({
+    #     index_name: "ResourceName", # required
+    #     language: "LanguageTag",
+    #     place_id: "PlaceId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.place.address_number #=> 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.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 [Integer] :max_results
@@ -2705,6 +2803,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
@@ -3009,9 +3110,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>
     #
@@ -3031,6 +3134,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],
@@ -3133,6 +3240,9 @@ module Aws::LocationService
     #   resp.results[0].place.sub_region #=> String
     #   resp.results[0].place.time_zone.name #=> String
     #   resp.results[0].place.time_zone.offset #=> Integer
+    #   resp.results[0].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
@@ -3268,6 +3378,7 @@ module Aws::LocationService
     # @example Response structure
     #
     #   resp.results #=> Array
+    #   resp.results[0].place_id #=> String
     #   resp.results[0].text #=> String
     #   resp.summary.bias_position #=> Array
     #   resp.summary.bias_position[0] #=> Float
@@ -3425,6 +3536,9 @@ module Aws::LocationService
     #   resp.results[0].place.sub_region #=> String
     #   resp.results[0].place.time_zone.name #=> String
     #   resp.results[0].place.time_zone.offset #=> Integer
+    #   resp.results[0].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
@@ -3799,7 +3913,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.24.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')
@@ -116,6 +117,7 @@ module Aws::LocationService
     DisassociateTrackerConsumerResponse = Shapes::StructureShape.new(name: 'DisassociateTrackerConsumerResponse')
     DistanceUnit = Shapes::StringShape.new(name: 'DistanceUnit')
     Double = Shapes::FloatShape.new(name: 'Double')
+    GeoArn = Shapes::StringShape.new(name: 'GeoArn')
     GeofenceGeometry = Shapes::StructureShape.new(name: 'GeofenceGeometry')
     GetDevicePositionHistoryRequest = Shapes::StructureShape.new(name: 'GetDevicePositionHistoryRequest')
     GetDevicePositionHistoryRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'GetDevicePositionHistoryRequestMaxResultsInteger')
@@ -137,6 +139,8 @@ module Aws::LocationService
     GetMapTileRequestYString = Shapes::StringShape.new(name: 'GetMapTileRequestYString')
     GetMapTileRequestZString = Shapes::StringShape.new(name: 'GetMapTileRequestZString')
     GetMapTileResponse = Shapes::StructureShape.new(name: 'GetMapTileResponse')
+    GetPlaceRequest = Shapes::StructureShape.new(name: 'GetPlaceRequest')
+    GetPlaceResponse = Shapes::StructureShape.new(name: 'GetPlaceResponse')
     Id = Shapes::StringShape.new(name: 'Id')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
     IntendedUse = Shapes::StringShape.new(name: 'IntendedUse')
@@ -195,6 +199,7 @@ module Aws::LocationService
     MapStyle = Shapes::StringShape.new(name: 'MapStyle')
     Place = Shapes::StructureShape.new(name: 'Place')
     PlaceGeometry = Shapes::StructureShape.new(name: 'PlaceGeometry')
+    PlaceId = Shapes::StringShape.new(name: 'PlaceId')
     PlaceIndexSearchResultLimit = Shapes::IntegerShape.new(name: 'PlaceIndexSearchResultLimit')
     Position = Shapes::ListShape.new(name: 'Position')
     PositionFiltering = Shapes::StringShape.new(name: 'PositionFiltering')
@@ -469,6 +474,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
 
@@ -495,7 +504,7 @@ module Aws::LocationService
     CreateMapRequest.struct_class = Types::CreateMapRequest
 
     CreateMapResponse.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime"))
-    CreateMapResponse.add_member(:map_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "MapArn"))
+    CreateMapResponse.add_member(:map_arn, Shapes::ShapeRef.new(shape: GeoArn, required: true, location_name: "MapArn"))
     CreateMapResponse.add_member(:map_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "MapName"))
     CreateMapResponse.struct_class = Types::CreateMapResponse
 
@@ -587,7 +596,7 @@ module Aws::LocationService
     DescribeMapResponse.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "CreateTime"))
     DescribeMapResponse.add_member(:data_source, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DataSource"))
     DescribeMapResponse.add_member(:description, Shapes::ShapeRef.new(shape: ResourceDescription, required: true, location_name: "Description"))
-    DescribeMapResponse.add_member(:map_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "MapArn"))
+    DescribeMapResponse.add_member(:map_arn, Shapes::ShapeRef.new(shape: GeoArn, required: true, location_name: "MapArn"))
     DescribeMapResponse.add_member(:map_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "MapName"))
     DescribeMapResponse.add_member(:pricing_plan, Shapes::ShapeRef.new(shape: PricingPlan, deprecated: true, location_name: "PricingPlan", metadata: {"deprecatedMessage"=>"Deprecated. Always returns RequestBasedUsage."}))
     DescribeMapResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
@@ -659,6 +668,7 @@ 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
 
@@ -739,6 +749,14 @@ module Aws::LocationService
     GetMapTileResponse[:payload] = :blob
     GetMapTileResponse[:payload_member] = GetMapTileResponse.member(:blob)
 
+    GetPlaceRequest.add_member(:index_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location: "uri", location_name: "IndexName"))
+    GetPlaceRequest.add_member(:language, Shapes::ShapeRef.new(shape: LanguageTag, location: "querystring", location_name: "language"))
+    GetPlaceRequest.add_member(:place_id, Shapes::ShapeRef.new(shape: PlaceId, required: true, location: "uri", location_name: "PlaceId"))
+    GetPlaceRequest.struct_class = Types::GetPlaceRequest
+
+    GetPlaceResponse.add_member(:place, Shapes::ShapeRef.new(shape: Place, required: true, location_name: "Place"))
+    GetPlaceResponse.struct_class = Types::GetPlaceResponse
+
     InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     InternalServerException.struct_class = Types::InternalServerException
 
@@ -917,6 +935,8 @@ module Aws::LocationService
     Place.add_member(:street, Shapes::ShapeRef.new(shape: String, location_name: "Street"))
     Place.add_member(:sub_region, Shapes::ShapeRef.new(shape: String, location_name: "SubRegion"))
     Place.add_member(:time_zone, Shapes::ShapeRef.new(shape: TimeZone, location_name: "TimeZone"))
+    Place.add_member(:unit_number, Shapes::ShapeRef.new(shape: String, location_name: "UnitNumber"))
+    Place.add_member(:unit_type, Shapes::ShapeRef.new(shape: String, location_name: "UnitType"))
     Place.struct_class = Types::Place
 
     PlaceGeometry.add_member(:point, Shapes::ShapeRef.new(shape: Position, location_name: "Point"))
@@ -958,10 +978,12 @@ module Aws::LocationService
 
     SearchForPositionResult.add_member(:distance, Shapes::ShapeRef.new(shape: SearchForPositionResultDistanceDouble, required: true, location_name: "Distance"))
     SearchForPositionResult.add_member(:place, Shapes::ShapeRef.new(shape: Place, required: true, location_name: "Place"))
+    SearchForPositionResult.add_member(:place_id, Shapes::ShapeRef.new(shape: PlaceId, location_name: "PlaceId"))
     SearchForPositionResult.struct_class = Types::SearchForPositionResult
 
     SearchForPositionResultList.member = Shapes::ShapeRef.new(shape: SearchForPositionResult)
 
+    SearchForSuggestionsResult.add_member(:place_id, Shapes::ShapeRef.new(shape: PlaceId, location_name: "PlaceId"))
     SearchForSuggestionsResult.add_member(:text, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Text"))
     SearchForSuggestionsResult.struct_class = Types::SearchForSuggestionsResult
 
@@ -969,6 +991,7 @@ module Aws::LocationService
 
     SearchForTextResult.add_member(:distance, Shapes::ShapeRef.new(shape: SearchForTextResultDistanceDouble, location_name: "Distance"))
     SearchForTextResult.add_member(:place, Shapes::ShapeRef.new(shape: Place, required: true, location_name: "Place"))
+    SearchForTextResult.add_member(:place_id, Shapes::ShapeRef.new(shape: PlaceId, location_name: "PlaceId"))
     SearchForTextResult.add_member(:relevance, Shapes::ShapeRef.new(shape: SearchForTextResultRelevanceDouble, location_name: "Relevance"))
     SearchForTextResult.struct_class = Types::SearchForTextResult
 
@@ -1097,7 +1120,7 @@ module Aws::LocationService
     UpdateMapRequest.add_member(:pricing_plan, Shapes::ShapeRef.new(shape: PricingPlan, deprecated: true, location_name: "PricingPlan", metadata: {"deprecatedMessage"=>"Deprecated. If included, the only allowed value is RequestBasedUsage."}))
     UpdateMapRequest.struct_class = Types::UpdateMapRequest
 
-    UpdateMapResponse.add_member(:map_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "MapArn"))
+    UpdateMapResponse.add_member(:map_arn, Shapes::ShapeRef.new(shape: GeoArn, required: true, location_name: "MapArn"))
     UpdateMapResponse.add_member(:map_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "MapName"))
     UpdateMapResponse.add_member(:update_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "UpdateTime"))
     UpdateMapResponse.struct_class = Types::UpdateMapResponse
@@ -1684,6 +1707,22 @@ module Aws::LocationService
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
+      api.add_operation(:get_place, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetPlace"
+        o.http_method = "GET"
+        o.http_request_uri = "/places/v0/indexes/{IndexName}/places/{PlaceId}"
+        o.endpoint_pattern = {
+          "hostPrefix" => "places.",
+        }
+        o.input = Shapes::ShapeRef.new(shape: GetPlaceRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetPlaceResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+      end)
+
       api.add_operation(:list_device_positions, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListDevicePositions"
         o.http_method = "POST"

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>
     #
@@ -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
 
@@ -2998,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
@@ -3070,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` \|
@@ -3136,8 +3195,8 @@ module Aws::LocationService
     #
     #   * `sprites@2x.png` for high pixel density displays
     #
-    #   For the JSON document contain image offsets. Use the following file
-    #   names:
+    #   For the JSON document containing image offsets. Use the following
+    #   file names:
     #
     #   * `sprites.json`
     #
@@ -3268,6 +3327,71 @@ module Aws::LocationService
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetPlaceRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_name: "ResourceName", # required
+    #         language: "LanguageTag",
+    #         place_id: "PlaceId", # required
+    #       }
+    #
+    # @!attribute [rw] index_name
+    #   The name of the place index resource that you want to use for the
+    #   search.
+    #   @return [String]
+    #
+    # @!attribute [rw] language
+    #   The preferred language used to return results. The value must be a
+    #   valid [BCP 47][1] language tag, for example, `en` for English.
+    #
+    #   This setting affects the languages used in the results, 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
+    #   @return [String]
+    #
+    # @!attribute [rw] place_id
+    #   The identifier of the place to find.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetPlaceRequest AWS API Documentation
+    #
+    class GetPlaceRequest < Struct.new(
+      :index_name,
+      :language,
+      :place_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] place
+    #   Details about the result, such as its address and position.
+    #   @return [Types::Place]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetPlaceResponse AWS API Documentation
+    #
+    class GetPlaceResponse < Struct.new(
+      :place)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The request has failed to process because of an unknown server error,
     # exception, or failure.
     #
@@ -3614,7 +3738,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
@@ -4288,8 +4413,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,
@@ -4301,6 +4427,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
@@ -4390,6 +4522,21 @@ module Aws::LocationService
     #   using Here as the selected partner.
     #   @return [Types::TimeZone]
     #
+    # @!attribute [rw] unit_number
+    #   For addresses with multiple units, the unit identifier. Can include
+    #   numbers and letters, for example `3B` or `Unit 123`.
+    #
+    #   <note markdown="1"> Returned only for a place index that uses Esri as a data provider.
+    #   Is not returned for `SearchPlaceIndexForPosition`.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] unit_type
+    #   For addresses with a `UnitNumber`, the type of unit. For example,
+    #   `Apartment`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/Place AWS API Documentation
     #
     class Place < Struct.new(
@@ -4404,7 +4551,9 @@ module Aws::LocationService
       :region,
       :street,
       :sub_region,
-      :time_zone)
+      :time_zone,
+      :unit_number,
+      :unit_type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4461,6 +4610,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],
@@ -4478,10 +4631,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>
     #
@@ -4645,11 +4799,22 @@ module Aws::LocationService
     #   Details about the search result, such as its address and position.
     #   @return [Types::Place]
     #
+    # @!attribute [rw] place_id
+    #   The unique identifier of the place. You can use this with the
+    #   `GetPlace` operation to find the place again later.
+    #
+    #   <note markdown="1"> For `SearchPlaceIndexForPosition` operations, the `PlaceId` is
+    #   returned only by place indexes that use HERE as a data provider.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchForPositionResult AWS API Documentation
     #
     class SearchForPositionResult < Struct.new(
       :distance,
-      :place)
+      :place,
+      :place_id)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4657,6 +4822,16 @@ module Aws::LocationService
     # Contains a place suggestion resulting from a place suggestion query
     # that is run on a place index resource.
     #
+    # @!attribute [rw] place_id
+    #   The unique identifier of the place. You can use this with the
+    #   `GetPlace` operation to find the place again later.
+    #
+    #   <note markdown="1"> For `SearchPlaceIndexForSuggestions` operations, the `PlaceId` is
+    #   returned by place indexes that use HERE or Esri as data providers.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @!attribute [rw] text
     #   The text of the place suggestion, typically formatted as an address
     #   string.
@@ -4665,6 +4840,7 @@ module Aws::LocationService
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/SearchForSuggestionsResult AWS API Documentation
     #
     class SearchForSuggestionsResult < Struct.new(
+      :place_id,
       :text)
       SENSITIVE = []
       include Aws::Structure
@@ -4688,6 +4864,16 @@ module Aws::LocationService
     #   Details about the search result, such as its address and position.
     #   @return [Types::Place]
     #
+    # @!attribute [rw] place_id
+    #   The unique identifier of the place. You can use this with the
+    #   `GetPlace` operation to find the place again later.
+    #
+    #   <note markdown="1"> For `SearchPlaceIndexForText` operations, the `PlaceId` is returned
+    #   only by place indexes that use HERE as a data provider.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @!attribute [rw] relevance
     #   The relative confidence in the match for a result among the results
     #   returned. For example, if more fields for an address match
@@ -4702,6 +4888,7 @@ module Aws::LocationService
     class SearchForTextResult < Struct.new(
       :distance,
       :place,
+      :place_id,
       :relevance)
       SENSITIVE = []
       include Aws::Structure
@@ -5466,6 +5653,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
@@ -5474,6 +5666,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
@@ -5488,6 +5685,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.22.0'
+  GEM_VERSION = '1.24.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-locationservice
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.24.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-06 00:00:00.000000000 Z
+date: 2022-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core