aws-sdk-locationservice 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 5c19259ac29261a9277641b8b8750287ff3b3d9b06d33d78511965e58a1e7560
4
- data.tar.gz: 939f0a86a948ac2a3652154f5e82bdb37476a7886160d3e737b573f0ba7270eb
3
+ metadata.gz: aba7ec73ba9a33848015d7eba1a98c4f116a29d82f19595e2bd3b8ae06f69f2f
4
+ data.tar.gz: 3abca69273732b386579cb9ff9006c862bd47a9bd4495a5b975ee4944d3d2474
5
5
  SHA512:
6
- metadata.gz: d6e9263fb5d042c3844de074c469c3857663258c1936db71e55122a458daf6cbc736036f7b44cb0ced7ee1f2f992eccc40985b625a9801812bb758ffc10093c6
7
- data.tar.gz: 44b223c7c3d67119d323922db5c348775d1a9f1868394153dbbdb35fdd02531030627066b60a41299eb468de0c8a5f39cd6ebc6c957670a3661a7444381c1388
6
+ metadata.gz: cdcd2d06e1b8d54d87d10bfa9486f381f11ce22dbea910c94b6f24e20faa2add6bc1e2d8eedba96587128e1bea2631fdb732feb075386a59025c0f48d530ca43
7
+ data.tar.gz: c14b5b099577774f47f502da0a9c199c99290600e9cd0fbcb1dace53d6d588abddddaa87b6e127bcd8661038d54ba404e6e0480d68ba54fd6ec05cbfd5d46a14
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.4.0 (2021-05-28)
5
+ ------------------
6
+
7
+ * Feature - Adds support for calculation of routes, resource tagging and customer provided KMS keys.
8
+
4
9
  1.3.0 (2021-03-29)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.3.0
1
+ 1.4.0
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-locationservice/customizations'
48
48
  # @!group service
49
49
  module Aws::LocationService
50
50
 
51
- GEM_VERSION = '1.3.0'
51
+ GEM_VERSION = '1.4.0'
52
52
 
53
53
  end
@@ -343,7 +343,7 @@ module Aws::LocationService
343
343
  # resource across all AWS.
344
344
  #
345
345
  # * Format example:
346
- # `arn:partition:service:region:account-id:resource-type:resource-id`
346
+ # `arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer`
347
347
  #
348
348
  # ^
349
349
  #
@@ -369,10 +369,50 @@ module Aws::LocationService
369
369
  req.send_request(options)
370
370
  end
371
371
 
372
+ # Deletes the position history of one or more devices from a tracker
373
+ # resource.
374
+ #
375
+ # @option params [required, Array<String>] :device_ids
376
+ # Devices whose position history you want to delete.
377
+ #
378
+ # * For example, for two devices: `“DeviceIds” : [DeviceId1,DeviceId2]`
379
+ #
380
+ # ^
381
+ #
382
+ # @option params [required, String] :tracker_name
383
+ # The name of the tracker resource to delete the device position history
384
+ # from.
385
+ #
386
+ # @return [Types::BatchDeleteDevicePositionHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
387
+ #
388
+ # * {Types::BatchDeleteDevicePositionHistoryResponse#errors #errors} => Array&lt;Types::BatchDeleteDevicePositionHistoryError&gt;
389
+ #
390
+ # @example Request syntax with placeholder values
391
+ #
392
+ # resp = client.batch_delete_device_position_history({
393
+ # device_ids: ["Id"], # required
394
+ # tracker_name: "ResourceName", # required
395
+ # })
396
+ #
397
+ # @example Response structure
398
+ #
399
+ # resp.errors #=> Array
400
+ # resp.errors[0].device_id #=> String
401
+ # resp.errors[0].error.code #=> String, one of "AccessDeniedError", "ConflictError", "InternalServerError", "ResourceNotFoundError", "ThrottlingError", "ValidationError"
402
+ # resp.errors[0].error.message #=> String
403
+ #
404
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/BatchDeleteDevicePositionHistory AWS API Documentation
405
+ #
406
+ # @overload batch_delete_device_position_history(params = {})
407
+ # @param [Hash] params ({})
408
+ def batch_delete_device_position_history(params = {}, options = {})
409
+ req = build_request(:batch_delete_device_position_history, params)
410
+ req.send_request(options)
411
+ end
412
+
372
413
  # Deletes a batch of geofences from a geofence collection.
373
414
  #
374
- # <note markdown="1"> This action deletes the resource permanently. You can't undo this
375
- # action.
415
+ # <note markdown="1"> This operation deletes the resource permanently.
376
416
  #
377
417
  # </note>
378
418
  #
@@ -509,7 +549,8 @@ module Aws::LocationService
509
549
  end
510
550
 
511
551
  # A batch request for storing geofence geometries into a given geofence
512
- # collection.
552
+ # collection, or updates the geometry of an existing geofence if a
553
+ # geofence ID is included in the request.
513
554
  #
514
555
  # @option params [required, String] :collection_name
515
556
  # The geofence collection storing the geofences.
@@ -565,8 +606,8 @@ module Aws::LocationService
565
606
  # device position and position history.
566
607
  #
567
608
  # <note markdown="1"> Only one position update is stored per sample time. Location data is
568
- # sampled at a fixed rate of one position per 30-second interval, and
569
- # retained for one year before it is deleted.
609
+ # sampled at a fixed rate of one position per 30-second interval and
610
+ # retained for 30 days before it's deleted.
570
611
  #
571
612
  # </note>
572
613
  #
@@ -610,6 +651,249 @@ module Aws::LocationService
610
651
  req.send_request(options)
611
652
  end
612
653
 
