DriveWorks SDK Reference
3.0.4260 Release
For Test and Development only

Lane Plan

A Lane Plan is described by the dwLanePlan struct:

typedef struct dwLanePlan
// List of segments along the lane plan.
// Number segments in lane plan.
uint32_t segmentCount;

To access the dwLanePlan struct, call:

The dwLanePlan struct is a list of Lane Plan Segments. Each Lane Plan Segment has a list of Lane Plan Lanes that describe the current lane change situation at that segment:

typedef struct dwLanePlanSegment
// List of lanes. The first lane in the list is the lane
// where the lane plan segment is entered, the last one
// is where the lane plan segment is exited. If there is
// more than one lane, lane changes must be done from the
// first to the last lane, traversing all in-between
// lanes in order.
// Number of lanes in this segment. If there are more than
// one, it is a lane change segment.
uint32_t laneCount;
// Left, right, none

A Lane Plan Lane is a polyline, together with pointers to the original dwMapsLane for each point:

typedef struct dwLanePlanLane
// Polyline point array
const dwMapsGeoPoint* points;
// Pointers to the corresponding lane (per point)
const dwMapsLane** pointLanes;
// Estimated time of arrival (per point)
// relative to beginning of first lane of the lane plan,
// computed based on lane speed limits. 50 km/h is assumed
// if no speed limit is defined for a lane.
const dwTime_t* times;
// number of points
uint32_t pointCount;

If the segment has only one Lane Plan Lane, then that lane must be followed. If there is more than one lane, the last lane of the list is the target lane that must be reached to follow the Lane Plan.

Each point on a Lane Plan can be accessed through dwLanePlanIndex:

typedef struct dwLanePlanIndex
uint32_t segmentIndex;
uint32_t laneIndex;
uint32_t pointIndex;
// plan lane

dwLanePlanIndex provides a reference into the Lane Plan defined by the segment index, the lane index on the segment, and the point index on the lane.

The example image below shows a small Lane Plan with three segments. The first segment has two Lane Plan Lanes, the second segment has three Lane Plan Lanes due to a lane split at the end of the target lane of the first segment. The third segment shows the lane that must be followed to reach the target point (indicated by the red box). So, the first two segments describe where and how many lane changes must be executed to reach the target.