aws-sdk-locationservice 1.44.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93e9fe61b27c4450689cf2675904d8df7550dff97541dbdeff5875d7789b2e3e
-  data.tar.gz: d4d2c0cc017600f225d45ffb864d70fcf2b9db0e5e12b7b2388cbd1e703bbbae
+  metadata.gz: 50d10f2df8a87cd6dc89c24da763dc7d959c71167a1c12ef3430550f9c76ed9a
+  data.tar.gz: df2115307c58372f9756273a277a78df90a684e511cf8da1ac327ce3ac91da70
 SHA512:
-  metadata.gz: f5047b6482d2b2dfd4ef976d5ea70ebb37ec1a90053168dac5916cc293a951a7e11773f060ffad763716d8fd8581debbd27eb6e1ed5ee1092526c931c3bfc968
-  data.tar.gz: e14e84d16379acff2d4d28d83b62859d1374c38818c91f9289d5f92ed9e0dd9575d25ff614c961dfae0feb6b35e78aeb3b00276e180d4b861ac58abc47637652
+  metadata.gz: 84e3bb5a514858952df9c8129eafd882de2e6aa548834f228166f1d663fbf669ef90efee51da15ddbc626ec849b8821c1c3e22999f6031c7c237e9af2c953c91
+  data.tar.gz: 4738535da3571069d033b1bad2a5f4a030c944c87c7e8231fb485b88c14fae89a1d1a51b85b496e3aad175e45d224174c283347c90cb2692f7e8e28403770b2d

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.46.0 (2024-01-12)
+------------------
+
+* Feature - Location SDK documentation update. Added missing fonts to the MapConfiguration data type. Updated note for the SubMunicipality property in the place data type.
+
+1.45.0 (2024-01-10)
+------------------
+
+* Feature - This release adds API support for custom layers for the maps service APIs: CreateMap, UpdateMap, DescribeMap.
+
 1.44.0 (2023-12-29)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.44.0
+1.46.0

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

@@ -1579,6 +1579,7 @@ module Aws::LocationService
     #
     #   resp = client.create_map({
     #     configuration: { # required
+    #       custom_layers: ["CustomLayer"],
     #       political_view: "CountryCode3",
     #       style: "MapStyle", # required
     #     },
@@ -2334,6 +2335,8 @@ module Aws::LocationService
     #
     # @example Response structure
     #
+    #   resp.configuration.custom_layers #=> Array
+    #   resp.configuration.custom_layers[0] #=> String
     #   resp.configuration.political_view #=> String
     #   resp.configuration.style #=> String
     #   resp.create_time #=> Time
@@ -2752,7 +2755,7 @@ module Aws::LocationService
     #     Bold`
     #
     #   * VectorEsriNavigation – `Arial Regular` \| `Arial Italic` \| `Arial
-    #     Bold`
+    #     Bold` \| `Arial Unicode MS Bold` \| `Arial Unicode MS Regular`
     #
     #   Valid font stacks for [HERE Technologies][2] styles:
     #
@@ -3062,6 +3065,39 @@ module Aws::LocationService
     # @option params [required, String] :place_id
     #   The identifier of the place to find.
     #
+    #   While you can use PlaceID in subsequent requests, PlaceID is not
+    #   intended to be a permanent identifier and the ID can change between
+    #   consecutive API calls. Please see the following PlaceID behaviour for
+    #   each data provider:
+    #
+    #   * Esri: Place IDs will change every quarter at a minimum. The typical
+    #     time period for these changes would be March, June, September, and
+    #     December. Place IDs might also change between the typical quarterly
+    #     change but that will be much less frequent.
+    #
+    #   * HERE: We recommend that you cache data for no longer than a week to
+    #     keep your data data fresh. You can assume that less than 1% ID
+    #     shifts will release over release which is approximately 1 - 2 times
+    #     per week.
+    #
+    #   * Grab: Place IDs can expire or become invalid in the following
+    #     situations.
+    #
+    #     * Data operations: The POI may be removed from Grab POI database by
+    #       Grab Map Ops based on the ground-truth, such as being closed in
+    #       the real world, being detected as a duplicate POI, or having
+    #       incorrect information. Grab will synchronize data to the Waypoint
+    #       environment on weekly basis.
+    #
+    #     * Interpolated POI: Interpolated POI is a temporary POI generated in
+    #       real time when serving a request, and it will be marked as derived
+    #       in the `place.result_type` field in the response. The information
+    #       of interpolated POIs will be retained for at least 30 days, which
+    #       means that within 30 days, you are able to obtain POI details by
+    #       Place ID from Place Details API. After 30 days, the interpolated
+    #       POIs(both Place ID and details) may expire and inaccessible from
+    #       the Places Details API.
+    #
     # @return [Types::GetPlaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetPlaceResponse#place #place} => Types::Place