654
+ # [Calculates a route][1] given the following required parameters:
655
+ # `DeparturePostiton` and `DestinationPosition`. Requires that you first
656
+ # [create aroute calculator resource][2]
657
+ #
658
+ # By default, a request that doesn't specify a departure time uses the
659
+ # best time of day to travel with the best traffic conditions when
660
+ # calculating the route.
661
+ #
662
+ # Additional options include:
663
+ #
664
+ # * [Specifying a departure time][3] using either `DepartureTime` or
665
+ # `DepartureNow`. This calculates a route based on predictive traffic
666
+ # data at the given time.
667
+ #
668
+ # <note markdown="1"> You can't specify both `DepartureTime` and `DepartureNow` in a
669
+ # single request. Specifying both parameters returns an error message.
670
+ #
671
+ # </note>
672
+ #
673
+ # * [Specifying a travel mode][4] using TravelMode. This lets you
674
+ # specify additional route preference such as `CarModeOptions` if
675
+ # traveling by `Car`, or `TruckModeOptions` if traveling by `Truck`.
676
+ #
677
+ #
678
+ #
679
+ #
680
+ #
681
+ # [1]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html
682
+ # [2]: https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html
683
+ # [3]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#departure-time
684
+ # [4]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#travel-mode
685
+ #
686
+ # @option params [required, String] :calculator_name
687
+ # The name of the route calculator resource that you want to use to
688
+ # calculate a route.
689
+ #
690
+ # @option params [Types::CalculateRouteCarModeOptions] :car_mode_options
691
+ # Specifies route preferences when traveling by `Car`, such as avoiding
692
+ # routes that use ferries or tolls.
693
+ #
694
+ # Requirements: `TravelMode` must be specified as `Car`.
695
+ #
696
+ # @option params [Boolean] :depart_now
697
+ # Sets the time of departure as the current time. Uses the current time
698
+ # to calculate a route. Otherwise, the best time of day to travel with
699
+ # the best traffic conditions is used to calculate the route.
700
+ #
701
+ # Default Value: `false`
702
+ #
703
+ # Valid Values: `false` \| `true`
704
+ #
705
+ # @option params [required, Array<Float>] :departure_position
706
+ # The start position for the route. Defined in [WGS 84][1] format:
707
+ # `[longitude, latitude]`.
708
+ #
709
+ # * For example, `[-123.115, 49.285]`
710
+ #
711
+ # ^
712
+ #
713
+ # <note markdown="1"> If you specify a departure that's not located on a road, Amazon
714
+ # Location [moves the position to the nearest road][2].
715
+ #
716
+ # </note>
717
+ #
718
+ # Valid Values: `[-180 to 180,-90 to 90]`
719
+ #
720
+ #
721
+ #
722
+ # [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
723
+ # [2]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road
724
+ #
725
+ # @option params [Time,DateTime,Date,Integer,String] :departure_time
726
+ # Specifies the desired time of departure. Uses the given time to
727
+ # calculate a route. Otherwise, the best time of day to travel with the
728
+ # best traffic conditions is used to calculate the route.
729
+ #
730
+ # <note markdown="1"> Setting a departure time in the past returns a `400
731
+ # ValidationException` error.
732
+ #
733
+ # </note>
734
+ #
735
+ # * In [ISO 8601][1] format: `YYYY-MM-DDThh:mm:ss.sssZ`. For example,
736
+ # `2020–07-2T12:15:20.000Z+01:00`
737
+ #
738
+ # ^
739
+ #
740
+ #
741
+ #
742
+ # [1]: https://www.iso.org/iso-8601-date-and-time-format.html
743
+ #
744
+ # @option params [required, Array<Float>] :destination_position
745
+ # The finish position for the route. Defined in [WGS 84][1] format:
746
+ # `[longitude, latitude]`.
747
+ #
748
+ # * For example, `[-122.339, 47.615]`
749
+ #
750
+ # ^
751
+ #
752
+ # <note markdown="1"> If you specify a destination that's not located on a road, Amazon
753
+ # Location [moves the position to the nearest road][2].
754
+ #
755
+ # </note>
756
+ #
757
+ # Valid Values: `[-180 to 180,-90 to 90]`
758
+ #
759
+ #
760
+ #
761
+ # [1]: https://earth-info.nga.mil/GandG/wgs84/index.html
762
+ # [2]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road
763
+ #
764
+ # @option params [String] :distance_unit
765
+ # Set the unit system to specify the distance.
766
+ #
767
+ # Default Value: `Kilometers`
768
+ #
769
+ # @option params [Boolean] :include_leg_geometry
770
+ # Set to include the geometry details in the result for each path
771
+ # between a pair of positions.
772
+ #
773
+ # Default Value: `false`
774
+ #
775
+ # Valid Values: `false` \| `true`
776
+ #
777
+ # @option params [String] :travel_mode
778
+ # Specifies the mode of transport when calculating a route. Used in
779
+ # estimating the speed of travel and road compatibility.
780
+ #
781
+ # The `TravelMode` you specify determines how you specify route
782
+ # preferences:
783
+ #
784
+ # * If traveling by `Car` use the `CarModeOptions` parameter.
785
+ #
786
+ # * If traveling by `Truck` use the `TruckModeOptions` parameter.
787
+ #
788
+ # Default Value: `Car`
789
+ #
790
+ # @option params [Types::CalculateRouteTruckModeOptions] :truck_mode_options
791
+ # Specifies route preferences when traveling by `Truck`, such as
792
+ # avoiding routes that use ferries or tolls, and truck specifications to
793
+ # consider when choosing an optimal road.
794
+ #
795
+ # Requirements: `TravelMode` must be specified as `Truck`.
796
+ #
797
+ # @option params [Array<Array>] :waypoint_positions
798
+ # Specifies an ordered list of up to 23 intermediate positions to
799
+ # include along a route between the departure position and destination
800
+ # position.
801
+ #
802
+ # * For example, from the `DeparturePosition` `[-123.115, 49.285]`, the
803
+ # route follows the order that the waypoint positions are given
804
+ # `[[-122.757, 49.0021],[-122.349, 47.620]]`
805
+ #
806
+ # ^
807
+ #
808
+ # <note markdown="1"> If you specify a waypoint position that's not located on a road,
809
+ # Amazon Location [moves the position to the nearest road][1].
810
+ #
811
+ # Specifying more than 23 waypoints returns a `400 ValidationException`
812
+ # error.
813
+ #
814
+ # </note>
815
+ #
816
+ # Valid Values: `[-180 to 180,-90 to 90]`
817
+ #
818
+ #
819
+ #
820
+ # [1]: https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road
821
+ #
822
+ # @return [Types::CalculateRouteResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
823
+ #
824
+ # * {Types::CalculateRouteResponse#legs #legs} => Array&lt;Types::Leg&gt;
825
+ # * {Types::CalculateRouteResponse#summary #summary} => Types::CalculateRouteSummary
826
+ #
827
+ # @example Request syntax with placeholder values
828
+ #
829
+ # resp = client.calculate_route({
830
+ # calculator_name: "ResourceName", # required
831
+ # car_mode_options: {
832
+ # avoid_ferries: false,
833
+ # avoid_tolls: false,
834
+ # },
835
+ # depart_now: false,
836
+ # departure_position: [1.0], # required
837
+ # departure_time: Time.now,
838
+ # destination_position: [1.0], # required
839
+ # distance_unit: "Kilometers", # accepts Kilometers, Miles
840
+ # include_leg_geometry: false,
841
+ # travel_mode: "Car", # accepts Car, Truck, Walking
842
+ # truck_mode_options: {
843
+ # avoid_ferries: false,
844
+ # avoid_tolls: false,
845
+ # dimensions: {
846
+ # height: 1.0,
847
+ # length: 1.0,
848
+ # unit: "Meters", # accepts Meters, Feet
849
+ # width: 1.0,
850
+ # },
851
+ # weight: {
852
+ # total: 1.0,
853
+ # unit: "Kilograms", # accepts Kilograms, Pounds
854
+ # },
855
+ # },
856
+ # waypoint_positions: [
857
+ # [1.0],
858
+ # ],
859
+ # })
860
+ #
861
+ # @example Response structure
862
+ #
863
+ # resp.legs #=> Array
864
+ # resp.legs[0].distance #=> Float
865
+ # resp.legs[0].duration_seconds #=> Float
866
+ # resp.legs[0].end_position #=> Array
867
+ # resp.legs[0].end_position[0] #=> Float
868
+ # resp.legs[0].geometry.line_string #=> Array
869
+ # resp.legs[0].geometry.line_string[0] #=> Array
870
+ # resp.legs[0].geometry.line_string[0][0] #=> Float
871
+ # resp.legs[0].start_position #=> Array
872
+ # resp.legs[0].start_position[0] #=> Float
873
+ # resp.legs[0].steps #=> Array
874
+ # resp.legs[0].steps[0].distance #=> Float
875
+ # resp.legs[0].steps[0].duration_seconds #=> Float
876
+ # resp.legs[0].steps[0].end_position #=> Array
877
+ # resp.legs[0].steps[0].end_position[0] #=> Float
878
+ # resp.legs[0].steps[0].geometry_offset #=> Integer
879
+ # resp.legs[0].steps[0].start_position #=> Array
880
+ # resp.legs[0].steps[0].start_position[0] #=> Float
881
+ # resp.summary.data_source #=> String
882
+ # resp.summary.distance #=> Float
883
+ # resp.summary.distance_unit #=> String, one of "Kilometers", "Miles"
884
+ # resp.summary.duration_seconds #=> Float
885
+ # resp.summary.route_b_box #=> Array
886
+ # resp.summary.route_b_box[0] #=> Float
887
+ #
888
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CalculateRoute AWS API Documentation
889
+ #
890
+ # @overload calculate_route(params = {})
891
+ # @param [Hash] params ({})
892
+ def calculate_route(params = {}, options = {})
893
+ req = build_request(:calculate_route, params)
894
+ req.send_request(options)
895
+ end
896
+
613
897
  # Creates a geofence collection, which manages and stores geofences.
