Project OSRM: C++ backend
C++ Cucumber JavaScript CMake Lua Shell Other
Latest commit 9e323d2 Jul 4, 2016 @MoKob MoKob committed with TheMarex improve sliproad / fork handling
Failed to load latest commit information.
cmake Fix various issues with pkg-config Jun 4, 2016
docker [skip ci] Update docker files to gcc 5 Jul 21, 2016
docs switch api format to new structure Jul 21, 2016
example Use mmap instead of read - it's a lot faster here. Jun 27, 2016
features improve sliproad / fork handling Jul 22, 2016
include improve sliproad / fork handling Jul 22, 2016
profiles fixing lua issue in profile Jun 28, 2016
scripts Show user hint on wrong Node.js version, fixes #2435. Jun 21, 2016
src improve sliproad / fork handling Jul 22, 2016
test Add benchmark target to Makefile and save timings Apr 5, 2016
third_party Rip out custom CSV parser code and its third_party dependency May 19, 2016
unit_tests Use mmap instead of read - it's a lot faster here. Jun 28, 2016
.clang-format expose lanes as enums, adjusted for comments Jun 27, 2016
.clang-tidy Integration scripts for Clang's Modernize and Tidy tool. Sep 22, 2015 Add simple cncc file Jan 5, 2016
.eslintrc Rewrite cucumber test suite in JS Mar 24, 2016
.gitignore Implement Turn Lane Api Jun 27, 2016
.gitmodules Removing Docs submodule Dec 26, 2012
.travis.yml Reenable ARM builds Jul 22, 2016 Update the changelog for 5.3.0 Jul 22, 2016
CMakeLists.txt Change OSRM version to 5.3.0 Jun 28, 2016 [skip ci] Add docs for contributing Jul 19, 2016 Exclude new node_modules folder that might be around if test cases ha… Apr 5, 2016
LICENCE.TXT We are at 2016 for the license Jan 4, 2016 [skip ci] Fix example URLs in readme Jul 21, 2016
appveyor-build.bat [skip travis] make AppVeyor publish binaries again Apr 29, 2016
appveyor.yml Remove develop branch from appveyor Apr 23, 2016
build-local.bat make AppVeyor work again Mar 31, 2016
codecov.yml Fix codecov.yml May 12, 2016
cucumber.js adding tests for guidance Apr 8, 2016
package.json update cucumber to 1.2.1 and remove hack Jul 13, 2016
profile.lua readding profile.lua Jul 2, 2013
taginfo.json basic turn lane handling Jun 27, 2016


The Open Source Routing Machine is a high performance routing engine written in C++11 designed to run on OpenStreetMap data.

Current build status

build config status
Linux Build Status
Windows Build status
Coverage codecov


For instructions on how to build and run OSRM, please consult the Wiki.

To quickly try OSRM use our free and daily updated online service


Full documentation

Quick start

Building OSRM assuming all dependencies are installed:

mkdir -p build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .
sudo cmake --build . --target install

Loading preparing a dataset and starting the server:

osrm-extract data.osm.pbf -p profiles/car.lua
osrm-contract data.osrm
osrm-routed data.osrm

Running a query on your local server:


Running a request against the Demo Server

First read the API usage policy.

Then run simple query with instructions and alternatives on Berlin:


References in publications

When using the code in a (scientific) publication, please cite

 author = {Luxen, Dennis and Vetter, Christian},
 title = {Real-time routing with OpenStreetMap data},
 booktitle = {Proceedings of the 19th ACM SIGSPATIAL International Conference on Advances in Geographic Information Systems},
 series = {GIS '11},
 year = {2011},
 isbn = {978-1-4503-1031-4},
 location = {Chicago, Illinois},
 pages = {513--516},
 numpages = {4},
 url = {},
 doi = {10.1145/2093973.2094062},
 acmid = {2094062},
 publisher = {ACM},
 address = {New York, NY, USA},