Type Alias RoutingModuleConfig

Type Declaration

• OptionalbeforeLayerConfig?: RoutingBeforeLayerConfig

  Where the route's layers sit in the map's layer stack, for the whole route or per part.

  Remarks

  If you leave it out, every layer sits where RoutingBeforeLayerConfig says it does by default.

• Optionalcolor?: string

  The colour of the route line, its outline and the waypoint icons, as any CSS colour string.

  Remarks

  The outline takes a darker shade of it. When unset, the map's accent colour applies if a theme sets one (TomTomMap.mapColors), otherwise the SDK's own route blue. layers overrides it layer by layer.

• OptionalcountryCrossings?: CountryCrossingConfig

  Appearance of the border crossings along the route.

  Remarks

  They come from the route's country sections, so a route carrying none draws none.

• OptionaldisplayUnits?: DisplayUnits

  Units of the distances and durations the module writes on the map.

  Remarks

  They apply over the global configuration's display units field by field, and a field left unset keeps the global value. distance.type picks the unit system (metric, imperial_us or imperial_uk), and the other fields relabel the units.

  Default Value

  the global configuration's displayUnits

• Optionalhighlight?: RouteHighlightConfig

  How a hovered or clicked route is drawn.

• Optionallayers?: RouteLayersConfig

  Custom layer styling configuration.

  Remarks

  It overrides the default layer styling with custom specifications. You must provide complete layer specifications for any layer you customise. For incremental changes, you can still reuse the default configurations in defaultRoutingLayers. Any layer you don't specify keeps its default styling. Use this only if you need fine MapLibre control over how some parts of the route display.

• Optionalsections?: SectionsDisplayConfig

  Appearance of the route sections, keyed by section type.

  Remarks

  It covers every section type the module draws, with the same knobs: draw it or not, its colour, opacity, width, whether it bands the route or stands in for its line, its line pattern and its icon.

  The types whose stretches are sparse and consequential draw themselves, and switch off with { visible: false }. They are carTrain, ferry, lowEmissionZone, tollRoad, tollVignette, traffic, tunnel and vehicleRestricted. The rest switch on with { visible: true }, because a type covering most of a route buries the route line.

  layers.sections takes full MapLibre layer specs for the same types, for anything these knobs cannot express.

• OptionalsummaryBubbles?: { visible?: boolean }

  The route summary bubbles on the map.

  Remarks

  A summary bubble shows key route information (distance, duration, traffic delay) as a visual overlay along the route.

  • Optionalvisible?: boolean

    Whether the route summary bubbles show on the map.

    Default Value

    true
    Copy

• Optionalvisible?: boolean

  Whether the module draws anything: route lines, waypoints, sections, guidance, summary bubbles and border crossings.

  Remarks

  showRoutes(), showWaypoints() and the clear methods never change it. A hidden module keeps its data until RoutingModule.setVisible shows it again. While shown, each part's own visible (sections.<type>.visible, summaryBubbles.visible, …) still decides whether it draws.

  Default Value

  true
  Copy

• Optionalwaypoints?: WaypointsConfig

  Configuration for the waypoints source and layers to display them on the map.

  Remarks

  It controls how waypoint source data and layer configs are processed to render them on the map.

• OptionalwidthFactor?: number

  Multiplier over the widthPreset, where 1 leaves it unchanged. The two compose, so { widthPreset: 'l', widthFactor: 1.5 } draws 1.5 × the "l" profile.

  Remarks

  Clamped to 0.5 to 2, its range in routingKnobCatalogue. Sections without a widthFactor of their own follow it, and so do the instruction arrows, which no preset resizes.

  Default Value

  1

• OptionalwidthPreset?: RouteWidth

  Thickness preset of the route line and its outline, which the section and instruction lines follow.

  Default Value

  "m"