@@ -4396,6 +4432,7 @@ module Aws::LocationService
     #
     #   resp = client.update_map({
     #     configuration_update: {
+    #       custom_layers: ["CustomLayer"],
     #       political_view: "CountryCode3OrEmpty",
     #     },
     #     description: "ResourceDescription",
@@ -4617,7 +4654,7 @@ module Aws::LocationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-locationservice'
-      context[:gem_version] = '1.44.0'
+      context[:gem_version] = '1.46.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -99,6 +99,8 @@ module Aws::LocationService
     CreateRouteCalculatorResponse = Shapes::StructureShape.new(name: 'CreateRouteCalculatorResponse')
     CreateTrackerRequest = Shapes::StructureShape.new(name: 'CreateTrackerRequest')
     CreateTrackerResponse = Shapes::StructureShape.new(name: 'CreateTrackerResponse')
+    CustomLayer = Shapes::StringShape.new(name: 'CustomLayer')
+    CustomLayerList = Shapes::ListShape.new(name: 'CustomLayerList')
     DataSourceConfiguration = Shapes::StructureShape.new(name: 'DataSourceConfiguration')
     DeleteGeofenceCollectionRequest = Shapes::StructureShape.new(name: 'DeleteGeofenceCollectionRequest')
     DeleteGeofenceCollectionResponse = Shapes::StructureShape.new(name: 'DeleteGeofenceCollectionResponse')
@@ -615,6 +617,8 @@ module Aws::LocationService
     CreateTrackerResponse.add_member(:tracker_name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "TrackerName"))
     CreateTrackerResponse.struct_class = Types::CreateTrackerResponse
 
+    CustomLayerList.member = Shapes::ShapeRef.new(shape: CustomLayer)
+
     DataSourceConfiguration.add_member(:intended_use, Shapes::ShapeRef.new(shape: IntendedUse, location_name: "IntendedUse"))
     DataSourceConfiguration.struct_class = Types::DataSourceConfiguration
 
@@ -1044,10 +1048,12 @@ module Aws::LocationService
 
     ListTrackersResponseEntryList.member = Shapes::ShapeRef.new(shape: ListTrackersResponseEntry)
 
+    MapConfiguration.add_member(:custom_layers, Shapes::ShapeRef.new(shape: CustomLayerList, location_name: "CustomLayers"))
     MapConfiguration.add_member(:political_view, Shapes::ShapeRef.new(shape: CountryCode3, location_name: "PoliticalView"))
     MapConfiguration.add_member(:style, Shapes::ShapeRef.new(shape: MapStyle, required: true, location_name: "Style"))
     MapConfiguration.struct_class = Types::MapConfiguration
 
+    MapConfigurationUpdate.add_member(:custom_layers, Shapes::ShapeRef.new(shape: CustomLayerList, location_name: "CustomLayers"))
     MapConfigurationUpdate.add_member(:political_view, Shapes::ShapeRef.new(shape: CountryCode3OrEmpty, location_name: "PoliticalView"))
     MapConfigurationUpdate.struct_class = Types::MapConfigurationUpdate
 

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

@@ -3219,7 +3219,7 @@ module Aws::LocationService
     #     Bold`
     #
     #   * VectorEsriNavigation – `Arial Regular` \| `Arial Italic` \| `Arial
-    #     Bold`
+    #     Bold` \| `Arial Unicode MS Bold` \| `Arial Unicode MS Regular`
     #
     #   Valid font stacks for [HERE Technologies][2] styles:
     #
@@ -3527,6 +3527,39 @@ module Aws::LocationService
     #
     # @!attribute [rw] place_id
     #   The identifier of the place to find.
+    #
+    #   While you can use PlaceID in subsequent requests, PlaceID is not
+    #   intended to be a permanent identifier and the ID can change between
+    #   consecutive API calls. Please see the following PlaceID behaviour
+    #   for each data provider:
+    #
+    #   * Esri: Place IDs will change every quarter at a minimum. The
+    #     typical time period for these changes would be March, June,
+    #     September, and December. Place IDs might also change between the
+    #     typical quarterly change but that will be much less frequent.
+    #
+    #   * HERE: We recommend that you cache data for no longer than a week
+    #     to keep your data data fresh. You can assume that less than 1% ID
+    #     shifts will release over release which is approximately 1 - 2
+    #     times per week.
+    #
+    #   * Grab: Place IDs can expire or become invalid in the following
+    #     situations.
+    #
+    #     * Data operations: The POI may be removed from Grab POI database
+    #       by Grab Map Ops based on the ground-truth, such as being closed
+    #       in the real world, being detected as a duplicate POI, or having
+    #       incorrect information. Grab will synchronize data to the
+    #       Waypoint environment on weekly basis.
+    #
+    #     * Interpolated POI: Interpolated POI is a temporary POI generated
+    #       in real time when serving a request, and it will be marked as
+    #       derived in the `place.result_type` field in the response. The
+    #       information of interpolated POIs will be retained for at least
+    #       30 days, which means that within 30 days, you are able to obtain
+    #       POI details by Place ID from Place Details API. After 30 days,
+    #       the interpolated POIs(both Place ID and details) may expire and
+    #       inaccessible from the Places Details API.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetPlaceRequest AWS API Documentation
@@ -4582,6 +4615,22 @@ module Aws::LocationService
 
     # Specifies the map tile style selected from an available provider.
     #
+    # @!attribute [rw] custom_layers
+    #   Specifies the custom layers for the style. Leave unset to not enable
+    #   any custom layer, or, for styles that support custom layers, you can
+    #   enable layer(s), such as `POI` layer for the VectorEsriNavigation
+    #   style. Default is `unset`.
+    #
+    #   <note markdown="1"> Currenlty only `VectorEsriNavigation` supports CustomLayers. For
+    #   more information, see [Custom Layers][1].
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html#map-custom-layers
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] political_view
     #   Specifies the political view for the style. Leave unset to not use a
     #   political view, or, for styles that support specific political
@@ -4604,10 +4653,15 @@ module Aws::LocationService
     #
     #   Valid [Esri map styles][1]:
     #
-    #   * `VectorEsriDarkGrayCanvas` – The Esri Dark Gray Canvas map style.
-    #     A vector basemap with a dark gray, neutral background with minimal
-    #     colors, labels, and features that's designed to draw attention to
-    #     your thematic content.
+    #   * `VectorEsriNavigation` – The Esri Navigation map style, which
+    #     provides a detailed basemap for the world symbolized with a custom
+    #     navigation map style that's designed for use during the day in
+    #     mobile devices. It also includes a richer set of places, such as
+    #     shops, services, restaurants, attractions, and other points of
+    #     interest. Enable the `POI` layer by setting it in CustomLayers to
+    #     leverage the additional places data.
+    #
+    #
     #
     #   * `RasterEsriImagery` – The Esri Imagery map style. A raster basemap
     #     that provides one meter or better satellite and aerial imagery in
@@ -4627,33 +4681,18 @@ module Aws::LocationService
     #     Esri street map style. The vector tile layer is similar in content
     #     and style to the World Street Map raster map.
     #
-    #   * `VectorEsriNavigation` – The Esri Navigation map style, which
-    #     provides a detailed basemap for the world symbolized with a custom
-    #     navigation map style that's designed for use during the day in
-    #     mobile devices.
+    #   * `VectorEsriDarkGrayCanvas` – The Esri Dark Gray Canvas map style.
+    #     A vector basemap with a dark gray, neutral background with minimal
+    #     colors, labels, and features that's designed to draw attention to
+    #     your thematic content.
     #
     #   Valid [HERE Technologies map styles][2]:
     #
-    #   * `VectorHereContrast` – The HERE Contrast (Berlin) map style is a
-    #     high contrast detailed base map of the world that blends 3D and 2D
-    #     rendering.
-    #
-    #     <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>
-    #
     #   * `VectorHereExplore` – A default HERE map style containing a
     #     neutral, global map and its features including roads, buildings,
     #     landmarks, and water features. It also now includes a fully
     #     designed map of Japan.
     #
-    #   * `VectorHereExploreTruck` – A global map containing truck
-    #     restrictions and attributes (e.g. width / height / HAZMAT)
-    #     symbolized with highlighted segments and icons on top of HERE
-    #     Explore to support use cases within transport and logistics.
-    #
     #   * `RasterHereExploreSatellite` – A global map containing high
     #     resolution satellite imagery.
     #
@@ -4669,6 +4708,21 @@ module Aws::LocationService
     #
     #      </note>
     #
+    #   * `VectorHereContrast` – The HERE Contrast (Berlin) map style is a
+    #     high contrast detailed base map of the world that blends 3D and 2D
+    #     rendering.
+    #
+    #     <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>
+    #
+    #   * `VectorHereExploreTruck` – A global map containing truck
+    #     restrictions and attributes (e.g. width / height / HAZMAT)
+    #     symbolized with highlighted segments and icons on top of HERE
+    #     Explore to support use cases within transport and logistics.
+    #
     #   Valid [GrabMaps map styles][3]:
     #
     #   * `VectorGrabStandardLight` – The Grab Standard Light map style
@@ -4720,6 +4774,7 @@ module Aws::LocationService
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/MapConfiguration AWS API Documentation
     #
     class MapConfiguration < Struct.new(
+      :custom_layers,
       :political_view,
       :style)
       SENSITIVE = []
@@ -4728,6 +4783,22 @@ module Aws::LocationService
 
     # Specifies the political view for the style.
     #
