{"id":37010490,"url":"https://github.com/maciejslawik/route-planner","last_synced_at":"2026-01-14T01:00:20.094Z","repository":{"id":57021465,"uuid":"98098715","full_name":"maciejslawik/route-planner","owner":"maciejslawik","description":"A profiled route planning library which calculates routes in urban environments for two-wheeled vehicles","archived":false,"fork":false,"pushed_at":"2017-07-24T20:27:36.000Z","size":1539,"stargazers_count":9,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-20T20:46:24.131Z","etag":null,"topics":["navigation","pgrouting","php","postgis","postgresql","route-planner"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maciejslawik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-23T13:10:49.000Z","updated_at":"2024-04-20T20:46:24.132Z","dependencies_parsed_at":"2022-08-23T13:50:41.628Z","dependency_job_id":null,"html_url":"https://github.com/maciejslawik/route-planner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maciejslawik/route-planner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maciejslawik%2Froute-planner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maciejslawik%2Froute-planner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maciejslawik%2Froute-planner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maciejslawik%2Froute-planner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maciejslawik","download_url":"https://codeload.github.com/maciejslawik/route-planner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maciejslawik%2Froute-planner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28407634,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T00:40:43.272Z","status":"ssl_error","status_checked_at":"2026-01-14T00:40:42.636Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["navigation","pgrouting","php","postgis","postgresql","route-planner"],"created_at":"2026-01-14T01:00:18.380Z","updated_at":"2026-01-14T01:00:19.909Z","avatar_url":"https://github.com/maciejslawik.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Latest Stable Version](https://poser.pugx.org/mslwk/route-planner/v/stable)](https://packagist.org/packages/mslwk/route-planner)\n[![Latest Unstable Version](https://poser.pugx.org/mslwk/route-planner/v/unstable)](https://packagist.org/packages/mslwk/route-planner)\n[![License](https://poser.pugx.org/mslwk/route-planner/license)](https://packagist.org/packages/mslwk/route-planner)\n\n# Profiled route planner #\n\nThe project finds a route well-suited for the requested type of vehicle in an urban environment.\nIt uses PostgreSQL with additional extensions.\n##### Supported vehicles #####\n* motorcycle\n* scooter\n* bicycle\n\n\n## System requirements ##\n* PostgreSQL 9.6\n* PostGIS 2.2\n* pgRouting 2.2\n* osm2pgrouting 2.0\n* osm2pgsql 0.8\n* PHP 7.1 with pgsql\n\n## Installation ##\n\n1. Use composer to include the library in your project.\n\n```\ncomposer require mslwk/route-planner\n```\n\n2. After cloning the repository download a city extract in .osm file and place it in \n``\nvendor/mslwk/route-planner/maps/map.osm\n``\n\n3. Create configs/config.yml file based on configs/config.example.yml\n4. Run deployment/deploy.sh script\n\n## Detailed description ##\n\nThe library utilises two PostgreSQL databases to find the best route between two points.\nOne database is a complete set of information from OSM and is used e.g. to find \nstreets which with trams. The second one is pgRouting database which represents a city\n as a weighted graph and calculates the route.\n \n Nominatim API is used to find the coordinates between the given addresses. The coordinates\n are used to find the graph vertices that are closest to the addresses.\n \n The library supports two shortest-path algorithms (Dijkstra/A*).\n \n The route is returned as an array of coordinates.\n \n The data calculated is a json object.\n \n ##### Example of a successfully calculated route (from JSON API) #####\n \n ![Alt text](docs/success.png?raw=true \"Route found\")\n \n ##### Example of a failure (from JSON API) #####\n \n ![Alt text](docs/failure.png?raw=true \"Route found\")\n  \n  \n## Live examples ##\n\nThe examples show a route calculated using the library and displayed using\nGoogle Maps. \n\n#### Motorcycle ####\n\n ![Alt text](docs/example_motorcycle.png?raw=true)\n\n#### Bicycle ####\n\n ![Alt text](docs/example_bicycle.png?raw=true)\n \n#### Scooter ####\n \n ![Alt text](docs/example_scooter.png?raw=true)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaciejslawik%2Froute-planner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaciejslawik%2Froute-planner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaciejslawik%2Froute-planner/lists"}