Skip to content

Commit 46f82f1

Browse files
awsmobilesdkpoojamat
awsmobilesdk
and
poojamat
authored
feat(aws-android-sdk-location): update models to latest (#2544)
Co-authored-by: poojamat <[email protected]>
1 parent e37db7e commit 46f82f1

File tree

48 files changed

+7326
-400
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+7326
-400
lines changed

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

Lines changed: 160 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,10 @@ public interface AmazonLocation {
9292
* resource. This allows the tracker resource to communicate location data
9393
* to the linked geofence collection.
9494
* </p>
95+
* <p>
96+
* You can associate up to five geofence collections to each tracker
97+
* resource.
98+
* </p>
9599
* <note>
96100
* <p>
97101
* Currently not supported — Cross-account configurations, such as creating
@@ -109,6 +113,7 @@ public interface AmazonLocation {
109113
* @throws ConflictException
110114
* @throws AccessDeniedException
111115
* @throws ValidationException
116+
* @throws ServiceQuotaExceededException
112117
* @throws ThrottlingException
113118
* @throws AmazonClientException If any internal errors are encountered
114119
* inside the client while attempting to make the request or
@@ -183,14 +188,32 @@ BatchDeleteGeofenceResult batchDeleteGeofence(
183188
/**
184189
* <p>
185190
* Evaluates device positions against the geofence geometries from a given
186-
* geofence collection. The evaluation determines if the device has entered
187-
* or exited a geofenced area, which publishes ENTER or EXIT geofence events
188-
* to Amazon EventBridge.
191+
* geofence collection.
192+
* </p>
193+
* <p>
194+
* This operation always returns an empty response because geofences are
195+
* asynchronously evaluated. The evaluation determines if the device has
196+
* entered or exited a geofenced area, and then publishes one of the
197+
* following events to Amazon EventBridge:
198+
* </p>
199+
* <ul>
200+
* <li>
201+
* <p>
202+
* <code>ENTER</code> if Amazon Location determines that the tracked device
203+
* has entered a geofenced area.
204+
* </p>
205+
* </li>
206+
* <li>
207+
* <p>
208+
* <code>EXIT</code> if Amazon Location determines that the tracked device
209+
* has exited a geofenced area.
189210
* </p>
211+
* </li>
212+
* </ul>
190213
* <note>
191214
* <p>
192-
* The last geofence that a device was observed within, if any, is tracked
193-
* for 30 days after the most recent device position update
215+
* The last geofence that a device was observed within is tracked for 30
216+
* days after the most recent device position update.
194217
* </p>
195218
* </note>
196219
*
@@ -217,7 +240,7 @@ BatchEvaluateGeofencesResult batchEvaluateGeofences(
217240

218241
/**
219242
* <p>
220-
* A batch request to retrieve all device positions.
243+
* Lists the latest device positions for requested devices.
221244
* </p>
222245
*
223246
* @param batchGetDevicePositionRequest
@@ -310,7 +333,7 @@ BatchUpdateDevicePositionResult batchUpdateDevicePosition(
310333
* <code>DeparturePostiton</code> and <code>DestinationPosition</code>.
311334
* Requires that you first <a href=
312335
* "https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html"
313-
* >create aroute calculator resource</a>
336+
* >create a route calculator resource</a>
314337
* </p>
315338
* <p>
316339
* By default, a request that doesn't specify a departure time uses the best
@@ -340,7 +363,7 @@ BatchUpdateDevicePositionResult batchUpdateDevicePosition(
340363
* <p>
341364
* <a href=
342365
* "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#travel-mode"
343-
* >Specifying a travel mode</a> using TravelMode. This lets you specify
366+
* >Specifying a travel mode</a> using TravelMode. This lets you specify an
344367
* additional route preference such as <code>CarModeOptions</code> if
345368
* traveling by <code>Car</code>, or <code>TruckModeOptions</code> if
346369
* traveling by <code>Truck</code>.
@@ -1014,7 +1037,7 @@ GetMapTileResult getMapTile(GetMapTileRequest getMapTileRequest) throws AmazonCl
10141037

10151038
/**
10161039
* <p>
1017-
* Lists the latest device positions for requested devices.
1040+
* A batch request to retrieve all device positions.
10181041
* </p>
10191042
*
10201043
* @param listDevicePositionsRequest
@@ -1159,7 +1182,8 @@ ListRouteCalculatorsResult listRouteCalculators(
11591182

11601183
/**
11611184
* <p>
1162-
* Returns the tags for the specified Amazon Location Service resource.
1185+
* Returns a list of tags that are applied to the specified Amazon Location
1186+
* resource.
11631187
* </p>
11641188
*
11651189
* @param listTagsForResourceRequest
@@ -1333,7 +1357,7 @@ SearchPlaceIndexForTextResult searchPlaceIndexForText(
13331357
* </p>
13341358
*
13351359
* <pre>
1336-
* <code> &lt;p&gt;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.&lt;/p&gt; &lt;p&gt;Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.&lt;/p&gt; &lt;p&gt;You can use the &lt;code&gt;TagResource&lt;/code&gt; 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. &lt;/p&gt; &lt;p&gt;You can associate as many as 50 tags with a resource.&lt;/p&gt; </code>
1360+
* <code> &lt;p&gt;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.&lt;/p&gt; &lt;p&gt;You can use the &lt;code&gt;TagResource&lt;/code&gt; operation 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's already associated with the resource, the new tag value that you specify replaces the previous value for that tag. &lt;/p&gt; &lt;p&gt;You can associate up to 50 tags with a resource.&lt;/p&gt; </code>
13371361
* </pre>
13381362
*
13391363
* @param tagResourceRequest
@@ -1357,8 +1381,7 @@ TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
13571381

13581382
/**
13591383
* <p>
1360-
* Removes one or more tags from the specified Amazon Location Service
1361-
* resource.
1384+
* Removes one or more tags from the specified Amazon Location resource.
13621385
* </p>
13631386
*
13641387
* @param untagResourceRequest
@@ -1380,6 +1403,130 @@ TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
13801403
UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
13811404
throws AmazonClientException, AmazonServiceException;
13821405

1406+
/**
1407+
* <p>
1408+
* Updates the specified properties of a given geofence collection.
1409+
* </p>
1410+
*
1411+
* @param updateGeofenceCollectionRequest
1412+
* @return updateGeofenceCollectionResult The response from the
1413+
* UpdateGeofenceCollection service method, as returned by AWS
1414+
* Location service.
1415+
* @throws InternalServerException
1416+
* @throws ResourceNotFoundException
1417+
* @throws AccessDeniedException
1418+
* @throws ValidationException
1419+
* @throws ThrottlingException
1420+
* @throws AmazonClientException If any internal errors are encountered
1421+
* inside the client while attempting to make the request or
1422+
* handle the response. For example if a network connection is
1423+
* not available.
1424+
* @throws AmazonServiceException If an error response is returned by AWS
1425+
* Location service indicating either a problem with the data in
1426+
* the request, or a server side issue.
1427+
*/
1428+
UpdateGeofenceCollectionResult updateGeofenceCollection(
1429+
UpdateGeofenceCollectionRequest updateGeofenceCollectionRequest)
1430+
throws AmazonClientException, AmazonServiceException;
1431+
1432+
/**
1433+
* <p>
1434+
* Updates the specified properties of a given map resource.
1435+
* </p>
1436+
*
1437+
* @param updateMapRequest
1438+
* @return updateMapResult The response from the UpdateMap service method,
1439+
* as returned by AWS Location service.
1440+
* @throws InternalServerException
1441+
* @throws ResourceNotFoundException
1442+
* @throws AccessDeniedException
1443+
* @throws ValidationException
1444+
* @throws ThrottlingException
1445+
* @throws AmazonClientException If any internal errors are encountered
1446+
* inside the client while attempting to make the request or
1447+
* handle the response. For example if a network connection is
1448+
* not available.
1449+
* @throws AmazonServiceException If an error response is returned by AWS
1450+
* Location service indicating either a problem with the data in
1451+
* the request, or a server side issue.
1452+
*/
1453+
UpdateMapResult updateMap(UpdateMapRequest updateMapRequest) throws AmazonClientException,
1454+
AmazonServiceException;
1455+
1456+
/**
1457+
* <p>
1458+
* Updates the specified properties of a given place index resource.
1459+
* </p>
1460+
*
1461+
* @param updatePlaceIndexRequest
1462+
* @return updatePlaceIndexResult The response from the UpdatePlaceIndex
1463+
* service method, as returned by AWS Location service.
1464+
* @throws InternalServerException
1465+
* @throws ResourceNotFoundException
1466+
* @throws AccessDeniedException
1467+
* @throws ValidationException
1468+
* @throws ThrottlingException
1469+
* @throws AmazonClientException If any internal errors are encountered
1470+
* inside the client while attempting to make the request or
1471+
* handle the response. For example if a network connection is
1472+
* not available.
1473+
* @throws AmazonServiceException If an error response is returned by AWS
1474+
* Location service indicating either a problem with the data in
1475+
* the request, or a server side issue.
1476+
*/
1477+
UpdatePlaceIndexResult updatePlaceIndex(UpdatePlaceIndexRequest updatePlaceIndexRequest)
1478+
throws AmazonClientException, AmazonServiceException;
1479+
1480+
/**
1481+
* <p>
1482+
* Updates the specified properties for a given route calculator resource.
1483+
* </p>
1484+
*
1485+
* @param updateRouteCalculatorRequest
1486+
* @return updateRouteCalculatorResult The response from the
1487+
* UpdateRouteCalculator service method, as returned by AWS Location
1488+
* service.
1489+
* @throws InternalServerException
1490+
* @throws ResourceNotFoundException
1491+
* @throws AccessDeniedException
1492+
* @throws ValidationException
1493+
* @throws ThrottlingException
1494+
* @throws AmazonClientException If any internal errors are encountered
1495+
* inside the client while attempting to make the request or
1496+
* handle the response. For example if a network connection is
1497+
* not available.
1498+
* @throws AmazonServiceException If an error response is returned by AWS
1499+
* Location service indicating either a problem with the data in
1500+
* the request, or a server side issue.
1501+
*/
1502+
UpdateRouteCalculatorResult updateRouteCalculator(
1503+
UpdateRouteCalculatorRequest updateRouteCalculatorRequest)
1504+
throws AmazonClientException, AmazonServiceException;
1505+
1506+
/**
1507+
* <p>
1508+
* Updates the specified properties of a given tracker resource.
1509+
* </p>
1510+
*
1511+
* @param updateTrackerRequest
1512+
* @return updateTrackerResult The response from the UpdateTracker service
1513+
* method, as returned by AWS Location service.
1514+
* @throws InternalServerException
1515+
* @throws ResourceNotFoundException
1516+
* @throws AccessDeniedException
1517+
* @throws ValidationException
1518+
* @throws ThrottlingException
1519+
* @throws AmazonClientException If any internal errors are encountered
1520+
* inside the client while attempting to make the request or
1521+
* handle the response. For example if a network connection is
1522+
* not available.
1523+
* @throws AmazonServiceException If an error response is returned by AWS
1524+
* Location service indicating either a problem with the data in
1525+
* the request, or a server side issue.
1526+
*/
1527+
UpdateTrackerResult updateTracker(UpdateTrackerRequest updateTrackerRequest)
1528+
throws AmazonClientException, AmazonServiceException;
1529+
13831530
/**
13841531
* Shuts down this client object, releasing any resources that might be held
13851532
* open. This is an optional method, and callers are not expected to call

0 commit comments

Comments
 (0)