Class: Aws::LocationService::Types::Leg

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-locationservice/types.rb

Overview

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.

[1]: docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html

Constant Summary collapse

SENSITIVE =
[:start_position, :end_position]

Instance Attribute Summary collapse

Instance Attribute Details

#distanceFloat

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:

  • (Float)


3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
# File 'lib/aws-sdk-locationservice/types.rb', line 3929

class Leg < Struct.new(
  :start_position,
  :end_position,
  :distance,
  :duration_seconds,
  :geometry,
  :steps)
  SENSITIVE = [:start_position, :end_position]
  include Aws::Structure
end

#duration_secondsFloat

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:

  • (Float)


3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
# File 'lib/aws-sdk-locationservice/types.rb', line 3929

class Leg < Struct.new(
  :start_position,
  :end_position,
  :distance,
  :duration_seconds,
  :geometry,
  :steps)
  SENSITIVE = [:start_position, :end_position]
  include Aws::Structure
end

#end_positionArray<Float>

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

<note markdown=“1”> If the ‘EndPosition` isn’t located on a road, it’s [snapped to a nearby road].

</note>

[1]: docs.aws.amazon.com/location/latest/developerguide/nap-to-nearby-road.html

Returns:

  • (Array<Float>)


3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
# File 'lib/aws-sdk-locationservice/types.rb', line 3929

class Leg < Struct.new(
  :start_position,
  :end_position,
  :distance,
  :duration_seconds,
  :geometry,
  :steps)
  SENSITIVE = [:start_position, :end_position]
  include Aws::Structure
end

#geometryTypes::LegGeometry

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

Returns:



3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
# File 'lib/aws-sdk-locationservice/types.rb', line 3929

class Leg < Struct.new(
  :start_position,
  :end_position,
  :distance,
  :duration_seconds,
  :geometry,
  :steps)
  SENSITIVE = [:start_position, :end_position]
  include Aws::Structure
end

#start_positionArray<Float>

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

<note markdown=“1”> If the ‘StartPosition` isn’t located on a road, it’s [snapped to a nearby road].

</note>

[1]: docs.aws.amazon.com/location/latest/developerguide/snap-to-nearby-road.html

Returns:

  • (Array<Float>)


3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
# File 'lib/aws-sdk-locationservice/types.rb', line 3929

class Leg < Struct.new(
  :start_position,
  :end_position,
  :distance,
  :duration_seconds,
  :geometry,
  :steps)
  SENSITIVE = [:start_position, :end_position]
  include Aws::Structure
end

#stepsArray<Types::Step>

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.

Returns:



3929
3930
3931
3932
3933
3934
3935
3936
3937
3938
# File 'lib/aws-sdk-locationservice/types.rb', line 3929

class Leg < Struct.new(
  :start_position,
  :end_position,
  :distance,
  :duration_seconds,
  :geometry,
  :steps)
  SENSITIVE = [:start_position, :end_position]
  include Aws::Structure
end