software.amazon.awssdk.services.location.model

Class Leg

java.lang.Object

software.amazon.awssdk.services.location.model.Leg

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<Leg.Builder,Leg>

@Generated(value="software.amazon.awssdk:codegen")
public final class Leg
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<Leg.Builder,Leg>

Contains the calculated route's details for each path between a pair of positions. The number of legs returned corresponds to one fewer than the total number of positions in the request.

For example, a route with a departure position and destination position returns one leg with the positions snapped to a nearby road:

• The StartPosition is the departure position.

• The EndPosition is the destination position.

A route with a waypoint between the departure and destination position returns two legs with the positions snapped to a nearby road:

• Leg 1: The StartPosition is the departure position . The EndPosition is the waypoint positon.

• Leg 2: The StartPosition is the waypoint position. The EndPosition is the destination position.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Leg.Builder

Method Summary

Modifier and Type	Method and Description
static Leg.Builder	builder()
Double	distance() The distance between the leg's StartPosition and EndPosition along a calculated route.
Double	durationSeconds() The estimated travel time between the leg's StartPosition and EndPosition.
List<Double>	endPosition() The terminating position of the leg.
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
LegGeometry	geometry() Contains the calculated route's path as a linestring geometry.
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
boolean	hasEndPosition() Returns true if the EndPosition property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
int	hashCode()
boolean	hasStartPosition() Returns true if the StartPosition property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
boolean	hasSteps() Returns true if the Steps property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
List<SdkField<?>>	sdkFields()
static Class<? extends Leg.Builder>	serializableBuilderClass()
List<Double>	startPosition() The starting position of the leg.
List<Step>	steps() Contains a list of steps, which represent subsections of a leg.
Leg.Builder	toBuilder()
String	toString() Returns a string representation of this object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

copy

Method Detail

distance

public final Double distance()

The distance between the leg's StartPosition and EndPosition along a calculated route.

• The default measurement is Kilometers unless the request specifies a DistanceUnit of Miles.

Returns:

The distance between the leg's StartPosition and EndPosition along a calculated route.

• The default measurement is Kilometers unless the request specifies a DistanceUnit of Miles.

durationSeconds

public final Double durationSeconds()

The estimated travel time between the leg's StartPosition and EndPosition. The travel mode and departure time that you specify in the request determines the calculated time.

Returns:

The estimated travel time between the leg's StartPosition and EndPosition. The travel mode and departure time that you specify in the request determines the calculated time.

hasEndPosition

public final boolean hasEndPosition()

Returns true if the EndPosition property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.

endPosition

public final List<Double> endPosition()

The terminating position of the leg. Follows the format [longitude,latitude].

If the EndPosition isn't located on a road, it's snapped to a nearby road.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

You can use hasEndPosition() to see if a value was sent in this field.

Returns:

The terminating position of the leg. Follows the format [longitude,latitude].

If the EndPosition isn't located on a road, it's snapped to a nearby road.

geometry

public final LegGeometry geometry()

Contains the calculated route's path as a linestring geometry.

Returns:

Contains the calculated route's path as a linestring geometry.

hasStartPosition

public final boolean hasStartPosition()

Returns true if the StartPosition property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.

startPosition

public final List<Double> startPosition()

The starting position of the leg. Follows the format [longitude,latitude].

If the StartPosition isn't located on a road, it's snapped to a nearby road.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

You can use hasStartPosition() to see if a value was sent in this field.

Returns:

The starting position of the leg. Follows the format [longitude,latitude].

If the StartPosition isn't located on a road, it's snapped to a nearby road.

hasSteps

public final boolean hasSteps()

Returns true if the Steps property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.

steps

public final List<Step> steps()

Contains a list of steps, which represent subsections of a leg. Each step provides instructions for how to move to the next step in the leg such as the step's start position, end position, travel distance, travel duration, and geometry offset.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

You can use hasSteps() to see if a value was sent in this field.

Returns:

Contains a list of steps, which represent subsections of a leg. Each step provides instructions for how to move to the next step in the leg such as the step's start position, end position, travel distance, travel duration, and geometry offset.

toBuilder

public Leg.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<Leg.Builder,Leg>

builder

public static Leg.Builder builder()

serializableBuilderClass

public static Class<? extends Leg.Builder> serializableBuilderClass()

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public final boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

toString

public final String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

getValueForField

public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)

sdkFields

public final List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo