This is the documentation of version 1.0.0-rc.3. Go to the latest version, 1.0.0-rc.5.

Function getSectionsWithin

getSectionsWithin(route: Route, options?: SectionsWithinOptions): SectionsWithin
Lists a route's sections within spans of it, type by type, such as the ferries, tolls and traffic on the roads only that route takes.
Parameters
- route: Route
  The route, with its sections.
- options: SectionsWithinOptions = {}
  Where to look along the route, and for which section types.
Returns SectionsWithin
The types the route has within the spans, each with its sections there and their length.
Remarks
- A section counts when it shares a segment with a span, as getSectionOverlap finds, and only its part within the spans adds to lengthInMeters. Its shares entry says how much of it that part is, to prorate a traffic section's delayInSeconds, for example.
- The sections come back whole, so their ids suit RoutingModule.setSectionFocus on the routes shown.
- Pass sections.distinct as within for what sets a route apart from its alternatives. compareRoutes weighs it against one other route.
Example
```
const routes = await calculateRoute({ locations, maxAlternatives: 2 });
routes.features.forEach((route) => {
    const own = getSectionsWithin(route, { within: route.properties.sections.distinct, types: ['ferry', 'toll'] });
    if (own.ferry) console.log(`takes a ferry for ${formatDistance(own.ferry.lengthInMeters)}`);
    if (own.toll) console.log(`pays ${own.toll.sections.length} tolls of its own`);
});
```