614
898
  #
615
899
  # @option params [required, String] :collection_name
@@ -617,7 +901,7 @@ module Aws::LocationService
617
901
  #
618
902
  # Requirements:
619
903
  #
620
- # * Contain only alphanumeric characters (A–Z, a–z, 0-9), hyphens (-),
904
+ # * Contain only alphanumeric characters (A–Z, a–z, 09), hyphens (-),
621
905
  # periods (.), and underscores (\_).
622
906
  #
623
907
  # * Must be a unique geofence collection name.
@@ -627,8 +911,16 @@ module Aws::LocationService
627
911
  # @option params [String] :description
628
912
  # An optional description for the geofence collection.
629
913
  #
914
+ # @option params [String] :kms_key_id
915
+ # A key identifier for an [AWS KMS customer managed key][1]. Enter a key
916
+ # ID, key ARN, alias name, or alias ARN.
917
+ #
918
+ #
919
+ #
920
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
921
+ #
630
922
  # @option params [required, String] :pricing_plan
631
- # Specifies the pricing plan for your geofence collection.
923
+ # Specifies the pricing plan for the geofence collection.
632
924
  #
633
925
  # For additional details and restrictions on each pricing plan option,
634
926
  # see the [Amazon Location Service pricing page][1].
@@ -638,19 +930,49 @@ module Aws::LocationService
638
930
  # [1]: https://aws.amazon.com/location/pricing/
639
931
  #
640
932
  # @option params [String] :pricing_plan_data_source
641
- # Specifies the plan data source. Required if the Mobile Asset Tracking
642
- # (MAT) or the Mobile Asset Management (MAM) pricing plan is selected.
933
+ # Specifies the data provider for the geofence collection.
934
+ #
935
+ # * Required value for the following pricing plans: `MobileAssetTracking
936
+ # `\| `MobileAssetManagement`
937
+ #
938
+ # ^
939
+ #
940
+ # For more information about [Data Providers][1], and [Pricing
941
+ # plans][2], see the Amazon Location Service product page.
643
942
  #
644
- # Billing is determined by the resource usage, the associated pricing
645
- # plan, and the data source that was specified. For more information
646
- # about each pricing plan option and restrictions, see the [Amazon
647
- # Location Service pricing page][1].
943
+ # <note markdown="1"> Amazon Location Service only uses `PricingPlanDataSource` to calculate
944
+ # billing for your geofence collection. Your data won't be shared with
945
+ # the data provider, and will remain in your AWS account or Region
946
+ # unless you move it.
947
+ #
948
+ # </note>
648
949
  #
649
950
  # Valid Values: `Esri `\| `Here`
650
951
  #
651
952
  #
652
953
  #
653
- # [1]: https://aws.amazon.com/location/pricing/
954
+ # [1]: https://aws.amazon.com/location/data-providers/
955
+ # [2]: https://aws.amazon.com/location/pricing/
956
+ #
957
+ # @option params [Hash<String,String>] :tags
958
+ # Applies one or more tags to the geofence collection. A tag is a
959
+ # key-value pair helps manage, identify, search, and filter your
960
+ # resources by labelling them.
961
+ #
962
+ # Format: `"key" : "value"`
963
+ #
964
+ # Restrictions:
965
+ #
966
+ # * Maximum 50 tags per resource
967
+ #
968
+ # * Each resource tag must be unique with a maximum of one value.
969
+ #
970
+ # * Maximum key length: 128 Unicode characters in UTF-8
971
+ #
972
+ # * Maximum value length: 256 Unicode characters in UTF-8
973
+ #
974
+ # * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
975
+ # characters: + - = . \_ : / @.
654
976
  #
655
977
  # @return [Types::CreateGeofenceCollectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
656
978
  #
@@ -663,8 +985,12 @@ module Aws::LocationService
663
985
  # resp = client.create_geofence_collection({
664
986
  # collection_name: "ResourceName", # required
665
987
  # description: "ResourceDescription",
988
+ # kms_key_id: "KmsKeyId",
666
989
  # pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
667
990
  # pricing_plan_data_source: "String",
991
+ # tags: {
992
+ # "TagKey" => "TagValue",
993
+ # },
668
994
  # })
669
995
  #
670
996
  # @example Response structure
@@ -685,17 +1011,6 @@ module Aws::LocationService
685
1011
  # Creates a map resource in your AWS account, which provides map tiles
686
1012
  # of different styles sourced from global location data providers.
687
1013
  #
688
- # <note markdown="1"> By using Maps, you agree that AWS may transmit your API queries to
689
- # your selected third party provider for processing, which may be
690
- # outside the AWS region you are currently using. For more information,
691
- # see the [AWS Service Terms][1] for Amazon Location Service.
692
- #
693
- # </note>
694
- #
695
- #
696
- #
697
- # [1]: https://aws.amazon.com/service-terms/
698
- #
699
1014
  # @option params [required, Types::MapConfiguration] :configuration
700
1015
  # Specifies the map style selected from an available data provider.
701
1016
  #
@@ -724,6 +1039,26 @@ module Aws::LocationService
724
1039
  #
725
1040
  # [1]: https://aws.amazon.com/location/pricing/
726
1041
  #
1042
+ # @option params [Hash<String,String>] :tags
1043
+ # Applies one or more tags to the map resource. A tag is a key-value
1044
+ # pair helps manage, identify, search, and filter your resources by
1045
+ # labelling them.
1046
+ #
1047
+ # Format: `"key" : "value"`
1048
+ #
1049
+ # Restrictions:
1050
+ #
1051
+ # * Maximum 50 tags per resource
1052
+ #
1053
+ # * Each resource tag must be unique with a maximum of one value.
1054
+ #
1055
+ # * Maximum key length: 128 Unicode characters in UTF-8
1056
+ #
1057
+ # * Maximum value length: 256 Unicode characters in UTF-8
1058
+ #
1059
+ # * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
1060
+ # characters: + - = . \_ : / @.
1061
+ #
727
1062
  # @return [Types::CreateMapResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
728
1063
  #
729
1064
  # * {Types::CreateMapResponse#create_time #create_time} => Time
@@ -739,6 +1074,9 @@ module Aws::LocationService
739
1074
  # description: "ResourceDescription",
740
1075
  # map_name: "ResourceName", # required
741
1076
  # pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
1077
+ # tags: {
1078
+ # "TagKey" => "TagValue",
1079
+ # },
742
1080
  # })
743
1081
  #
744
1082
  # @example Response structure
@@ -756,23 +1094,8 @@ module Aws::LocationService
756
1094
  req.send_request(options)
757
1095
  end
758
1096
 
759
- # Creates a Place index resource in your AWS account, which supports
760
- # Places functions with geospatial data sourced from your chosen data
761
- # provider.
762
- #
763
- # <note markdown="1"> By using Places, you agree that AWS may transmit your API queries to
764
- # your selected third party provider for processing, which may be
765
- # outside the AWS region you are currently using.
766
- #
767
- # Because of licensing limitations, you may not use HERE to store
768
- # results for locations in Japan. For more information, see the [AWS
769
- # Service Terms][1] for Amazon Location Service.
770
- #
771
- # </note>
772
- #
773
- #
774
- #
775
- # [1]: https://aws.amazon.com/service-terms/
1097
+ # Creates a place index resource in your AWS account, which supports
1098
+ # functions with geospatial data sourced from your chosen data provider.
776
1099
  #
