Compilation
---

Compiling the source code is easy. If you are running a decent linux 
installing dependencies and running make should suffice. Make sure the following
dependencies are installed:

 - Boost		1.37+
 - sparsehash   1.4+
 - g++			4.2+ (with warnings and unsupported), 4.4+
 - libxml2		2.7+
 - scons 		1.20+
 - stxxl		1.2.1+

Building the binaries is done by using scons. It should check for required
libraries and header files and report missing ones.The Scons script accepts
two optional parameters:

--cxx=XYZ lets you specify to use C++ compiler XYZ[[BR]]
--stxxlroot=/path/to/stxxl lets you specify the path to the root directory 
          of the stxxl library if it's installed in a non default location

Once the dependencies are properly installed running 'scons' should build the 
binaries. The Sconstruct has been built for Ubuntu 10.04, but it should work 
under any recent Linux. 

Compiling Under Windows
---

Visual Studio 2008 solution and projects are included for Windows compilation, and
can be found in the vsproject directory.  All required dependencies need to be
present, and the osrm.vsprops file will need to be edited to point to the various
dependency directories.  The suggested directory structure for dependencies is:

lib\
  boost\
    boost  (contains includes)
	lib
  bzip2\
    bin  (contains libbz2.dll)
	include
	lib
  iconv\
    bin
	include
	lib
  libxml2\
    bin
	include
	lib
  protobuf
    bin  (contains protoc.exe)
	include
	lib  (contains libprotobuf.lib and libprotobuf-debug.lib)
  sparsehash
    src
  stxxl
    include
	lib  (contains libstxxl.lib and libstxxl-debug.lib)
  zlib
    bin
	include
	lib  (zlib.lib and zlibd.lib)
	
Using the above structure, the only changes necessary for compilations are setting
the base paths in osrm.vsprops.  


Running the Server
---
Running the server requires preprocessing data from Openstreetmap. To do so you
you need to acquire an .osm file. Beware of the world file, because you need
serious computing power to preprocess it. Start with a smaller country. The
preprocessing runs in three steps, all done by seperate programs.

'extractNetwork file.osm' extracts the road network of an osm file. This is
necessary, because the osm data is not made to support fast routing out of the
box. The output of the step is a file called 'file.osrm'

'createHierarchy file.osrm' preprocesses the road network and computes additional
information that is exploited later to speed up the path computation. The output
of this step consists of two file 'file.osrm.hsgr' and 'file.osrm.nodes'. The first
file is the so-called hierarchy that speeds up the path computation while the
latter one carries (among other things) geographical information.

'routed' starts the server on TCP Port 5000. The
server communicates over http and can be queried by any browser or http-capable
command line tool. The server responds with KML-formatted output.Assume the 
server is installed on machine localhost and a map containing the Netherlands 
has been installed. Computing a route from Amsterdam to Den Haag can be done by
calling 
        http://localhost:5000/route&52.370197&4.890444&52.048167&4.3175
which gives a shortest (fastest) route between the two points. To locate a
point in the map that is nearest to a given coordinate use the following call
        http://localhost:5000/nearest&52.048167&4.3175