OSRM Text Instructions is a Node.js library that transforms route data generated by OSRM into localized turn instructions to be displayed visually or read aloud by a text-to-speech engine. OSRM Text Instructions is the basis of guidance instructions in osrm-frontend, the Mapbox Directions API, and the Mapbox Navigation SDK.
var version = 'v5'; var osrmTextInstructions = require('osrm-text-instructions')(version); response.legs.forEach(function(leg) { leg.steps.forEach(function(step) { instruction = osrmTextInstructions.compile('en', step, options) }); });
import osrmTextInstructions = require('osrm-text-instructions'); const compiler = osrmTextInstructions('v5'); const step: osrmTextInstructions.RouteStep = { maneuver: { type: 'turn', modifier: 'left' }, name: 'Main Street' }; const options: osrmTextInstructions.CompileOptions = { legCount: 2, legIndex: 0, formatToken: (token: string, value: string) => { return token === 'way_name' ? `<strong>${value}</strong>` : value; } }; const instruction = compiler.compile('en', step, options);
If you are unsure if the user's locale is supported by osrm-text-inustrctions, use @mapbox/locale-utils for finding the best fitting language.
Parametersrequire('osrm-text-instructions')(version)
parameter required? values description version
required v5
Major OSRM version Parameters compile(language, step, options)
parameter required? values description language
required en
de
zh-Hans
fr
nl
ru
and more Compiling instructions for the selected language code. step
required OSRM route step object The RouteStep as it comes out of OSRM options
optional Object See below key type description legCount
integer Number of legs in the route legIndex
integer Zero-based index of the leg containing the step; together with legCount
, this option determines which waypoint the user has arrived at formatToken
function Function that formats the given token value after grammaticalization and capitalization but before the value is inserted into the instruction string; useful for wrapping tokens in markup waypointName
string Optional custom name for the leg's destination, replaces "your {nth} destination"
formatToken
takes two parameters:
token
: A string that indicates the kind of token, such as way_name
or direction
value
: A grammatical string for this token, capitalized if the token appears at the beginning of the instructionand returns a string.
We welcome feedback, code contributions, and translations! Please see CONTRIBUTING.md for details.
Help translate OSRM Text Instructions
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4