777
1100
  # @option params [required, String] :data_source
778
1101
  # Specifies the data provider of geospatial data.
@@ -788,33 +1111,39 @@ module Aws::LocationService
788
1111
  #
789
1112
  # * `Here`
790
1113
  #
1114
+ # Place index resources using HERE as a data provider can't be used
1115
+ # to [store][1] results for locations in Japan. For more information,
1116
+ # see the [AWS Service Terms][2] for Amazon Location Service.
1117
+ #
791
1118
  # For additional details on data providers, see the [Amazon Location
792
- # Service data providers page][1].
1119
+ # Service data providers page][3].
793
1120
  #
794
1121
  #
795
1122
  #
796
- # [1]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
1123
+ # [1]: https://docs.aws.amazon.com/location-places/latest/APIReference/API_DataSourceConfiguration.html
1124
+ # [2]: https://aws.amazon.com/service-terms/
1125
+ # [3]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
797
1126
  #
798
1127
  # @option params [Types::DataSourceConfiguration] :data_source_configuration
799
1128
  # Specifies the data storage option for requesting Places.
800
1129
  #
801
1130
  # @option params [String] :description
802
- # The optional description for the Place index resource.
1131
+ # The optional description for the place index resource.
803
1132
  #
804
1133
  # @option params [required, String] :index_name
805
- # The name of the Place index resource.
1134
+ # The name of the place index resource.
806
1135
  #
807
1136
  # Requirements:
808
1137
  #
809
- # * Contain only alphanumeric characters (A-Z, a-z, 0-9) , hyphens (-),
1138
+ # * Contain only alphanumeric characters (AZ, az, 09), hyphens (-),
810
1139
  # periods (.), and underscores (\_).
811
1140
  #
812
- # * Must be a unique Place index resource name.
1141
+ # * Must be a unique place index resource name.
813
1142
  #
814
1143
  # * No spaces allowed. For example, `ExamplePlaceIndex`.
815
1144
  #
816
1145
  # @option params [required, String] :pricing_plan
817
- # Specifies the pricing plan for your Place index resource.
1146
+ # Specifies the pricing plan for your place index resource.
818
1147
  #
819
1148
  # For additional details and restrictions on each pricing plan option,
820
1149
  # see the [Amazon Location Service pricing page][1].
@@ -823,6 +1152,26 @@ module Aws::LocationService
823
1152
  #
824
1153
  # [1]: https://aws.amazon.com/location/pricing/
825
1154
  #
1155
+ # @option params [Hash<String,String>] :tags
1156
+ # Applies one or more tags to the place index resource. A tag is a
1157
+ # key-value pair helps manage, identify, search, and filter your
1158
+ # resources by labelling them.
1159
+ #
1160
+ # Format: `"key" : "value"`
1161
+ #
1162
+ # Restrictions:
1163
+ #
1164
+ # * Maximum 50 tags per resource
1165
+ #
1166
+ # * Each resource tag must be unique with a maximum of one value.
1167
+ #
1168
+ # * Maximum key length: 128 Unicode characters in UTF-8
1169
+ #
1170
+ # * Maximum value length: 256 Unicode characters in UTF-8
1171
+ #
1172
+ # * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
1173
+ # characters: + - = . \_ : / @.
1174
+ #
826
1175
  # @return [Types::CreatePlaceIndexResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
827
1176
  #
828
1177
  # * {Types::CreatePlaceIndexResponse#create_time #create_time} => Time
@@ -839,6 +1188,9 @@ module Aws::LocationService
839
1188
  # description: "ResourceDescription",
840
1189
  # index_name: "ResourceName", # required
841
1190
  # pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
1191
+ # tags: {
1192
+ # "TagKey" => "TagValue",
1193
+ # },
842
1194
  # })
843
1195
  #
844
1196
  # @example Response structure
@@ -856,14 +1208,127 @@ module Aws::LocationService
856
1208
  req.send_request(options)
857
1209
  end
858
1210
 
1211
+ # Creates a route calculator resource in your AWS account.
1212
+ #
1213
+ # You can send requests to a route calculator resource to estimate
1214
+ # travel time, distance, and get directions. A route calculator sources
1215
+ # traffic and road network data from your chosen data provider.
1216
+ #
1217
+ # @option params [required, String] :calculator_name
1218
+ # The name of the route calculator resource.
1219
+ #
1220
+ # Requirements:
1221
+ #
1222
+ # * Can use alphanumeric characters (A–Z, a–z, 0–9) , hyphens (-),
1223
+ # periods (.), and underscores (\_).
1224
+ #
1225
+ # * Must be a unique Route calculator resource name.
1226
+ #
1227
+ # * No spaces allowed. For example, `ExampleRouteCalculator`.
1228
+ #
1229
+ # @option params [required, String] :data_source
1230
+ # Specifies the data provider of traffic and road network data.
1231
+ #
1232
+ # <note markdown="1"> This field is case-sensitive. Enter the valid values as shown. For
1233
+ # example, entering `HERE` returns an error.
1234
+ #
1235
+ # </note>
1236
+ #
1237
+ # Valid Values: `Esri` \| `Here`
1238
+ #
1239
+ # For more information about data providers, see [Amazon Location
1240
+ # Service data providers][1].
1241
+ #
1242
+ #
1243
+ #
1244
+ # [1]: https://docs.aws.amazon.com/location/latest/developerguide/what-is-data-provider.html
1245
+ #
1246
+ # @option params [String] :description
1247
+ # The optional description for the route calculator resource.
1248
+ #
1249
+ # @option params [required, String] :pricing_plan
1250
+ # Specifies the pricing plan for your route calculator resource.
1251
+ #
1252
+ # For additional details and restrictions on each pricing plan option,
1253
+ # see [Amazon Location Service pricing][1].
1254
+ #
1255
+ #
1256
+ #
1257
+ # [1]: https://aws.amazon.com/location/pricing/
1258
+ #
1259
+ # @option params [Hash<String,String>] :tags
1260
+ # Applies one or more tags to the route calculator resource. A tag is a
1261
+ # key-value pair helps manage, identify, search, and filter your
1262
+ # resources by labelling them.
1263
+ #
1264
+ # * For example: \\\{ `"tag1" : "value1"`, `"tag2" : "value2"`\\}
1265
+ #
1266
+ # ^
1267
+ #
1268
+ # Format: `"key" : "value"`
1269
+ #
1270
+ # Restrictions:
1271
+ #
1272
+ # * Maximum 50 tags per resource
1273
+ #
1274
+ # * Each resource tag must be unique with a maximum of one value.
1275
+ #
1276
+ # * Maximum key length: 128 Unicode characters in UTF-8
1277
+ #
1278
+ # * Maximum value length: 256 Unicode characters in UTF-8
1279
+ #
1280
+ # * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
1281
+ # characters: + - = . \_ : / @.
1282
+ #
1283
+ # @return [Types::CreateRouteCalculatorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1284
+ #
1285
+ # * {Types::CreateRouteCalculatorResponse#calculator_arn #calculator_arn} => String
1286
+ # * {Types::CreateRouteCalculatorResponse#calculator_name #calculator_name} => String
1287
+ # * {Types::CreateRouteCalculatorResponse#create_time #create_time} => Time
1288
+ #
1289
+ # @example Request syntax with placeholder values
1290
+ #
1291
+ # resp = client.create_route_calculator({
1292
+ # calculator_name: "ResourceName", # required
1293
+ # data_source: "String", # required
1294
+ # description: "ResourceDescription",
1295
+ # pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
1296
+ # tags: {
1297
+ # "TagKey" => "TagValue",
1298
+ # },
1299
+ # })
1300
+ #
1301
+ # @example Response structure
1302
+ #
1303
+ # resp.calculator_arn #=> String
1304
+ # resp.calculator_name #=> String
1305
+ # resp.create_time #=> Time
1306
+ #
1307
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/CreateRouteCalculator AWS API Documentation
1308
+ #
1309
+ # @overload create_route_calculator(params = {})
1310
+ # @param [Hash] params ({})
1311
+ def create_route_calculator(params = {}, options = {})
1312
+ req = build_request(:create_route_calculator, params)
1313
+ req.send_request(options)
1314
+ end
1315
+
859
1316
  # Creates a tracker resource in your AWS account, which lets you
