Class CalculateRoutesRequest
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<CalculateRoutesRequest.Builder,CalculateRoutesRequest>
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionfinal RouteAllowOptionsallow()Features that are allowed while calculating a route.final StringTime of arrival at the destination.final RouteAvoidanceOptionsavoid()Features that are avoided while calculating a route.builder()final BooleanUses the current time as the time of departure.final StringTime of departure from the origin.The final position for the route.final RouteDestinationOptionsDestination related options.final RouteDriverOptionsdriver()Driver related options.final booleanfinal booleanequalsBySdkFields(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final RouteExclusionOptionsexclude()Features to be strictly excluded while calculating the route.final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz) Used to retrieve the value of a field from any class that extendsSdkRequest.final booleanFor responses, this returns true if the service returned a value for the Destination property.final inthashCode()final booleanFor responses, this returns true if the service returned a value for the Languages property.final booleanFor responses, this returns true if the service returned a value for the LegAdditionalFeatures property.final booleanFor responses, this returns true if the service returned a value for the Origin property.final booleanFor responses, this returns true if the service returned a value for the SpanAdditionalFeatures property.final booleanFor responses, this returns true if the service returned a value for the Waypoints property.final MeasurementSystemMeasurement system to be used for instructions within steps in the response.final StringMeasurement system to be used for instructions within steps in the response.final Stringkey()Optional: The API key to be used for authorization.List of languages for instructions within steps in the response.final List<RouteLegAdditionalFeature> A list of optional additional parameters such as timezone that can be requested for each result.A list of optional additional parameters such as timezone that can be requested for each result.final GeometryFormatSpecifies the format of the geometry returned for each leg of the route.final StringSpecifies the format of the geometry returned for each leg of the route.final IntegerMaximum number of alternative routes to be provided in the response, if available.final RoutingObjectiveControls the trade-off between achieving the shortest travel time (FastestRoute) and achieving the shortest physical distance ((ShortestRoute) when calculating each route in the matrix.final StringControls the trade-off between achieving the shortest travel time (FastestRoute) and achieving the shortest physical distance ((ShortestRoute) when calculating each route in the matrix.origin()The start position for the route in World Geodetic System (WGS 84) format: [longitude, latitude].final RouteOriginOptionsSpecifies how the origin point should be matched to the road network and any routing constraints that apply when the traveler is departing the origin.static Class<? extends CalculateRoutesRequest.Builder> final List<RouteSpanAdditionalFeature> A list of optional features such asSpeedLimitthat can be requested for a Span.A list of optional features such asSpeedLimitthat can be requested for a Span.Take this object and create a builder that contains all of the current property values of this object.final RouteTollOptionstolls()Toll related options.final StringtoString()Returns a string representation of this object.final RouteTrafficOptionstraffic()Traffic related options.final RouteTravelModeSpecifies the mode of transport when calculating a route.final StringSpecifies the mode of transport when calculating a route.final RouteTravelModeOptionsTravel mode related options for the provided travel mode.final RouteTravelStepTypeType of step returned by the response.final StringType of step returned by the response.final List<RouteWaypoint> List of waypoints between the Origin and Destination.Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfigurationMethods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
allow
-
arrivalTime
Time of arrival at the destination. Not supported in
ap-southeast-1andap-southeast-5regions for GrabMaps customers.Time format:
YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mmExamples:
2020-04-22T17:57:24Z2020-04-22T17:57:24+02:00- Returns:
- Time of arrival at the destination. Not supported in
ap-southeast-1andap-southeast-5regions for GrabMaps customers.Time format:
YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mmExamples:
2020-04-22T17:57:24Z2020-04-22T17:57:24+02:00
-
avoid
Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, it violates the avoidance and the returned response produces a notice for the violation. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyControlledAccessHighways,Ferries, andTollRoads- Returns:
- Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance
can't be satisfied for a particular case, it violates the avoidance and the returned response produces a
notice for the violation. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyControlledAccessHighways,Ferries, andTollRoads
-
departNow
Uses the current time as the time of departure.
- Returns:
- Uses the current time as the time of departure.
-
departureTime
Time of departure from the origin.
Time format:
YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mmExamples:
2020-04-22T17:57:24Z2020-04-22T17:57:24+02:00- Returns:
- Time of departure from the origin.
Time format:
YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mmExamples:
2020-04-22T17:57:24Z2020-04-22T17:57:24+02:00
-
hasDestination
public final boolean hasDestination()For responses, this returns true if the service returned a value for the Destination property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
destination
The final position for the route. In the World Geodetic System (WGS 84) format:
[longitude, latitude].Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasDestination()method.- Returns:
- The final position for the route. In the World Geodetic System (WGS 84) format:
[longitude, latitude].
-
destinationOptions
-
driver
-
exclude
-
instructionsMeasurementSystem
Measurement system to be used for instructions within steps in the response.
If the service returns an enum value that is not available in the current SDK version,
instructionsMeasurementSystemwill returnMeasurementSystem.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frominstructionsMeasurementSystemAsString().- Returns:
- Measurement system to be used for instructions within steps in the response.
- See Also:
-
instructionsMeasurementSystemAsString
Measurement system to be used for instructions within steps in the response.
If the service returns an enum value that is not available in the current SDK version,
instructionsMeasurementSystemwill returnMeasurementSystem.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frominstructionsMeasurementSystemAsString().- Returns:
- Measurement system to be used for instructions within steps in the response.
- See Also:
-
key
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Returns:
- Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
-
hasLanguages
public final boolean hasLanguages()For responses, this returns true if the service returned a value for the Languages property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
languages
List of languages for instructions within steps in the response. Not supported in
ap-southeast-1andap-southeast-5regions for GrabMaps customers.Instructions in the requested language are returned only if they are available.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasLanguages()method.- Returns:
- List of languages for instructions within steps in the response. Not supported in
ap-southeast-1andap-southeast-5regions for GrabMaps customers.Instructions in the requested language are returned only if they are available.
-
legAdditionalFeatures
A list of optional additional parameters such as timezone that can be requested for each result. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyPassThroughWaypoints,Summary, andTravelStepInstructions-
Elevation: Retrieves the elevation information for each location. -
Incidents: Provides information on traffic incidents along the route. -
PassThroughWaypoints: Indicates waypoints that are passed through without stopping. -
Summary: Returns a summary of the route, including distance and duration. -
Tolls: Supplies toll cost information along the route. -
TravelStepInstructions: Provides step-by-step instructions for travel along the route. -
TruckRoadTypes: Returns information about road types suitable for trucks. -
TypicalDuration: Gives typical travel duration based on historical data. -
Zones: Specifies the time zone information for each waypoint.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasLegAdditionalFeatures()method.- Returns:
- A list of optional additional parameters such as timezone that can be requested for each result. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyPassThroughWaypoints,Summary, andTravelStepInstructions-
Elevation: Retrieves the elevation information for each location. -
Incidents: Provides information on traffic incidents along the route. -
PassThroughWaypoints: Indicates waypoints that are passed through without stopping. -
Summary: Returns a summary of the route, including distance and duration. -
Tolls: Supplies toll cost information along the route. -
TravelStepInstructions: Provides step-by-step instructions for travel along the route. -
TruckRoadTypes: Returns information about road types suitable for trucks. -
TypicalDuration: Gives typical travel duration based on historical data. -
Zones: Specifies the time zone information for each waypoint.
-
-
-
hasLegAdditionalFeatures
public final boolean hasLegAdditionalFeatures()For responses, this returns true if the service returned a value for the LegAdditionalFeatures property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
legAdditionalFeaturesAsStrings
A list of optional additional parameters such as timezone that can be requested for each result. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyPassThroughWaypoints,Summary, andTravelStepInstructions-
Elevation: Retrieves the elevation information for each location. -
Incidents: Provides information on traffic incidents along the route. -
PassThroughWaypoints: Indicates waypoints that are passed through without stopping. -
Summary: Returns a summary of the route, including distance and duration. -
Tolls: Supplies toll cost information along the route. -
TravelStepInstructions: Provides step-by-step instructions for travel along the route. -
TruckRoadTypes: Returns information about road types suitable for trucks. -
TypicalDuration: Gives typical travel duration based on historical data. -
Zones: Specifies the time zone information for each waypoint.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasLegAdditionalFeatures()method.- Returns:
- A list of optional additional parameters such as timezone that can be requested for each result. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyPassThroughWaypoints,Summary, andTravelStepInstructions-
Elevation: Retrieves the elevation information for each location. -
Incidents: Provides information on traffic incidents along the route. -
PassThroughWaypoints: Indicates waypoints that are passed through without stopping. -
Summary: Returns a summary of the route, including distance and duration. -
Tolls: Supplies toll cost information along the route. -
TravelStepInstructions: Provides step-by-step instructions for travel along the route. -
TruckRoadTypes: Returns information about road types suitable for trucks. -
TypicalDuration: Gives typical travel duration based on historical data. -
Zones: Specifies the time zone information for each waypoint.
-
-
-
legGeometryFormat
Specifies the format of the geometry returned for each leg of the route. You can choose between two different geometry encoding formats.
FlexiblePolyline: A compact and precise encoding format for the leg geometry. For more information on the format, see the GitHub repository for https://github.com/aws-geospatial/polyline.Simple: A less compact encoding, which is easier to decode but may be less precise and result in larger payloads.If the service returns an enum value that is not available in the current SDK version,
legGeometryFormatwill returnGeometryFormat.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlegGeometryFormatAsString().- Returns:
- Specifies the format of the geometry returned for each leg of the route. You can choose between two
different geometry encoding formats.
FlexiblePolyline: A compact and precise encoding format for the leg geometry. For more information on the format, see the GitHub repository for https://github.com/aws-geospatial/polyline.Simple: A less compact encoding, which is easier to decode but may be less precise and result in larger payloads. - See Also:
-
legGeometryFormatAsString
Specifies the format of the geometry returned for each leg of the route. You can choose between two different geometry encoding formats.
FlexiblePolyline: A compact and precise encoding format for the leg geometry. For more information on the format, see the GitHub repository for https://github.com/aws-geospatial/polyline.Simple: A less compact encoding, which is easier to decode but may be less precise and result in larger payloads.If the service returns an enum value that is not available in the current SDK version,
legGeometryFormatwill returnGeometryFormat.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlegGeometryFormatAsString().- Returns:
- Specifies the format of the geometry returned for each leg of the route. You can choose between two
different geometry encoding formats.
FlexiblePolyline: A compact and precise encoding format for the leg geometry. For more information on the format, see the GitHub repository for https://github.com/aws-geospatial/polyline.Simple: A less compact encoding, which is easier to decode but may be less precise and result in larger payloads. - See Also:
-
maxAlternatives
Maximum number of alternative routes to be provided in the response, if available. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support only up to 3 alternative routes.- Returns:
- Maximum number of alternative routes to be provided in the response, if available. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support only up to 3 alternative routes.
-
optimizeRoutingFor
Controls the trade-off between achieving the shortest travel time (
FastestRoute) and achieving the shortest physical distance ((ShortestRoute) when calculating each route in the matrix.Default value:
FastestRouteIf the service returns an enum value that is not available in the current SDK version,
optimizeRoutingForwill returnRoutingObjective.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromoptimizeRoutingForAsString().- Returns:
- Controls the trade-off between achieving the shortest travel time (
FastestRoute) and achieving the shortest physical distance ((ShortestRoute) when calculating each route in the matrix.Default value:
FastestRoute - See Also:
-
optimizeRoutingForAsString
Controls the trade-off between achieving the shortest travel time (
FastestRoute) and achieving the shortest physical distance ((ShortestRoute) when calculating each route in the matrix.Default value:
FastestRouteIf the service returns an enum value that is not available in the current SDK version,
optimizeRoutingForwill returnRoutingObjective.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromoptimizeRoutingForAsString().- Returns:
- Controls the trade-off between achieving the shortest travel time (
FastestRoute) and achieving the shortest physical distance ((ShortestRoute) when calculating each route in the matrix.Default value:
FastestRoute - See Also:
-
hasOrigin
public final boolean hasOrigin()For responses, this returns true if the service returned a value for the Origin property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
origin
The start position for the route in World Geodetic System (WGS 84) format: [longitude, latitude].
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasOrigin()method.- Returns:
- The start position for the route in World Geodetic System (WGS 84) format: [longitude, latitude].
-
originOptions
Specifies how the origin point should be matched to the road network and any routing constraints that apply when the traveler is departing the origin. Not supported in
ap-southeast-1andap-southeast-5regions for GrabMaps customers.- Returns:
- Specifies how the origin point should be matched to the road network and any routing constraints that
apply when the traveler is departing the origin. Not supported in
ap-southeast-1andap-southeast-5regions for GrabMaps customers.
-
spanAdditionalFeatures
A list of optional features such as
SpeedLimitthat can be requested for a Span. A span is a section of a Leg for which the requested features have the same values. Not supported inap-southeast-1andap-southeast-5regions for GrabMaps customers.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSpanAdditionalFeatures()method.- Returns:
- A list of optional features such as
SpeedLimitthat can be requested for a Span. A span is a section of a Leg for which the requested features have the same values. Not supported inap-southeast-1andap-southeast-5regions for GrabMaps customers.
-
hasSpanAdditionalFeatures
public final boolean hasSpanAdditionalFeatures()For responses, this returns true if the service returned a value for the SpanAdditionalFeatures property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
spanAdditionalFeaturesAsStrings
A list of optional features such as
SpeedLimitthat can be requested for a Span. A span is a section of a Leg for which the requested features have the same values. Not supported inap-southeast-1andap-southeast-5regions for GrabMaps customers.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSpanAdditionalFeatures()method.- Returns:
- A list of optional features such as
SpeedLimitthat can be requested for a Span. A span is a section of a Leg for which the requested features have the same values. Not supported inap-southeast-1andap-southeast-5regions for GrabMaps customers.
-
tolls
-
traffic
-
travelMode
Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyCar,Pedestrian, andScootervalues.Default value:
CarIf the service returns an enum value that is not available in the current SDK version,
travelModewill returnRouteTravelMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtravelModeAsString().- Returns:
- Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road
compatibility. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyCar,Pedestrian, andScootervalues.Default value:
Car - See Also:
-
travelModeAsString
Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyCar,Pedestrian, andScootervalues.Default value:
CarIf the service returns an enum value that is not available in the current SDK version,
travelModewill returnRouteTravelMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtravelModeAsString().- Returns:
- Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road
compatibility. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyCar,Pedestrian, andScootervalues.Default value:
Car - See Also:
-
travelModeOptions
Travel mode related options for the provided travel mode. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyCarandPedestriantravel mode options.- Returns:
- Travel mode related options for the provided travel mode. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions support onlyCarandPedestriantravel mode options.
-
travelStepType
Type of step returned by the response.
Defaultprovides basic steps intended for web based applications.TurnByTurnprovides detailed instructions with more granularity intended for a turn based navigation system. For GrabMaps customers,ap-southeast-1andap-southeast-5regionsDefaultdoes not return any steps.If the service returns an enum value that is not available in the current SDK version,
travelStepTypewill returnRouteTravelStepType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtravelStepTypeAsString().- Returns:
- Type of step returned by the response.
Defaultprovides basic steps intended for web based applications.TurnByTurnprovides detailed instructions with more granularity intended for a turn based navigation system. For GrabMaps customers,ap-southeast-1andap-southeast-5regionsDefaultdoes not return any steps. - See Also:
-
travelStepTypeAsString
Type of step returned by the response.
Defaultprovides basic steps intended for web based applications.TurnByTurnprovides detailed instructions with more granularity intended for a turn based navigation system. For GrabMaps customers,ap-southeast-1andap-southeast-5regionsDefaultdoes not return any steps.If the service returns an enum value that is not available in the current SDK version,
travelStepTypewill returnRouteTravelStepType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtravelStepTypeAsString().- Returns:
- Type of step returned by the response.
Defaultprovides basic steps intended for web based applications.TurnByTurnprovides detailed instructions with more granularity intended for a turn based navigation system. For GrabMaps customers,ap-southeast-1andap-southeast-5regionsDefaultdoes not return any steps. - See Also:
-
hasWaypoints
public final boolean hasWaypoints()For responses, this returns true if the service returned a value for the Waypoints property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
waypoints
List of waypoints between the Origin and Destination. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions max length is100.Max length:
23Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasWaypoints()method.- Returns:
- List of waypoints between the Origin and Destination. For GrabMaps customers,
ap-southeast-1andap-southeast-5regions max length is100.Max length:
23
-
toBuilder
Description copied from interface:ToCopyableBuilderTake this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilderin interfaceToCopyableBuilder<CalculateRoutesRequest.Builder,CalculateRoutesRequest> - Specified by:
toBuilderin classGeoRoutesRequest- Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode()- Overrides:
hashCodein classAwsRequest
-
equals
- Overrides:
equalsin classAwsRequest
-
equalsBySdkFields
Description copied from interface:SdkPojoIndicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojoclass, and is generated based on a service model.If an
SdkPojoclass does not have any inherited fields,equalsBySdkFieldsandequalsare essentially the same.- Specified by:
equalsBySdkFieldsin interfaceSdkPojo- Parameters:
obj- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
Description copied from class:SdkRequestUsed to retrieve the value of a field from any class that extendsSdkRequest. The field name specified should match the member name from the corresponding service-2.json model specified in the codegen-resources folder for a given service. The class specifies what class to cast the returned value to. If the returned value is also a modeled class, theSdkRequest.getValueForField(String, Class)method will again be available.- Overrides:
getValueForFieldin classSdkRequest- Parameters:
fieldName- The name of the member to be retrieved.clazz- The class to cast the returned object to.- Returns:
- Optional containing the casted return value
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo- Returns:
- The mapping between the field name and its corresponding field.
-