mslwk/route-planner

A profiled route planning application designed for urban environments

, _(*1)

Profiled route planner

The project finds a route well-suited for the requested type of vehicle in an urban environment. It uses PostgreSQL with additional extensions., _(*2)

Supported vehicles

• motorcycle
• scooter
• bicycle

System requirements

• PostgreSQL 9.6
• PostGIS 2.2
• pgRouting 2.2
• osm2pgrouting 2.0
• osm2pgsql 0.8
• PHP 7.1 with pgsql

Installation

1. Use composer to include the library in your project.

composer require mslwk/route-planner

1. After cloning the repository download a city extract in .osm file and place it in vendor/mslwk/route-planner/maps/map.osm, _(*3)

2. Create configs/config.yml file based on configs/config.example.yml, _(*4)

3. Run deployment/deploy.sh script

Detailed description

The library utilises two PostgreSQL databases to find the best route between two points. One database is a complete set of information from OSM and is used e.g. to find streets which with trams. The second one is pgRouting database which represents a city as a weighted graph and calculates the route., _(*5)

Nominatim API is used to find the coordinates between the given addresses. The coordinates are used to find the graph vertices that are closest to the addresses., _(*6)

The library supports two shortest-path algorithms (Dijkstra/A*)., _(*7)

The route is returned as an array of coordinates., _(*8)

The data calculated is a json object., _(*9)

##### Example of a successfully calculated route (from JSON API) #####, _(*10)

, _(*11)

##### Example of a failure (from JSON API) #####, _(*12)

, _(*13)

Live examples

The examples show a route calculated using the library and displayed using Google Maps., _(*14)

Motorcycle

, _(*15)

Bicycle

, _(*16)

Scooter

, _(*17)