860
1317
  # retrieve current and historical location of devices.
861
1318
  #
862
1319
  # @option params [String] :description
863
1320
  # An optional description for the tracker resource.
864
1321
  #
1322
+ # @option params [String] :kms_key_id
1323
+ # A key identifier for an [AWS KMS customer managed key][1]. Enter a key
1324
+ # ID, key ARN, alias name, or alias ARN.
1325
+ #
1326
+ #
1327
+ #
1328
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html
1329
+ #
865
1330
  # @option params [required, String] :pricing_plan
866
- # Specifies the pricing plan for your tracker resource.
1331
+ # Specifies the pricing plan for the tracker resource.
867
1332
  #
868
1333
  # For additional details and restrictions on each pricing plan option,
869
1334
  # see the [Amazon Location Service pricing page][1].
@@ -873,19 +1338,49 @@ module Aws::LocationService
873
1338
  # [1]: https://aws.amazon.com/location/pricing/
874
1339
  #
875
1340
  # @option params [String] :pricing_plan_data_source
876
- # Specifies the plan data source. Required if the Mobile Asset Tracking
877
- # (MAT) or the Mobile Asset Management (MAM) pricing plan is selected.
1341
+ # Specifies the data provider for the tracker resource.
1342
+ #
1343
+ # * Required value for the following pricing plans: `MobileAssetTracking
1344
+ # `\| `MobileAssetManagement`
1345
+ #
1346
+ # ^
1347
+ #
1348
+ # For more information about [Data Providers][1], and [Pricing
1349
+ # plans][2], see the Amazon Location Service product page.
878
1350
  #
879
- # Billing is determined by the resource usage, the associated pricing
880
- # plan, and data source that was specified. For more information about
881
- # each pricing plan option and restrictions, see the [Amazon Location
882
- # Service pricing page][1].
1351
+ # <note markdown="1"> Amazon Location Service only uses `PricingPlanDataSource` to calculate
1352
+ # billing for your tracker resource. Your data will not be shared with
1353
+ # the data provider, and will remain in your AWS account or Region
1354
+ # unless you move it.
1355
+ #
1356
+ # </note>
883
1357
  #
884
1358
  # Valid Values: `Esri` \| `Here`
885
1359
  #
886
1360
  #
887
1361
  #
888
- # [1]: https://aws.amazon.com/location/pricing/
1362
+ # [1]: https://aws.amazon.com/location/data-providers/
1363
+ # [2]: https://aws.amazon.com/location/pricing/
1364
+ #
1365
+ # @option params [Hash<String,String>] :tags
1366
+ # Applies one or more tags to the tracker resource. A tag is a key-value
1367
+ # pair helps manage, identify, search, and filter your resources by
1368
+ # labelling them.
1369
+ #
1370
+ # Format: `"key" : "value"`
1371
+ #
1372
+ # Restrictions:
1373
+ #
1374
+ # * Maximum 50 tags per resource
1375
+ #
1376
+ # * Each resource tag must be unique with a maximum of one value.
1377
+ #
1378
+ # * Maximum key length: 128 Unicode characters in UTF-8
1379
+ #
1380
+ # * Maximum value length: 256 Unicode characters in UTF-8
1381
+ #
1382
+ # * Can use alphanumeric characters (A–Z, a–z, 0–9), and the following
1383
+ # characters: + - = . \_ : / @.
889
1384
  #
890
1385
  # @option params [required, String] :tracker_name
891
1386
  # The name for the tracker resource.
@@ -909,8 +1404,12 @@ module Aws::LocationService
909
1404
  #
910
1405
  # resp = client.create_tracker({
911
1406
  # description: "ResourceDescription",
1407
+ # kms_key_id: "KmsKeyId",
912
1408
  # pricing_plan: "RequestBasedUsage", # required, accepts RequestBasedUsage, MobileAssetTracking, MobileAssetManagement
913
1409
  # pricing_plan_data_source: "String",
1410
+ # tags: {
1411
+ # "TagKey" => "TagValue",
1412
+ # },
914
1413
  # tracker_name: "ResourceName", # required
915
1414
  # })
916
1415
  #
@@ -931,9 +1430,9 @@ module Aws::LocationService
931
1430
 
932
1431
  # Deletes a geofence collection from your AWS account.
933
1432
  #
934
- # <note markdown="1"> This action deletes the resource permanently. You can't undo this
935
- # action. If the geofence collection is the target of a tracker
936
- # resource, the devices will no longer be monitored.
1433
+ # <note markdown="1"> This operation deletes the resource permanently. If the geofence
1434
+ # collection is the target of a tracker resource, the devices will no
1435
+ # longer be monitored.
937
1436
  #
938
1437
  # </note>
939
1438
  #
@@ -959,9 +1458,8 @@ module Aws::LocationService
959
1458
 
960
1459
  # Deletes a map resource from your AWS account.
961
1460
  #
962
- # <note markdown="1"> This action deletes the resource permanently. You cannot undo this
963
- # action. If the map is being used in an application, the map may not
964
- # render.
1461
+ # <note markdown="1"> This operation deletes the resource permanently. If the map is being
1462
+ # used in an application, the map may not render.
965
1463
  #
966
1464
  # </note>
967
1465
  #
@@ -985,15 +1483,14 @@ module Aws::LocationService
985
1483
  req.send_request(options)
986
1484
  end
987
1485
 
988
- # Deletes a Place index resource from your AWS account.
1486
+ # Deletes a place index resource from your AWS account.
989
1487
  #
990
- # <note markdown="1"> This action deletes the resource permanently. You cannot undo this
991
- # action.
1488
+ # <note markdown="1"> This operation deletes the resource permanently.
992
1489
  #
993
1490
  # </note>
994
1491
  #
995
1492
  # @option params [required, String] :index_name
996
- # The name of the Place index resource to be deleted.
1493
+ # The name of the place index resource to be deleted.
997
1494
  #
998
1495
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
999
1496
  #
@@ -1012,12 +1509,37 @@ module Aws::LocationService
1012
1509
  req.send_request(options)
1013
1510
  end
1014
1511
 
1512
+ # Deletes a route calculator resource from your AWS account.
1513
+ #
1514
+ # <note markdown="1"> This operation deletes the resource permanently.
1515
+ #
1516
+ # </note>
1517
+ #
1518
+ # @option params [required, String] :calculator_name
1519
+ # The name of the route calculator resource to be deleted.
1520
+ #
1521
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1522
+ #
1523
+ # @example Request syntax with placeholder values
1524
+ #
1525
+ # resp = client.delete_route_calculator({
1526
+ # calculator_name: "ResourceName", # required
1527
+ # })
1528
+ #
1529
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DeleteRouteCalculator AWS API Documentation
1530
+ #
1531
+ # @overload delete_route_calculator(params = {})
1532
+ # @param [Hash] params ({})
1533
+ def delete_route_calculator(params = {}, options = {})
1534
+ req = build_request(:delete_route_calculator, params)
1535
+ req.send_request(options)
1536
+ end
1537
+
1015
1538
  # Deletes a tracker resource from your AWS account.
