AWSLocationLeg

Objective-C

@interface AWSLocationLeg

Swift

class AWSLocationLeg

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.

Required parameters: [StartPosition, EndPosition, Distance, DurationSeconds, Steps]

  • 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSNumber *_Nullable distance;

    Swift

    var distance: NSNumber? { get set }

  • 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSNumber *_Nullable durationSeconds;

    Swift

    var durationSeconds: NSNumber? { get set }

  • 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSArray<NSNumber *> *_Nullable endPosition;

    Swift

    var endPosition: [NSNumber]? { get set }

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

    Declaration

    Objective-C

    @property (nonatomic, strong) AWSLocationLegGeometry *_Nullable geometry;

    Swift

    var geometry: AWSLocationLegGeometry? { get set }

  • 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSArray<NSNumber *> *_Nullable startPosition;

    Swift

    var startPosition: [NSNumber]? { get set }

  • 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.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSArray<AWSLocationStep *> *_Nullable steps;

    Swift

    var steps: [AWSLocationStep]? { get set }