feat(aws-android-sdk-location): update models to latest (#2658)

Co-authored-by: Rafael Juliano <[email protected]>

Author: awsmobilesdk

aws-android-sdk-location/src/main/java/com/amazonaws/services/geo/AmazonLocation.java

@@ -293,14 +293,22 @@ BatchPutGeofenceResult batchPutGeofence(BatchPutGeofenceRequest batchPutGeofence
     /**
      * <p>
      * Uploads position update data for one or more devices to a tracker
-     * resource. Amazon Location uses the data when reporting the last known
-     * device position and position history.
+     * resource. Amazon Location uses the data when it reports the last known
+     * device position and position history. Amazon Location retains location
+     * data for 30 days.
      * </p>
      * <note>
      * <p>
-     * Only one position update is stored per sample time. Location data is
-     * sampled at a fixed rate of one position per 30-second interval and
-     * retained for 30 days before it's deleted.
+     * Position updates are handled based on the <code>PositionFiltering</code>
+     * property of the tracker. When <code>PositionFiltering</code> is set to
+     * <code>TimeBased</code>, updates are evaluated against linked geofence
+     * collections, and location data is stored at a maximum of one position per
+     * 30 second interval. If your update frequency is more often than every 30
+     * seconds, only one update per 30 seconds is stored for each unique device
+     * ID. When <code>PositionFiltering</code> is set to
+     * <code>DistanceBased</code> filtering, location data is stored and
+     * evaluated against linked geofence collections only if the device has
+     * moved more than 30 m (98.4 ft).
      * </p>
      * </note>
      * 

aws-android-sdk-location/src/main/java/com/amazonaws/services/geo/AmazonLocationClient.java

@@ -719,14 +719,22 @@ public BatchPutGeofenceResult batchPutGeofence(BatchPutGeofenceRequest batchPutG
     /**
      * <p>
      * Uploads position update data for one or more devices to a tracker
-     * resource. Amazon Location uses the data when reporting the last known
-     * device position and position history.
+     * resource. Amazon Location uses the data when it reports the last known
+     * device position and position history. Amazon Location retains location
+     * data for 30 days.
      * </p>
      * <note>
      * <p>
-     * Only one position update is stored per sample time. Location data is
-     * sampled at a fixed rate of one position per 30-second interval and
-     * retained for 30 days before it's deleted.
+     * Position updates are handled based on the <code>PositionFiltering</code>
+     * property of the tracker. When <code>PositionFiltering</code> is set to
+     * <code>TimeBased</code>, updates are evaluated against linked geofence
+     * collections, and location data is stored at a maximum of one position per
+     * 30 second interval. If your update frequency is more often than every 30
+     * seconds, only one update per 30 seconds is stored for each unique device
+     * ID. When <code>PositionFiltering</code> is set to
+     * <code>DistanceBased</code> filtering, location data is stored and
+     * evaluated against linked geofence collections only if the device has
+     * moved more than 30 m (98.4 ft).
      * </p>
      * </note>
      * 

aws-android-sdk-location/src/main/java/com/amazonaws/services/geo/model/BatchUpdateDevicePositionRequest.java

@@ -22,14 +22,20 @@
 /**
  * <p>
  * Uploads position update data for one or more devices to a tracker resource.
- * Amazon Location uses the data when reporting the last known device position
- * and position history.
+ * Amazon Location uses the data when it reports the last known device position
+ * and position history. Amazon Location retains location data for 30 days.
  * </p>
  * <note>
  * <p>
- * Only one position update is stored per sample time. Location data is sampled
- * at a fixed rate of one position per 30-second interval and retained for 30
- * days before it's deleted.
+ * Position updates are handled based on the <code>PositionFiltering</code>
+ * property of the tracker. When <code>PositionFiltering</code> is set to
+ * <code>TimeBased</code>, updates are evaluated against linked geofence
+ * collections, and location data is stored at a maximum of one position per 30
+ * second interval. If your update frequency is more often than every 30
+ * seconds, only one update per 30 seconds is stored for each unique device ID.
+ * When <code>PositionFiltering</code> is set to <code>DistanceBased</code>
+ * filtering, location data is stored and evaluated against linked geofence
+ * collections only if the device has moved more than 30 m (98.4 ft).
  * </p>
  * </note>
  */

aws-android-sdk-location/src/main/java/com/amazonaws/services/geo/model/CalculateRouteRequest.java

@@ -125,7 +125,9 @@ public class CalculateRouteRequest extends AmazonWebServiceRequest implements Se
      * If you specify a departure that's not located on a road, Amazon Location
      * <a href=
      * "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     * >moves the position to the nearest road</a>.
+     * >moves the position to the nearest road</a>. If Esri is the provider for
+     * your route calculator, specifying a route that is longer than 400 km
+     * returns a <code>400 RoutesValidationException</code> error.
      * </p>
      * </note>
      * <p>
@@ -283,6 +285,11 @@ public class CalculateRouteRequest extends AmazonWebServiceRequest implements Se
      * Specifying more than 23 waypoints returns a
      * <code>400 ValidationException</code> error.
      * </p>
+     * <p>
+     * If Esri is the provider for your route calculator, specifying a route
+     * that is longer than 400 km returns a
+     * <code>400 RoutesValidationException</code> error.
+     * </p>
      * </note>
      * <p>
      * Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -572,7 +579,9 @@ public CalculateRouteRequest withDepartNow(Boolean departNow) {
      * If you specify a departure that's not located on a road, Amazon Location
      * <a href=
      * "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     * >moves the position to the nearest road</a>.
+     * >moves the position to the nearest road</a>. If Esri is the provider for
+     * your route calculator, specifying a route that is longer than 400 km
+     * returns a <code>400 RoutesValidationException</code> error.
      * </p>
      * </note>
      * <p>
@@ -596,7 +605,10 @@ public CalculateRouteRequest withDepartNow(Boolean departNow) {
      *         If you specify a departure that's not located on a road, Amazon
      *         Location <a href=
      *         "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     *         >moves the position to the nearest road</a>.
+     *         >moves the position to the nearest road</a>. If Esri is the
+     *         provider for your route calculator, specifying a route that is
+     *         longer than 400 km returns a
+     *         <code>400 RoutesValidationException</code> error.
      *         </p>
      *         </note>
      *         <p>
@@ -625,7 +637,9 @@ public java.util.List<Double> getDeparturePosition() {
      * If you specify a departure that's not located on a road, Amazon Location
      * <a href=
      * "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     * >moves the position to the nearest road</a>.
+     * >moves the position to the nearest road</a>. If Esri is the provider for
+     * your route calculator, specifying a route that is longer than 400 km
+     * returns a <code>400 RoutesValidationException</code> error.
      * </p>
      * </note>
      * <p>
@@ -649,7 +663,10 @@ public java.util.List<Double> getDeparturePosition() {
      *            If you specify a departure that's not located on a road,
      *            Amazon Location <a href=
      *            "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     *            >moves the position to the nearest road</a>.
+     *            >moves the position to the nearest road</a>. If Esri is the
+     *            provider for your route calculator, specifying a route that is
+     *            longer than 400 km returns a
+     *            <code>400 RoutesValidationException</code> error.
      *            </p>
      *            </note>
      *            <p>
@@ -683,7 +700,9 @@ public void setDeparturePosition(java.util.Collection<Double> departurePosition)
      * If you specify a departure that's not located on a road, Amazon Location
      * <a href=
      * "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     * >moves the position to the nearest road</a>.
+     * >moves the position to the nearest road</a>. If Esri is the provider for
+     * your route calculator, specifying a route that is longer than 400 km
+     * returns a <code>400 RoutesValidationException</code> error.
      * </p>
      * </note>
      * <p>
@@ -710,7 +729,10 @@ public void setDeparturePosition(java.util.Collection<Double> departurePosition)
      *            If you specify a departure that's not located on a road,
      *            Amazon Location <a href=
      *            "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     *            >moves the position to the nearest road</a>.
+     *            >moves the position to the nearest road</a>. If Esri is the
+     *            provider for your route calculator, specifying a route that is
+     *            longer than 400 km returns a
+     *            <code>400 RoutesValidationException</code> error.
      *            </p>
      *            </note>
      *            <p>
@@ -747,7 +769,9 @@ public CalculateRouteRequest withDeparturePosition(Double... departurePosition)
      * If you specify a departure that's not located on a road, Amazon Location
      * <a href=
      * "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     * >moves the position to the nearest road</a>.
+     * >moves the position to the nearest road</a>. If Esri is the provider for
+     * your route calculator, specifying a route that is longer than 400 km
+     * returns a <code>400 RoutesValidationException</code> error.
      * </p>
      * </note>
      * <p>
@@ -774,7 +798,10 @@ public CalculateRouteRequest withDeparturePosition(Double... departurePosition)
      *            If you specify a departure that's not located on a road,
      *            Amazon Location <a href=
      *            "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#snap-to-nearby-road"
-     *            >moves the position to the nearest road</a>.
+     *            >moves the position to the nearest road</a>. If Esri is the
+     *            provider for your route calculator, specifying a route that is
+     *            longer than 400 km returns a
+     *            <code>400 RoutesValidationException</code> error.
      *            </p>
      *            </note>
      *            <p>
@@ -1844,6 +1871,11 @@ public CalculateRouteRequest withTruckModeOptions(
      * Specifying more than 23 waypoints returns a
      * <code>400 ValidationException</code> error.
      * </p>
+     * <p>
+     * If Esri is the provider for your route calculator, specifying a route
+     * that is longer than 400 km returns a
+     * <code>400 RoutesValidationException</code> error.
+     * </p>
      * </note>
      * <p>
      * Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -1875,6 +1907,11 @@ public CalculateRouteRequest withTruckModeOptions(
      *         Specifying more than 23 waypoints returns a
      *         <code>400 ValidationException</code> error.
      *         </p>
+     *         <p>
+     *         If Esri is the provider for your route calculator, specifying a
+     *         route that is longer than 400 km returns a
+     *         <code>400 RoutesValidationException</code> error.
+     *         </p>
      *         </note>
      *         <p>
      *         Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -1910,6 +1947,11 @@ public java.util.List<java.util.List<Double>> getWaypointPositions() {
      * Specifying more than 23 waypoints returns a
      * <code>400 ValidationException</code> error.
      * </p>
+     * <p>
+     * If Esri is the provider for your route calculator, specifying a route
+     * that is longer than 400 km returns a
+     * <code>400 RoutesValidationException</code> error.
+     * </p>
      * </note>
      * <p>
      * Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -1941,6 +1983,11 @@ public java.util.List<java.util.List<Double>> getWaypointPositions() {
      *            Specifying more than 23 waypoints returns a
      *            <code>400 ValidationException</code> error.
      *            </p>
+     *            <p>
+     *            If Esri is the provider for your route calculator, specifying
+     *            a route that is longer than 400 km returns a
+     *            <code>400 RoutesValidationException</code> error.
+     *            </p>
      *            </note>
      *            <p>
      *            Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -1981,6 +2028,11 @@ public void setWaypointPositions(java.util.Collection<java.util.List<Double>> wa
      * Specifying more than 23 waypoints returns a
      * <code>400 ValidationException</code> error.
      * </p>
+     * <p>
+     * If Esri is the provider for your route calculator, specifying a route
+     * that is longer than 400 km returns a
+     * <code>400 RoutesValidationException</code> error.
+     * </p>
      * </note>
      * <p>
      * Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -2015,6 +2067,11 @@ public void setWaypointPositions(java.util.Collection<java.util.List<Double>> wa
      *            Specifying more than 23 waypoints returns a
      *            <code>400 ValidationException</code> error.
      *            </p>
+     *            <p>
+     *            If Esri is the provider for your route calculator, specifying
+     *            a route that is longer than 400 km returns a
+     *            <code>400 RoutesValidationException</code> error.
+     *            </p>
      *            </note>
      *            <p>
      *            Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -2059,6 +2116,11 @@ public CalculateRouteRequest withWaypointPositions(java.util.List<Double>... way
      * Specifying more than 23 waypoints returns a
      * <code>400 ValidationException</code> error.
      * </p>
+     * <p>
+     * If Esri is the provider for your route calculator, specifying a route
+     * that is longer than 400 km returns a
+     * <code>400 RoutesValidationException</code> error.
+     * </p>
      * </note>
      * <p>
      * Valid Values: <code>[-180 to 180,-90 to 90]</code>
@@ -2093,6 +2155,11 @@ public CalculateRouteRequest withWaypointPositions(java.util.List<Double>... way
      *            Specifying more than 23 waypoints returns a
      *            <code>400 ValidationException</code> error.
      *            </p>
+     *            <p>
+     *            If Esri is the provider for your route calculator, specifying
+     *            a route that is longer than 400 km returns a
+     *            <code>400 RoutesValidationException</code> error.
+     *            </p>
      *            </note>
      *            <p>
      *            Valid Values: <code>[-180 to 180,-90 to 90]</code>