1016
1539
  #
1017
- # <note markdown="1"> This action deletes the resource permanently. You can't undo this
1018
- # action. If the tracker resource is in use, you may encounter an error.
1019
- # Make sure that the target resource is not a dependency for your
1020
- # applications.
1540
+ # <note markdown="1"> This operation deletes the resource permanently. If the tracker
1541
+ # resource is in use, you may encounter an error. Make sure that the
1542
+ # target resource isn't a dependency for your applications.
1021
1543
  #
1022
1544
  # </note>
1023
1545
  #
@@ -1052,8 +1574,10 @@ module Aws::LocationService
1052
1574
  # * {Types::DescribeGeofenceCollectionResponse#collection_name #collection_name} => String
1053
1575
  # * {Types::DescribeGeofenceCollectionResponse#create_time #create_time} => Time
1054
1576
  # * {Types::DescribeGeofenceCollectionResponse#description #description} => String
1577
+ # * {Types::DescribeGeofenceCollectionResponse#kms_key_id #kms_key_id} => String
1055
1578
  # * {Types::DescribeGeofenceCollectionResponse#pricing_plan #pricing_plan} => String
1056
1579
  # * {Types::DescribeGeofenceCollectionResponse#pricing_plan_data_source #pricing_plan_data_source} => String
1580
+ # * {Types::DescribeGeofenceCollectionResponse#tags #tags} => Hash&lt;String,String&gt;
1057
1581
  # * {Types::DescribeGeofenceCollectionResponse#update_time #update_time} => Time
1058
1582
  #
1059
1583
  # @example Request syntax with placeholder values
@@ -1068,8 +1592,11 @@ module Aws::LocationService
1068
1592
  # resp.collection_name #=> String
1069
1593
  # resp.create_time #=> Time
1070
1594
  # resp.description #=> String
1595
+ # resp.kms_key_id #=> String
1071
1596
  # resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
1072
1597
  # resp.pricing_plan_data_source #=> String
1598
+ # resp.tags #=> Hash
1599
+ # resp.tags["TagKey"] #=> String
1073
1600
  # resp.update_time #=> Time
1074
1601
  #
1075
1602
  # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DescribeGeofenceCollection AWS API Documentation
@@ -1095,6 +1622,7 @@ module Aws::LocationService
1095
1622
  # * {Types::DescribeMapResponse#map_arn #map_arn} => String
1096
1623
  # * {Types::DescribeMapResponse#map_name #map_name} => String
1097
1624
  # * {Types::DescribeMapResponse#pricing_plan #pricing_plan} => String
1625
+ # * {Types::DescribeMapResponse#tags #tags} => Hash&lt;String,String&gt;
1098
1626
  # * {Types::DescribeMapResponse#update_time #update_time} => Time
1099
1627
  #
1100
1628
  # @example Request syntax with placeholder values
@@ -1112,6 +1640,8 @@ module Aws::LocationService
1112
1640
  # resp.map_arn #=> String
1113
1641
  # resp.map_name #=> String
1114
1642
  # resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
1643
+ # resp.tags #=> Hash
1644
+ # resp.tags["TagKey"] #=> String
1115
1645
  # resp.update_time #=> Time
1116
1646
  #
1117
1647
  # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DescribeMap AWS API Documentation
@@ -1123,10 +1653,10 @@ module Aws::LocationService
1123
1653
  req.send_request(options)
1124
1654
  end
1125
1655
 
1126
- # Retrieves the Place index resource details.
1656
+ # Retrieves the place index resource details.
1127
1657
  #
1128
1658
  # @option params [required, String] :index_name
1129
- # The name of the Place index resource.
1659
+ # The name of the place index resource.
1130
1660
  #
1131
1661
  # @return [Types::DescribePlaceIndexResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1132
1662
  #
@@ -1137,6 +1667,7 @@ module Aws::LocationService
1137
1667
  # * {Types::DescribePlaceIndexResponse#index_arn #index_arn} => String
1138
1668
  # * {Types::DescribePlaceIndexResponse#index_name #index_name} => String
1139
1669
  # * {Types::DescribePlaceIndexResponse#pricing_plan #pricing_plan} => String
1670
+ # * {Types::DescribePlaceIndexResponse#tags #tags} => Hash&lt;String,String&gt;
1140
1671
  # * {Types::DescribePlaceIndexResponse#update_time #update_time} => Time
1141
1672
  #
1142
1673
  # @example Request syntax with placeholder values
@@ -1154,6 +1685,8 @@ module Aws::LocationService
1154
1685
  # resp.index_arn #=> String
1155
1686
  # resp.index_name #=> String
1156
1687
  # resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
1688
+ # resp.tags #=> Hash
1689
+ # resp.tags["TagKey"] #=> String
1157
1690
  # resp.update_time #=> Time
1158
1691
  #
1159
1692
  # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DescribePlaceIndex AWS API Documentation
@@ -1165,6 +1698,49 @@ module Aws::LocationService
1165
1698
  req.send_request(options)
1166
1699
  end
1167
1700
 
1701
+ # Retrieves the route calculator resource details.
1702
+ #
1703
+ # @option params [required, String] :calculator_name
1704
+ # The name of the route calculator resource.
1705
+ #
1706
+ # @return [Types::DescribeRouteCalculatorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1707
+ #
1708
+ # * {Types::DescribeRouteCalculatorResponse#calculator_arn #calculator_arn} => String
1709
+ # * {Types::DescribeRouteCalculatorResponse#calculator_name #calculator_name} => String
1710
+ # * {Types::DescribeRouteCalculatorResponse#create_time #create_time} => Time
1711
+ # * {Types::DescribeRouteCalculatorResponse#data_source #data_source} => String
1712
+ # * {Types::DescribeRouteCalculatorResponse#description #description} => String
1713
+ # * {Types::DescribeRouteCalculatorResponse#pricing_plan #pricing_plan} => String
1714
+ # * {Types::DescribeRouteCalculatorResponse#tags #tags} => Hash&lt;String,String&gt;
1715
+ # * {Types::DescribeRouteCalculatorResponse#update_time #update_time} => Time
1716
+ #
1717
+ # @example Request syntax with placeholder values
1718
+ #
1719
+ # resp = client.describe_route_calculator({
1720
+ # calculator_name: "ResourceName", # required
1721
+ # })
1722
+ #
1723
+ # @example Response structure
1724
+ #
1725
+ # resp.calculator_arn #=> String
1726
+ # resp.calculator_name #=> String
1727
+ # resp.create_time #=> Time
1728
+ # resp.data_source #=> String
1729
+ # resp.description #=> String
1730
+ # resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
1731
+ # resp.tags #=> Hash
1732
+ # resp.tags["TagKey"] #=> String
1733
+ # resp.update_time #=> Time
1734
+ #
1735
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/DescribeRouteCalculator AWS API Documentation
1736
+ #
1737
+ # @overload describe_route_calculator(params = {})
1738
+ # @param [Hash] params ({})
1739
+ def describe_route_calculator(params = {}, options = {})
1740
+ req = build_request(:describe_route_calculator, params)
1741
+ req.send_request(options)
1742
+ end
1743
+
1168
1744
  # Retrieves the tracker resource details.
1169
1745
  #
1170
1746
  # @option params [required, String] :tracker_name
@@ -1174,8 +1750,10 @@ module Aws::LocationService
1174
1750
  #
1175
1751
  # * {Types::DescribeTrackerResponse#create_time #create_time} => Time
1176
1752
  # * {Types::DescribeTrackerResponse#description #description} => String
1753
+ # * {Types::DescribeTrackerResponse#kms_key_id #kms_key_id} => String
1177
1754
  # * {Types::DescribeTrackerResponse#pricing_plan #pricing_plan} => String
1178
1755
  # * {Types::DescribeTrackerResponse#pricing_plan_data_source #pricing_plan_data_source} => String
1756
+ # * {Types::DescribeTrackerResponse#tags #tags} => Hash&lt;String,String&gt;
1179
1757
  # * {Types::DescribeTrackerResponse#tracker_arn #tracker_arn} => String
1180
1758
  # * {Types::DescribeTrackerResponse#tracker_name #tracker_name} => String
1181
1759
  # * {Types::DescribeTrackerResponse#update_time #update_time} => Time
@@ -1190,8 +1768,11 @@ module Aws::LocationService
1190
1768
  #
1191
1769
  # resp.create_time #=> Time
1192
1770
  # resp.description #=> String
1771
+ # resp.kms_key_id #=> String
1193
1772
  # resp.pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
1194
1773
  # resp.pricing_plan_data_source #=> String
1774
+ # resp.tags #=> Hash
1775
+ # resp.tags["TagKey"] #=> String
1195
1776
  # resp.tracker_arn #=> String
1196
1777
  # resp.tracker_name #=> String
1197
1778
  # resp.update_time #=> Time
@@ -1220,7 +1801,7 @@ module Aws::LocationService
1220
1801
  # a resource across all AWS.
1221
1802
  #
1222
1803
  # * Format example:
1223
- # `arn:partition:service:region:account-id:resource-type:resource-id`
1804
+ # `arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer`
1224
1805
  #
1225
1806
  # ^
1226
1807
  #
@@ -1248,7 +1829,7 @@ module Aws::LocationService
1248
1829
  # Retrieves a device's most recent position according to its sample
1249
1830
  # time.
1250
1831
  #
1251
- # <note markdown="1"> Device positions are deleted after one year.
1832
+ # <note markdown="1"> Device positions are deleted after 30 days.
1252
1833
  #
1253
1834
  # </note>
1254
1835
  #
@@ -1292,7 +1873,7 @@ module Aws::LocationService
1292
1873
  # Retrieves the device position history from a tracker resource within a
1293
1874
  # specified range of time.
1294
1875
  #
1295
- # <note markdown="1"> Device positions are deleted after 1 year.
1876
+ # <note markdown="1"> Device positions are deleted after 30 days.
1296
1877
  #
1297
1878
  # </note>
1298
1879
  #
@@ -1428,7 +2009,7 @@ module Aws::LocationService
1428
2009
  #
1429
2010
  # @option params [required, String] :font_unicode_range
1430
2011
  # A Unicode range of characters to download glyphs for. Each response
1431
- # will contain 256 characters. For example, 0-255 includes all
2012
+ # will contain 256 characters. For example, 0255 includes all
1432
2013
  # characters from range `U+0000` to `00FF`. Must be aligned to multiples
1433
2014
  # of 256.
1434
2015
  #
@@ -1546,7 +2127,7 @@ module Aws::LocationService
1546
2127
  end
1547
2128
 
1548
2129
  # Retrieves a vector data tile from the map resource. Map tiles are used
1549
- # by clients to render a map. They are addressed using a grid
2130
+ # by clients to render a map. they're addressed using a grid
1550
2131
  # arrangement with an X coordinate, Y coordinate, and Z (zoom) level.
1551
2132
  #
1552
2133
  # The origin (0, 0) is the top left of the map. Increasing the zoom
@@ -1594,6 +2175,55 @@ module Aws::LocationService
1594
2175
  req.send_request(options, &block)
1595
2176
  end
1596
2177
 
2178
+ # Lists the latest device positions for requested devices.
2179
+ #
2180
+ # @option params [Integer] :max_results
2181
+ # An optional limit for the number of entries returned in a single call.
2182
+ #
2183
+ # Default value: `100`
2184
+ #
2185
+ # @option params [String] :next_token
2186
+ # The pagination token specifying which page of results to return in the
2187
+ # response. If no token is provided, the default page is the first page.
2188
+ #
2189
+ # Default value: `null`
2190
+ #
2191
+ # @option params [required, String] :tracker_name
2192
+ # The tracker resource containing the requested devices.
2193
+ #
2194
+ # @return [Types::ListDevicePositionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2195
+ #
2196
+ # * {Types::ListDevicePositionsResponse#entries #entries} => Array&lt;Types::ListDevicePositionsResponseEntry&gt;
2197
+ # * {Types::ListDevicePositionsResponse#next_token #next_token} => String
2198
+ #
2199
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2200
+ #
2201
+ # @example Request syntax with placeholder values
2202
+ #
2203
+ # resp = client.list_device_positions({
2204
+ # max_results: 1,
2205
+ # next_token: "Token",
2206
+ # tracker_name: "ResourceName", # required
2207
+ # })
2208
+ #
2209
+ # @example Response structure
2210
+ #
2211
+ # resp.entries #=> Array
2212
+ # resp.entries[0].device_id #=> String
2213
+ # resp.entries[0].position #=> Array
2214
+ # resp.entries[0].position[0] #=> Float
2215
+ # resp.entries[0].sample_time #=> Time
2216
+ # resp.next_token #=> String
2217
+ #
2218
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/ListDevicePositions AWS API Documentation
2219
+ #
2220
+ # @overload list_device_positions(params = {})
2221
+ # @param [Hash] params ({})
2222
+ def list_device_positions(params = {}, options = {})
2223
+ req = build_request(:list_device_positions, params)
2224
+ req.send_request(options)
2225
+ end
2226
+
1597
2227
  # Lists geofence collections in your AWS account.
1598
2228
  #
1599
2229
  # @option params [Integer] :max_results
@@ -1737,7 +2367,7 @@ module Aws::LocationService
1737
2367
  req.send_request(options)
1738
2368
  end
1739
2369
 
1740
- # Lists Place index resources in your AWS account.
2370
+ # Lists place index resources in your AWS account.
1741
2371
  #
1742
2372
  # @option params [Integer] :max_results
1743
2373
  # An optional limit for the maximum number of results returned in a
@@ -1785,6 +2415,83 @@ module Aws::LocationService
1785
2415
  req.send_request(options)
1786
2416
  end
1787
2417
 
