Route sections are parts of a planned route that have specific characteristics, such as ferry crossings, motorway sections, or areas with traffic incidents. Using sections, you can show users where these elements are located along a planned route.

The Sections object contains a list of parameters for each Section.

Read more about route planning in the Planning routes guide.

You can find the list of section types further in this guide.

Each returned section has three basic properties:

• A list of geometries representing the section.
• The distance from the start of the route to the section.
• The length of the section, in meters.

Some specific section types also return additional information about the section.

Basic section types

The following section types are always included in a response:

• SectionType.CarTrain - Represents a route section that is a car train.
• SectionType.Country - Represents a route section indicating which countries the route crosses.
  • It provides the 3-character ISO 3166-1 alpha-3 country code in which the section is located.
• SectionType.Ferry - Represents a route section that is a ferry.
• SectionType.Motorway - Represents a motorway section.
• SectionType.Pedestrian - Represents a route section suited only for pedestrians.
• SectionType.TollRoad - Represents a route section that requires a toll payment.
• SectionType.TollVignette - Represents a route section requiring a toll vignette.
  • It provides the 3-character ISO 3166-1 alpha-3 country code in which the section is located.
• SectionType.Traffic - Represents a route section with traffic information. It also provides:
  • The category of the incident - SimpleCategory.
  • The average effective speed in km/h.
  • The delay caused by the incident, in seconds.
  • The magnitude of the delay caused by the incident.
  • Detailed information about the traffic event (TPEG2-TEC standard).
• SectionType.VehicleRestricted - Represents a route section restricted for the selected vehicle type.
• SectionType.Tunnel - Represents a route section that is a tunnel.
• SectionType.Carpool - Represents a route section reserved for HOV (high-occupancy vehicles) at the time of traversal. Roads with at least one unrestricted lane are not included.
• SectionType.Urban - Represents a route section located within an urban area.
• SectionType.LowEmissionZone - Represents a route section within a low-emission zone.
• SectionType.Unpaved - Represents a route section with an unpaved road surface.

Section types for extended guidance

The following section types for extended guidance are included in a response if they are requested using GuidanceOptions.extendedSections:

• SectionType.Lanes - Represents a route section with lane section available. It additionally provides:
  • Information about the Lane and Direction the driver should follow.
  • Information about the lane separators.
• SectionType.SpeedLimit - Represents a route section with a speed limit.
  • Provides the speed limit in km/h.
• SectionType.RoadShields - Represents a route section with road shield information.
  • Provides a reference to the road shield with the shield content.

Next steps

Since you have learned how to work with route sections, here are recommendations for the next steps:

• Route planning
• Showing traffic on the map
• Drawing on the map