{"id":28201176,"url":"https://github.com/itinero/routing-api","last_synced_at":"2025-06-12T18:31:00.014Z","repository":{"id":52234565,"uuid":"52670849","full_name":"itinero/routing-api","owner":"itinero","description":"An API based on Itinero.","archived":false,"fork":false,"pushed_at":"2019-12-16T11:36:08.000Z","size":780,"stargazers_count":13,"open_issues_count":11,"forks_count":16,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2025-05-16T22:15:54.663Z","etag":null,"topics":["api","openstreetmap","routing-engine","server"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/itinero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-27T14:38:03.000Z","updated_at":"2023-11-30T14:56:27.000Z","dependencies_parsed_at":"2022-08-26T04:10:35.497Z","dependency_job_id":null,"html_url":"https://github.com/itinero/routing-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/itinero/routing-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itinero%2Frouting-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itinero%2Frouting-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itinero%2Frouting-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itinero%2Frouting-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itinero","download_url":"https://codeload.github.com/itinero/routing-api/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itinero%2Frouting-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259519177,"owners_count":22870324,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["api","openstreetmap","routing-engine","server"],"created_at":"2025-05-16T22:16:06.706Z","updated_at":"2025-06-12T18:31:00.006Z","avatar_url":"https://github.com/itinero.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  Itinero API\n\nThis project is an implementation of a basic routing API based on Itinero. It loads RouterDb files from a configured folder and exposes one routing instance per file.\n\n### Goal\n\nThis project serves both as a demo project for Itinero and an easy way of setting up a routing instance.\n\n### Setup\n\nBasically you need build the project and place a RouterDb file into the configured data folder.\n\n1. Install [.NET core](https://www.microsoft.com/net/core) for your platform.\n1. Run the build script, build.sh or build.bat on windows.\n1. Then [download a RouterDb](http://files.itinero.tech/data/itinero/routerdbs/planet/europe/) file or create one using the [Itinero data processing tool](https://github.com/itinero/idp).\n1. Place the RouterDb file into the configured data folder, by default this is ./src/Itinero.API/data. Configuration file is [here](https://github.com/itinero/routing-api/blob/develop/src/Itinero.API/appsettings.json).\n1. Run the run script, run.sh or run.bat on windows.\n\nYou should new see the service reporting messages on loading the RouterDb's you configured:\n\n```\n[Bootstrapper] information - Loading all routerdb's from path: \\path\\to\\src\\Itinero.API\\data\n[Bootstrapper] information - Loaded instance luxembourg from: \\path\\to\\src\\Itinero.API\\data\\luxembourg.c.cf.routerdb\nHosting environment: Production\nContent root path: \\path\\to\\src\\Itinero.API\nNow listening on: http://localhost:5000\nApplication started. Press Ctrl+C to shut down.\n[Bootstrapper] information - Loaded instance belgium from: \\path\\to\\src\\Itinero.API\\data\\belgium.c.cf.routerdb\n[Bootstrapper] information - Loaded instance netherlands from: \\path\\to\\rc\\Itinero.API\\data\\netherlands.c.cf.routerd\n```\n\n### API\n\nWhen the service is setup one instance per RouterDb will be available. The name of the instance is identical to the name of the file until the first '.'. For example, 'belgium.c.cf.routerdb' will be 'belgium'.\n\nBy default when opening your browser at http://localhost:5000/ there will be a list with loaded instances. When you click one of the instances a map will open centered on the loaded area, clicking on the map still set a startpoint and clicking again an instance.\n\nThe following is available:\n\n- http://localhost:5000/ : A list of loaded instances.\n- http://localhost:5000/{instance} : The map centered on the loaded area in the instance with routing enable for cars.\n\nThe API:\n\nhttp://localhost:5000/{instance}/routing : Accepts requests using the following parameters:\n- profile: One of the profiles loaded in the RouterDb, think _car_, _bicycle_ or _pedestrian_.\n- loc: Add this parameter at least twice, first is startpoint, last is the destination.\n\nMake sure to ask the API for JSON by adding _Content-Type: application/json_ header. The route is returned as GeoJson.\n\nExample: http://localhost:5000/belgium/routing?profile=car\u0026loc=51.055207,3.722992\u0026loc=50.906497,4.194031\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitinero%2Frouting-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitinero%2Frouting-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitinero%2Frouting-api/lists"}