2418
+ # Lists route calculator resources in your AWS account.
2419
+ #
2420
+ # @option params [Integer] :max_results
2421
+ # An optional maximum number of results returned in a single call.
2422
+ #
2423
+ # Default Value: `100`
2424
+ #
2425
+ # @option params [String] :next_token
2426
+ # The pagination token specifying which page of results to return in the
2427
+ # response. If no token is provided, the default page is the first page.
2428
+ #
2429
+ # Default Value: `null`
2430
+ #
2431
+ # @return [Types::ListRouteCalculatorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2432
+ #
2433
+ # * {Types::ListRouteCalculatorsResponse#entries #entries} => Array&lt;Types::ListRouteCalculatorsResponseEntry&gt;
2434
+ # * {Types::ListRouteCalculatorsResponse#next_token #next_token} => String
2435
+ #
2436
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2437
+ #
2438
+ # @example Request syntax with placeholder values
2439
+ #
2440
+ # resp = client.list_route_calculators({
2441
+ # max_results: 1,
2442
+ # next_token: "Token",
2443
+ # })
2444
+ #
2445
+ # @example Response structure
2446
+ #
2447
+ # resp.entries #=> Array
2448
+ # resp.entries[0].calculator_name #=> String
2449
+ # resp.entries[0].create_time #=> Time
2450
+ # resp.entries[0].data_source #=> String
2451
+ # resp.entries[0].description #=> String
2452
+ # resp.entries[0].pricing_plan #=> String, one of "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement"
2453
+ # resp.entries[0].update_time #=> Time
2454
+ # resp.next_token #=> String
2455
+ #
2456
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/ListRouteCalculators AWS API Documentation
2457
+ #
2458
+ # @overload list_route_calculators(params = {})
2459
+ # @param [Hash] params ({})
2460
+ def list_route_calculators(params = {}, options = {})
2461
+ req = build_request(:list_route_calculators, params)
2462
+ req.send_request(options)
2463
+ end
2464
+
2465
+ # Returns the tags for the specified Amazon Location Service resource.
2466
+ #
2467
+ # @option params [required, String] :resource_arn
2468
+ # The Amazon Resource Name (ARN) of the resource whose tags you want to
2469
+ # retrieve.
2470
+ #
2471
+ # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2472
+ #
2473
+ # * {Types::ListTagsForResourceResponse#tags #tags} => Hash&lt;String,String&gt;
2474
+ #
2475
+ # @example Request syntax with placeholder values
2476
+ #
2477
+ # resp = client.list_tags_for_resource({
2478
+ # resource_arn: "Arn", # required
2479
+ # })
2480
+ #
2481
+ # @example Response structure
2482
+ #
2483
+ # resp.tags #=> Hash
2484
+ # resp.tags["TagKey"] #=> String
2485
+ #
2486
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/ListTagsForResource AWS API Documentation
2487
+ #
2488
+ # @overload list_tags_for_resource(params = {})
2489
+ # @param [Hash] params ({})
2490
+ def list_tags_for_resource(params = {}, options = {})
2491
+ req = build_request(:list_tags_for_resource, params)
2492
+ req.send_request(options)
2493
+ end
2494
+
1788
2495
  # Lists geofence collections currently associated to the given tracker
1789
2496
  # resource.
1790
2497
  #
@@ -1942,22 +2649,8 @@ module Aws::LocationService
1942
2649
  # Allows you to search for Places or points of interest near a given
1943
2650
  # position.
1944
2651
  #
1945
- # <note markdown="1"> By using Places, you agree that AWS may transmit your API queries to
1946
- # your selected third party provider for processing, which may be
1947
- # outside the AWS region you are currently using.
1948
- #
1949
- # Because of licensing limitations, you may not use HERE to store
1950
- # results for locations in Japan. For more information, see the [AWS
1951
- # Service Terms][1] for Amazon Location Service.
1952
- #
1953
- # </note>
1954
- #
1955
- #
1956
- #
1957
- # [1]: https://aws.amazon.com/service-terms/
1958
- #
1959
2652
  # @option params [required, String] :index_name
1960
- # The name of the Place index resource you want to use for the search.
2653
+ # The name of the place index resource you want to use for the search.
1961
2654
  #
1962
2655
  # @option params [Integer] :max_results
1963
2656
  # An optional paramer. The maximum number of results returned per
@@ -2028,22 +2721,6 @@ module Aws::LocationService
2028
2721
  #
2029
2722
  # </note>
2030
2723
  #
2031
- # <note markdown="1"> By using Places, you agree that AWS may transmit your API queries to
2032
- # your selected third party provider for processing, which may be
2033
- # outside the AWS region you are currently using.
2034
- #
2035
- # Also, when using HERE as your data provider, you may not (a) use HERE
2036
- # Places for Asset Management, or (b) select the `Storage` option for
2037
- # the `IntendedUse` parameter when requesting Places in Japan. For more
2038
- # information, see the [AWS Service Terms][1] for Amazon Location
2039
- # Service.
2040
- #
2041
- # </note>
2042
- #
2043
- #
2044
- #
2045
- # [1]: https://aws.amazon.com/service-terms/
2046
- #
2047
2724
  # @option params [Array<Float>] :bias_position
2048
2725
  # Searches for results closest to the given position. An optional
2049
2726
  # parameter defined by longitude, and latitude.
@@ -2092,7 +2769,7 @@ module Aws::LocationService
2092
2769
  # [1]: https://www.iso.org/iso-3166-country-codes.html
2093
2770
  #
2094
2771
  # @option params [required, String] :index_name
2095
- # The name of the Place index resource you want to use for the search.
2772
+ # The name of the place index resource you want to use for the search.
2096
2773
  #
2097
2774
  # @option params [Integer] :max_results
2098
2775
  # An optional parameter. The maximum number of results returned per
@@ -2155,6 +2832,67 @@ module Aws::LocationService
2155
2832
  req.send_request(options)
2156
2833
  end
2157
2834
 
2835
+ # Assigns one or more tags (key-value pairs) to the specified Amazon
2836
+ # Location Service resource.
2837
+ #
2838
+ # <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with certain tag values.</p> <p>Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.</p> <p>You can use the <code>TagResource</code> action with an Amazon Location Service resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the tags already associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value that you specify replaces the previous value for that tag. </p> <p>You can associate as many as 50 tags with a resource.</p>
2839
+ #
2840
+ # @option params [required, String] :resource_arn
2841
+ # The Amazon Resource Name (ARN) of the resource whose tags you want to
2842
+ # update.
2843
+ #
2844
+ # @option params [required, Hash<String,String>] :tags
2845
+ # The mapping from tag key to tag value for each tag associated with the
2846
+ # specified resource.
2847
+ #
2848
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2849
+ #
2850
+ # @example Request syntax with placeholder values
2851
+ #
2852
+ # resp = client.tag_resource({
2853
+ # resource_arn: "Arn", # required
2854
+ # tags: { # required
2855
+ # "TagKey" => "TagValue",
2856
+ # },
2857
+ # })
2858
+ #
2859
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/TagResource AWS API Documentation
2860
+ #
2861
+ # @overload tag_resource(params = {})
2862
+ # @param [Hash] params ({})
2863
+ def tag_resource(params = {}, options = {})
2864
+ req = build_request(:tag_resource, params)
2865
+ req.send_request(options)
2866
+ end
2867
+
2868
+ # Removes one or more tags from the specified Amazon Location Service
2869
+ # resource.
2870
+ #
2871
+ # @option params [required, String] :resource_arn
2872
+ # The Amazon Resource Name (ARN) of the resource from which you want to
2873
+ # remove tags.
2874
+ #
2875
+ # @option params [required, Array<String>] :tag_keys
2876
+ # The list of tag keys to remove from the resource.
2877
+ #
2878
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2879
+ #
2880
+ # @example Request syntax with placeholder values
2881
+ #
2882
+ # resp = client.untag_resource({
2883
+ # resource_arn: "Arn", # required
2884
+ # tag_keys: ["String"], # required
2885
+ # })
2886
+ #
2887
+ # @see http://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/UntagResource AWS API Documentation
2888
+ #
2889
+ # @overload untag_resource(params = {})
2890
+ # @param [Hash] params ({})
2891
+ def untag_resource(params = {}, options = {})
2892
+ req = build_request(:untag_resource, params)
2893
+ req.send_request(options)
2894
+ end
2895
+
2158
2896
  # @!endgroup
2159
2897
 
2160
2898
  # @param params ({})
@@ -2168,7 +2906,7 @@ module Aws::LocationService
2168
2906
  params: params,
2169
2907
  config: config)
2170
2908
  context[:gem_name] = 'aws-sdk-locationservice'
2171
- context[:gem_version] = '1.3.0'
2909
+ context[:gem_version] = '1.4.0'
2172
2910
  Seahorse::Client::Request.new(handlers, context)
2173
2911
  end
2174
2912