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

Co-authored-by: Tyler Roach <[email protected]>
Co-authored-by: Michael Law <[email protected]>

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.
@@ -1079,6 +1079,48 @@ DisassociateTrackerConsumerResult disassociateTrackerConsumer(
             DisassociateTrackerConsumerRequest disassociateTrackerConsumerRequest)
             throws AmazonClientException, AmazonServiceException;
 
+    /**
+     * <p>
+     * Evaluates device positions against geofence geometries from a given
+     * geofence collection. The event forecasts three states for which a device
+     * can be in relative to a geofence:
+     * </p>
+     * <p>
+     * <code>ENTER</code>: If a device is outside of a geofence, but would
+     * breach the fence if the device is moving at its current speed within time
+     * horizon window.
+     * </p>
+     * <p>
+     * <code>EXIT</code>: If a device is inside of a geofence, but would breach
+     * the fence if the device is moving at its current speed within time
+     * horizon window.
+     * </p>
+     * <p>
+     * <code>IDLE</code>: If a device is inside of a geofence, and the device is
+     * not moving.
+     * </p>
+     * 
+     * @param forecastGeofenceEventsRequest
+     * @return forecastGeofenceEventsResult The response from the
+     *         ForecastGeofenceEvents service method, as returned by AWS
+     *         Location service.
+     * @throws InternalServerException
+     * @throws ResourceNotFoundException
+     * @throws AccessDeniedException
+     * @throws ValidationException
+     * @throws ThrottlingException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by AWS
+     *             Location service indicating either a problem with the data in
+     *             the request, or a server side issue.
+     */
+    ForecastGeofenceEventsResult forecastGeofenceEvents(
+            ForecastGeofenceEventsRequest forecastGeofenceEventsRequest)
+            throws AmazonClientException, AmazonServiceException;
+
     /**
      * <p>
      * Retrieves a device's most recent position according to its sample time.
@@ -1144,6 +1186,12 @@ GetDevicePositionHistoryResult getDevicePositionHistory(
      * <p>
      * Retrieves the geofence details from a geofence collection.
      * </p>
+     * <note>
+     * <p>
+     * The returned geometry will always match the geometry format used when the
+     * geofence was created.
+     * </p>
+     * </note>
      * 
      * @param getGeofenceRequest
      * @return getGeofenceResult The response from the GetGeofence service
@@ -1921,6 +1969,34 @@ UpdateRouteCalculatorResult updateRouteCalculator(
     UpdateTrackerResult updateTracker(UpdateTrackerRequest updateTrackerRequest)
             throws AmazonClientException, AmazonServiceException;
 
+    /**
+     * <p>
+     * Verifies the integrity of the device's position by determining if it was
+     * reported behind a proxy, and by comparing it to an inferred position
+     * estimated based on the device's state.
+     * </p>
+     * 
+     * @param verifyDevicePositionRequest
+     * @return verifyDevicePositionResult The response from the
+     *         VerifyDevicePosition service method, as returned by AWS Location
+     *         service.
+     * @throws InternalServerException
+     * @throws ResourceNotFoundException
+     * @throws AccessDeniedException
+     * @throws ValidationException
+     * @throws ThrottlingException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by AWS
+     *             Location service indicating either a problem with the data in
+     *             the request, or a server side issue.
+     */
+    VerifyDevicePositionResult verifyDevicePosition(
+            VerifyDevicePositionRequest verifyDevicePositionRequest) throws AmazonClientException,
+            AmazonServiceException;
+
     /**
      * Shuts down this client object, releasing any resources that might be held
      * open. This is an optional method, and callers are not expected to call

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.
@@ -2088,6 +2088,75 @@ public DisassociateTrackerConsumerResult disassociateTrackerConsumer(
         }
     }
 
+    /**
+     * <p>
+     * Evaluates device positions against geofence geometries from a given
+     * geofence collection. The event forecasts three states for which a device
+     * can be in relative to a geofence:
+     * </p>
+     * <p>
+     * <code>ENTER</code>: If a device is outside of a geofence, but would
+     * breach the fence if the device is moving at its current speed within time
+     * horizon window.
+     * </p>
+     * <p>
+     * <code>EXIT</code>: If a device is inside of a geofence, but would breach
+     * the fence if the device is moving at its current speed within time
+     * horizon window.
+     * </p>
+     * <p>
+     * <code>IDLE</code>: If a device is inside of a geofence, and the device is
+     * not moving.
+     * </p>
+     * 
+     * @param forecastGeofenceEventsRequest
+     * @return forecastGeofenceEventsResult The response from the
+     *         ForecastGeofenceEvents service method, as returned by AWS
+     *         Location service.
+     * @throws InternalServerException
+     * @throws ResourceNotFoundException
+     * @throws AccessDeniedException
+     * @throws ValidationException
+     * @throws ThrottlingException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by AWS
+     *             Location service indicating either a problem with the data in
+     *             the request, or a server side issue.
+     */
+    public ForecastGeofenceEventsResult forecastGeofenceEvents(
+            ForecastGeofenceEventsRequest forecastGeofenceEventsRequest)
+            throws AmazonServiceException, AmazonClientException {
+        ExecutionContext executionContext = createExecutionContext(forecastGeofenceEventsRequest);
+        AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
+        awsRequestMetrics.startEvent(Field.ClientExecuteTime);
+        Request<ForecastGeofenceEventsRequest> request = null;
+        Response<ForecastGeofenceEventsResult> response = null;
+        try {
+            awsRequestMetrics.startEvent(Field.RequestMarshallTime);
+            try {
+                request = new ForecastGeofenceEventsRequestMarshaller()
+                        .marshall(forecastGeofenceEventsRequest);
+                // Binds the request metrics to the current request.
+                request.setAWSRequestMetrics(awsRequestMetrics);
+            } finally {
+                awsRequestMetrics.endEvent(Field.RequestMarshallTime);
+            }
+            Unmarshaller<ForecastGeofenceEventsResult, JsonUnmarshallerContext> unmarshaller = new ForecastGeofenceEventsResultJsonUnmarshaller();
+            JsonResponseHandler<ForecastGeofenceEventsResult> responseHandler = new JsonResponseHandler<ForecastGeofenceEventsResult>(
+                    unmarshaller);
+
+            response = invoke(request, responseHandler, executionContext);
+
+            return response.getAwsResponse();
+        } finally {
+            awsRequestMetrics.endEvent(Field.ClientExecuteTime);
+            endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
+        }
+    }
+
     /**
      * <p>
      * Retrieves a device's most recent position according to its sample time.
@@ -2208,6 +2277,12 @@ public GetDevicePositionHistoryResult getDevicePositionHistory(
      * <p>
      * Retrieves the geofence details from a geofence collection.
      * </p>
+     * <note>
+     * <p>
+     * The returned geometry will always match the geometry format used when the
+     * geofence was created.
+     * </p>
+     * </note>
      * 
      * @param getGeofenceRequest
      * @return getGeofenceResult The response from the GetGeofence service
@@ -3724,6 +3799,61 @@ public UpdateTrackerResult updateTracker(UpdateTrackerRequest updateTrackerReque
         }
     }
 
+    /**
+     * <p>
+     * Verifies the integrity of the device's position by determining if it was
+     * reported behind a proxy, and by comparing it to an inferred position
+     * estimated based on the device's state.
+     * </p>
+     * 
+     * @param verifyDevicePositionRequest
+     * @return verifyDevicePositionResult The response from the
+     *         VerifyDevicePosition service method, as returned by AWS Location
+     *         service.
+     * @throws InternalServerException
+     * @throws ResourceNotFoundException
+     * @throws AccessDeniedException
+     * @throws ValidationException
+     * @throws ThrottlingException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by AWS
+     *             Location service indicating either a problem with the data in
+     *             the request, or a server side issue.
+     */
+    public VerifyDevicePositionResult verifyDevicePosition(
+            VerifyDevicePositionRequest verifyDevicePositionRequest)
+            throws AmazonServiceException, AmazonClientException {
+        ExecutionContext executionContext = createExecutionContext(verifyDevicePositionRequest);
+        AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
+        awsRequestMetrics.startEvent(Field.ClientExecuteTime);
+        Request<VerifyDevicePositionRequest> request = null;
+        Response<VerifyDevicePositionResult> response = null;
+        try {
+            awsRequestMetrics.startEvent(Field.RequestMarshallTime);
+            try {
+                request = new VerifyDevicePositionRequestMarshaller()
+                        .marshall(verifyDevicePositionRequest);
+                // Binds the request metrics to the current request.
+                request.setAWSRequestMetrics(awsRequestMetrics);
+            } finally {
+                awsRequestMetrics.endEvent(Field.RequestMarshallTime);
+            }
+            Unmarshaller<VerifyDevicePositionResult, JsonUnmarshallerContext> unmarshaller = new VerifyDevicePositionResultJsonUnmarshaller();
+            JsonResponseHandler<VerifyDevicePositionResult> responseHandler = new JsonResponseHandler<VerifyDevicePositionResult>(
+                    unmarshaller);
+
+            response = invoke(request, responseHandler, executionContext);
+
+            return response.getAwsResponse();
+        } finally {
+            awsRequestMetrics.endEvent(Field.ClientExecuteTime);
+            endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
+        }
+    }
+
     /**
      * Returns additional metadata for a previously executed successful,
      * request, typically used for debugging issues where a service isn't acting

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.