+    # @!attribute [rw] custom_layers
+    #   Specifies the custom layers for the style. Leave unset to not enable
+    #   any custom layer, or, for styles that support custom layers, you can
+    #   enable layer(s), such as `POI` layer for the VectorEsriNavigation
+    #   style. Default is `unset`.
+    #
+    #   <note markdown="1"> Currenlty only `VectorEsriNavigation` supports CustomLayers. For
+    #   more information, see [Custom Layers][1].
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html#map-custom-layers
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] political_view
     #   Specifies the political view for the style. Set to an empty string
     #   to not use a political view, or, for styles that support specific
@@ -4747,6 +4818,7 @@ module Aws::LocationService
     # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/MapConfigurationUpdate AWS API Documentation
     #
     class MapConfigurationUpdate < Struct.new(
+      :custom_layers,
       :political_view)
       SENSITIVE = []
       include Aws::Structure
@@ -4831,12 +4903,19 @@ module Aws::LocationService
     #
     # @!attribute [rw] sub_municipality
     #   An area that's part of a larger municipality. For example,
-    #   `Blissville ` is a submunicipality in the Queen County in New York.
+    #   `Blissville` is a submunicipality in the Queen County in New York.
     #
-    #   <note markdown="1"> This property supported by Esri and OpenData. The Esri property is
-    #   `district`, and the OpenData property is `borough`.
+    #   <note markdown="1"> This property is only returned for a place index that uses Esri as a
+    #   data provider. The property is represented as a `district`.
     #
     #    </note>
+    #
+    #   For more information about data providers, see [Amazon Location
+    #   Service data providers][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
     #   @return [String]
     #
     # @!attribute [rw] sub_region
@@ -4858,8 +4937,9 @@ module Aws::LocationService
     #   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 or Grab as a data
-    #   provider. Is not returned for `SearchPlaceIndexForPosition`.
+    #   <note markdown="1"> This property is returned only for a place index that uses Esri or
+    #   Grab as a data provider. It is not returned for
+    #   `SearchPlaceIndexForPosition`.
     #
     #    </note>
     #   @return [String]
@@ -4868,7 +4948,8 @@ module Aws::LocationService
     #   For addresses with a `UnitNumber`, the type of unit. For example,
     #   `Apartment`.
     #
-    #   <note markdown="1"> Returned only for a place index that uses Esri as a data provider.
+    #   <note markdown="1"> This property is returned only for a place index that uses Esri as a
+    #   data provider.
     #
     #    </note>
     #   @return [String]
@@ -5170,6 +5251,39 @@ module Aws::LocationService
     #   providers.
     #
     #    </note>
+    #
+    #   While you can use PlaceID in subsequent requests, PlaceID is not
+    #   intended to be a permanent identifier and the ID can change between
+    #   consecutive API calls. Please see the following PlaceID behaviour
+    #   for each data provider:
+    #
+    #   * Esri: Place IDs will change every quarter at a minimum. The
+    #     typical time period for these changes would be March, June,
+    #     September, and December. Place IDs might also change between the
+    #     typical quarterly change but that will be much less frequent.
+    #
+    #   * HERE: We recommend that you cache data for no longer than a week
+    #     to keep your data data fresh. You can assume that less than 1% ID
+    #     shifts will release over release which is approximately 1 - 2
+    #     times per week.
+    #
+    #   * Grab: Place IDs can expire or become invalid in the following
+    #     situations.
+    #
+    #     * Data operations: The POI may be removed from Grab POI database
+    #       by Grab Map Ops based on the ground-truth, such as being closed
+    #       in the real world, being detected as a duplicate POI, or having
+    #       incorrect information. Grab will synchronize data to the
+    #       Waypoint environment on weekly basis.
+    #
+    #     * Interpolated POI: Interpolated POI is a temporary POI generated
+    #       in real time when serving a request, and it will be marked as
+    #       derived in the `place.result_type` field in the response. The
+    #       information of interpolated POIs will be retained for at least
+    #       30 days, which means that within 30 days, you are able to obtain
+    #       POI details by Place ID from Place Details API. After 30 days,
+    #       the interpolated POIs(both Place ID and details) may expire and
+    #       inaccessible from the Places Details API.
     #   @return [String]
     #
     # @!attribute [rw] supplemental_categories

data/lib/aws-sdk-locationservice.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-locationservice/customizations'
 # @!group service
 module Aws::LocationService
 
-  GEM_VERSION = '1.44.0'
+  GEM_VERSION = '1.46.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-locationservice
 version: !ruby/object:Gem::Version
-  version: 1.44.0
+  version: 1.46.0
 platform: ruby
 authors:
 - Amazon Web Services
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-29 00:00:00.000000000 Z
+date: 2024-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -72,7 +72,7 @@ licenses:
 metadata:
   source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-locationservice
   changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-locationservice/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -87,8 +87,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon Location Service
 test_files: []