Skip to content

Commit

Permalink
feat(aws-android-sdk-location): update models to latest (#2770)
Browse files Browse the repository at this point in the history
  • Loading branch information
awsmobilesdk authored Jan 21, 2022
1 parent 41208f4 commit 481766e
Show file tree
Hide file tree
Showing 362 changed files with 5,327 additions and 2,677 deletions.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
/*
* Copyright 2010-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
* Copyright 2010-2022 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.
Expand Down Expand Up @@ -358,7 +358,7 @@ BatchUpdateDevicePositionResult batchUpdateDevicePosition(
* <a href=
* "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html"
* >Calculates a route</a> given the following required parameters:
* <code>DeparturePostiton</code> and <code>DestinationPosition</code>.
* <code>DeparturePosition</code> and <code>DestinationPosition</code>.
* Requires that you first <a href=
* "https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html"
* >create a route calculator resource</a>.
Expand All @@ -375,31 +375,30 @@ BatchUpdateDevicePositionResult batchUpdateDevicePosition(
* <li>
* <p>
* <a href=
* "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#departure-time"
* "https://docs.aws.amazon.com/location/latest/developerguide/departure-time.html"
* >Specifying a departure time</a> using either <code>DepartureTime</code>
* or <code>DepartureNow</code>. This calculates a route based on predictive
* or <code>DepartNow</code>. This calculates a route based on predictive
* traffic data at the given time.
* </p>
* <note>
* <p>
* You can't specify both <code>DepartureTime</code> and
* <code>DepartureNow</code> in a single request. Specifying both parameters
* <code>DepartNow</code> in a single request. Specifying both parameters
* returns a validation error.
* </p>
* </note></li>
* <li>
* <p>
* <a href=
* "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route.html#travel-mode"
* >Specifying a travel mode</a> using TravelMode. This lets you specify an
* additional route preference such as <code>CarModeOptions</code> if
* traveling by <code>Car</code>, or <code>TruckModeOptions</code> if
* traveling by <code>Truck</code>.
* "https://docs.aws.amazon.com/location/latest/developerguide/travel-mode.html"
* >Specifying a travel mode</a> using TravelMode sets the transportation
* mode used to calculate the routes. This also lets you specify additional
* route preferences in <code>CarModeOptions</code> if traveling by
* <code>Car</code>, or <code>TruckModeOptions</code> if traveling by
* <code>Truck</code>.
* </p>
* </li>
* </ul>
* <p>
* </p>
*
* @param calculateRouteRequest
* @return calculateRouteResult The response from the CalculateRoute service
Expand All @@ -420,6 +419,91 @@ BatchUpdateDevicePositionResult batchUpdateDevicePosition(
CalculateRouteResult calculateRoute(CalculateRouteRequest calculateRouteRequest)
throws AmazonClientException, AmazonServiceException;

/**
* <p>
* <a href=
* "https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix.html"
* > Calculates a route matrix</a> given the following required parameters:
* <code>DeparturePositions</code> and <code>DestinationPositions</code>.
* <code>CalculateRouteMatrix</code> calculates routes and returns the
* travel time and travel distance from each departure position to each
* destination position in the request. For example, given departure
* positions A and B, and destination positions X and Y,
* <code>CalculateRouteMatrix</code> will return time and distance for
* routes from A to X, A to Y, B to X, and B to Y (in that order). The
* number of results returned (and routes calculated) will be the number of
* <code>DeparturePositions</code> times the number of
* <code>DestinationPositions</code>.
* </p>
* <note>
* <p>
* Your account is charged for each route calculated, not the number of
* requests.
* </p>
* </note>
* <p>
* Requires that you first <a href=
* "https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html"
* >create a route calculator resource</a>.
* </p>
* <p>
* By default, a request that doesn't specify a departure time uses the best
* time of day to travel with the best traffic conditions when calculating
* routes.
* </p>
* <p>
* Additional options include:
* </p>
* <ul>
* <li>
* <p>
* <a href=
* "https://docs.aws.amazon.com/location/latest/developerguide/departure-time.html"
* > Specifying a departure time</a> using either <code>DepartureTime</code>
* or <code>DepartNow</code>. This calculates routes based on predictive
* traffic data at the given time.
* </p>
* <note>
* <p>
* You can't specify both <code>DepartureTime</code> and
* <code>DepartNow</code> in a single request. Specifying both parameters
* returns a validation error.
* </p>
* </note></li>
* <li>
* <p>
* <a href=
* "https://docs.aws.amazon.com/location/latest/developerguide/travel-mode.html"
* >Specifying a travel mode</a> using TravelMode sets the transportation
* mode used to calculate the routes. This also lets you specify additional
* route preferences in <code>CarModeOptions</code> if traveling by
* <code>Car</code>, or <code>TruckModeOptions</code> if traveling by
* <code>Truck</code>.
* </p>
* </li>
* </ul>
*
* @param calculateRouteMatrixRequest
* @return calculateRouteMatrixResult The response from the
* CalculateRouteMatrix 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.
*/
CalculateRouteMatrixResult calculateRouteMatrix(
CalculateRouteMatrixRequest calculateRouteMatrixRequest) throws AmazonClientException,
AmazonServiceException;

/**
* <p>
* Creates a geofence collection, which manages and stores geofences.
Expand Down Expand Up @@ -451,6 +535,15 @@ CreateGeofenceCollectionResult createGeofenceCollection(
* Creates a map resource in your AWS account, which provides map tiles of
* different styles sourced from global location data providers.
* </p>
* <note>
* <p>
* If your application is tracking or routing assets you use in your
* business, such as delivery vehicles or employees, you may only use HERE
* as your geolocation provider. See section 82 of the <a
* href="http://aws.amazon.com/service-terms">AWS service terms</a> for more
* details.
* </p>
* </note>
*
* @param createMapRequest
* @return createMapResult The response from the CreateMap service method,
Expand Down Expand Up @@ -480,6 +573,15 @@ CreateMapResult createMap(CreateMapRequest createMapRequest) throws AmazonClient
* operation, and enable autosuggestions by using the
* <code>SearchPlaceIndexForSuggestions</code> operation.
* </p>
* <note>
* <p>
* If your application is tracking or routing assets you use in your
* business, such as delivery vehicles or employees, you may only use HERE
* as your geolocation provider. See section 82 of the <a
* href="http://aws.amazon.com/service-terms">AWS service terms</a> for more
* details.
* </p>
* </note>
*
* @param createPlaceIndexRequest
* @return createPlaceIndexResult The response from the CreatePlaceIndex
Expand Down Expand Up @@ -509,6 +611,15 @@ CreatePlaceIndexResult createPlaceIndex(CreatePlaceIndexRequest createPlaceIndex
* time, distance, and get directions. A route calculator sources traffic
* and road network data from your chosen data provider.
* </p>
* <note>
* <p>
* If your application is tracking or routing assets you use in your
* business, such as delivery vehicles or employees, you may only use HERE
* as your geolocation provider. See section 82 of the <a
* href="http://aws.amazon.com/service-terms">AWS service terms</a> for more
* details.
* </p>
* </note>
*
* @param createRouteCalculatorRequest
* @return createRouteCalculatorResult The response from the
Expand Down
Loading

0 comments on commit 481766e

Please sign in to comment.