aws-sdk-locationservice 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 536a6fab433e456f1b431dc9f88322fcc4dc8fb6b3c53804eaae0661bc37213c
-  data.tar.gz: e81be64160f2ab6701e61780d600eec5ade74a382cd02e1c74dc16df2b2aaa68
+  metadata.gz: 5f9baf3628589cb756d9e91dc23595a6456e14efb5344d2f01415bbdf27f3096
+  data.tar.gz: 330e97f7b16b30e5fc8dc01f657f57810078b5c022e09b615d96066cc486024e
 SHA512:
-  metadata.gz: 17dfd27baad6ab7255699b9d714ef49df0d9779cb87a1906ece5179a344cdcf7ff7e64d0e59e46ef6ebf4d113b6ab24f322597bd3998e1dae79b0be3ac1d189f
-  data.tar.gz: 0cf84b09bd3d148bce57835eb2ea706112b1d24d10aec8c3daaa55d0ca21b6d3197233d93e7bcb44782d8cb9985aa34af7ece4cac5df56d4515024ea19fb0f8f
+  metadata.gz: d538941a32333bb81fa609e42d527cbd8de09ed150e523469300a4f82624c24557a7b909d361e4aebddfbb879ced104dfc673e0178f62bf73967e9bcaa50355b
+  data.tar.gz: 1a5d4301ba00d91853eaf2fb86bead0aa9a5a768e861f431532964c2052827ab9ee394fca146c53f822d26886d689d01320ded6fcd84e2d423c1571b9e20d480

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.22.0
+1.23.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` \|
@@ -2705,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
@@ -3009,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>
     #
@@ -3031,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],
@@ -3799,7 +3821,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.22.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')
@@ -469,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
 
@@ -659,6 +664,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
 

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` \|
@@ -3614,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
@@ -4288,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,
@@ -4301,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
@@ -4461,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],
@@ -4478,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>
     #
@@ -5466,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
@@ -5474,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
@@ -5488,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.22.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.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-06 00:00:00.000000000 Z
+date: 2022-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core