aws-sdk-locationservice 1.3.0 → 1.4.0

Sign up to get free protection for your applications and to get access to all the features.
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