osrm

node-osrm

Routing engine for OpenStreetMap data implementing high-performance algorithms for shortest paths in road networks.

Provides bindings to the Open Source Routing Machine - OSRM.

Depends

• Node.js v0.10.x

Installing

By default, binaries are provided and no external dependencies or compile is needed.

Just do:

npm install osrm

We currently provide binaries for 64 bit OS X and 64 bit Linux. Running npm install on other platforms will fall back to a source compile (see Developing below for build details).

Usage

First you need to download some OSM data and process it with OSRM.

Next you need to create an OSRM config (ini) file that references the OSRM prepared routing data.

This repository contains a Makefile to automatically do this, assuming you have OSRM installed.

Just run:

make berlin-latest.osrm.hsgr

Next, since we want to use node-osrm locally, do:

export NODE_PATH=lib

Once that is done then you can calculate routes in Javascript like:

var osrm = require('osrm')
var opts = new osrm.Options("./test/data/berlin.ini");
var engine = new osrm.Engine(opts);
var query = new osrm.Query({coordinates: [[52.519930,13.438640], [52.513191,13.415852]]});
var sync_result = engine.run(query);
JSON.parse(engine.run(query));
{ status: 0,
  status_message: 'Found route between points',
  route_geometry: '{~pdcBmjfsXsBrD{KhS}DvHyApCcf@l}@kg@z|@_MbX|GjHdXh^fm@dr@~\\l_@pFhF|GjCfeAbTdh@fFqRp}DoEn\\cHzR{FjLgCnFuBlG{AlHaAjJa@hLXtGnCnKtCnFxCfCvEl@lHBzA}@vIoFzCs@|CcAnEQ~NhHnf@zUpm@rc@d]zVrTnTr^~]xbAnaAhSnPgJd^kExPgOzk@maAx_Ek@~BuKvd@cJz`@oAzFiAtHvKzAlBXzNvB|b@hGl@Dha@zFbGf@fBAjQ_AxEbA`HxBtPpFpa@rO_Cv_B_ZlD}LlBGB',
  route_instructions: 
   [ [ '10',
       'Friedenstraße',
       294,
       0,
       0,
       '294m',
       'NW',
       317 ],
     [ '7',
       'Friedrichsberger Straße',
       270,
       7,
       0,
       '270m',
       'SW',
       213 ],
     [ '1',
       'Lebuser Straße',
       200,
       13,
       0,
       '200m',
       'S',
       190 ],
     [ '3',
       'B 1;B 5',
       290,
       15,
       0,
       '290m',
       'W',
       280 ],
     [ '11-3',
       'Lichtenberger Straße',
       598,
       31,
       0,
       '598m',
       'SE',
       157 ],
     [ '3',
       'Holzmarktstraße',
       472,
       43,
       0,
       '472m',
       'NW',
       301 ],
     [ '7',
       'Alexanderstraße',
       124,
       52,
       0,
       '124m',
       'S',
       188 ],
     [ '1',
       'Jannowitzbrücke',
       76,
       57,
       0,
       '76m',
       'S',
       188 ],
     [ '1',
       'Brückenstraße',
       164,
       59,
       0,
       '164m',
       'S',
       179 ],
     [ '3',
       'Rungestraße',
       105,
       65,
       0,
       '105m',
       'W',
       274 ],
     [ '3',
       'Am Köllnischen Park',
       73,
       66,
       0,
       '73m',
       'N',
       353 ],
     [ '15',
       '',
       0,
       69,
       0,
       '',
       'N',
       0 ] ],
  route_summary: 
   { total_distance: 2814,
     total_time: 211,
     start_point: 'Friedenstraße',
     end_point: 'Am Köllnischen Park' },
  alternative_geometries: [],
  alternative_instructions: [],
  alternative_summaries: [],
  route_name: 
   [ 'Lichtenberger Straße',
     'Holzmarktstraße' ],
  alternative_names: [ [ '', '' ] ],
  via_points: 
   [ [ 52.519934, 13.438647 ],
     [ 52.513162, 13.415509 ] ],
  via_indices: [ 0, 69 ],
  alternative_indices: [],
  hint_data: 
   { checksum: 222545162,
     locations: 
      [ '9XkCAJgBAAAtAAAA____f7idcBkPGuw__mMhA7cOzQA',
        'TgcEAFwFAAAAAAAAVAAAANIeb5DqBHs_ikkhA1W0zAA' ] } }

Developing

• OSRM develop branch, cloned from github.

• OSRM build with -DWITH_TOOLS=1 so that libOSRM is created

• Lua, luabind, and stxxl headers

• Boost >= 1.50 or Luabind headers patched as in https://github.com/DennisOSRM/Project-OSRM/issues/465#issuecomment-9133539 (note: it is possible to patch the luabind headers that are installed by apt)

• If you use luajit then you may need to put the luajit headers on the compile flags like:

  export CXXFLAGS="-I/usr/include/luajit-2.0/"

Mavericks

To build with OS X Mavericks you need to ensure the bindings link to libc++. An easy way to do this is to set:

export CXXFLAGS=-mmacosx-version-min=10.9

before building node-osrm.

Building

To build the bindings you need to first build and install the develop branch of Project-OSRM:

# grab develop branch
git clone -b develop https://github.com/DennisOSRM/Project-OSRM.git
cd Project-OSRM
mkdir build;
cd build;
cmake ../ -DWITH_TOOLS=1
make
sudo make install

NOTE: If you hit problems building Project-OSRM see the wiki for details.

Then build node-osrm against Project-OSRM installed in /usr/local:

git clone https://github.com/DennisOSRM/node-osrm.git
cd node-osrm
npm install

Testing

Run the tests like:

make test