Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
<div class='col6 margin3 pad4y clearfix'>
<div class='pad2y title '>Modern C++ routing engine for shortest paths in road networks.</div>
<div class='center'>
<a href='https://map.project-osrm.org/'><input type='button' class='button' value='VIEW DEMO' name='' /></a> <a href='docs/'><input type='button' class='button' value="DOCUMENTATION" name='' /></a>
<a href='https://map.project-osrm.org/'><input type='button' class='button' value='VIEW DEMO' name='' /></a> <a href='docs/'><input type='button' class='button' value="DOCUMENTATION" name='' /></a> <a href='libosrm-api/'><input type='button' class='button' value="LIBOSRM C++ API" name='' /></a>
<p class='pad2x'><a class="github-button" href="https://github.com/Project-OSRM/osrm-backend" data-icon="octicon-mark-github" data-style="mega" aria-label="View Project-OSRM/osrm-backend on GitHub">View on GitHub</a></p>
</div>
</div>
Expand Down
33 changes: 33 additions & 0 deletions libosrm-api/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# libosrm C++ API reference — generated output

Everything in this directory is generated. Do not hand-edit it.

It is the rendered C++ API reference for `libosrm`, produced from the public headers of
`Project-OSRM/osrm-backend` at pinned commit
[`e9abd4e0268c692210c4f8e6dcd1d184ff2c8f72`](https://github.com/Project-OSRM/osrm-backend/tree/e9abd4e0268c692210c4f8e6dcd1d184ff2c8f72)
— the tip of `master` on 2026-08-05, four commits after the `v26.8.0` release.

## Regenerating

The generator lives in the backend repo under `tools/api-docs/`. From a fresh checkout:

```sh
git clone https://github.com/Project-OSRM/osrm-backend && cd osrm-backend
git checkout e9abd4e0268c692210c4f8e6dcd1d184ff2c8f72
python tools/api-docs/build.py --output /tmp/libosrm-api
```

It needs `doxygen` and `node` on `PATH`; the renderer is fetched with
`npx --yes sourcey@3.6.5`, pinned to an exact version. Copy the result over this directory
**minus `_og/`** — GitHub Pages runs Jekyll on this repository and Jekyll drops
leading-underscore paths, and those files are only social-preview images.

Every file in this directory except this README is byte-for-byte what that command produces.

## What is covered

The scope is exactly the set of types that `docs/libosrm.md` in the backend repo tells
embedders to go and read in the headers: `osrm::OSRM`, `EngineConfig`, `Status`, every
`*Parameters` type under `include/engine/api`, `util::Coordinate` / `FloatCoordinate`, the
`util::json` sum type and `storage::StorageConfig`. Each symbol page links back to the exact
file and line at the pinned commit.
74 changes: 74 additions & 0 deletions libosrm-api/api.html

Large diffs are not rendered by default.

260 changes: 260 additions & 0 deletions libosrm-api/api/osrm-EngineConfig.html

Large diffs are not rendered by default.

204 changes: 204 additions & 0 deletions libosrm-api/api/osrm-MatchParameters.html

Large diffs are not rendered by default.

96 changes: 96 additions & 0 deletions libosrm-api/api/osrm-NearestParameters.html

Large diffs are not rendered by default.

266 changes: 266 additions & 0 deletions libosrm-api/api/osrm-OSRM.html

Large diffs are not rendered by default.

315 changes: 315 additions & 0 deletions libosrm-api/api/osrm-RouteParameters.html

Large diffs are not rendered by default.

228 changes: 228 additions & 0 deletions libosrm-api/api/osrm-TableParameters.html

Large diffs are not rendered by default.

99 changes: 99 additions & 0 deletions libosrm-api/api/osrm-TileParameters.html

Large diffs are not rendered by default.

200 changes: 200 additions & 0 deletions libosrm-api/api/osrm-TripParameters.html

Large diffs are not rendered by default.

65 changes: 65 additions & 0 deletions libosrm-api/api/osrm-engine-Bearing.html

Large diffs are not rendered by default.

260 changes: 260 additions & 0 deletions libosrm-api/api/osrm-engine-EngineConfig.html

Large diffs are not rendered by default.

84 changes: 84 additions & 0 deletions libosrm-api/api/osrm-engine-Hint.html

Large diffs are not rendered by default.

129 changes: 129 additions & 0 deletions libosrm-api/api/osrm-engine-SegmentHint.html

Large diffs are not rendered by default.

129 changes: 129 additions & 0 deletions libosrm-api/api/osrm-engine-api-BaseAPI.html

Large diffs are not rendered by default.

212 changes: 212 additions & 0 deletions libosrm-api/api/osrm-engine-api-BaseParameters.html

Large diffs are not rendered by default.

96 changes: 96 additions & 0 deletions libosrm-api/api/osrm-engine-api-MatchAPI-MatchingIndex.html

Large diffs are not rendered by default.

140 changes: 140 additions & 0 deletions libosrm-api/api/osrm-engine-api-MatchAPI.html

Large diffs are not rendered by default.

204 changes: 204 additions & 0 deletions libosrm-api/api/osrm-engine-api-MatchParameters.html

Large diffs are not rendered by default.

105 changes: 105 additions & 0 deletions libosrm-api/api/osrm-engine-api-NearestAPI.html

Large diffs are not rendered by default.

96 changes: 96 additions & 0 deletions libosrm-api/api/osrm-engine-api-NearestParameters.html

Large diffs are not rendered by default.

79 changes: 79 additions & 0 deletions libosrm-api/api/osrm-engine-api-RouteAPI-GeometryVisitor.html

Large diffs are not rendered by default.

298 changes: 298 additions & 0 deletions libosrm-api/api/osrm-engine-api-RouteAPI.html

Large diffs are not rendered by default.

315 changes: 315 additions & 0 deletions libosrm-api/api/osrm-engine-api-RouteParameters.html

Large diffs are not rendered by default.

65 changes: 65 additions & 0 deletions libosrm-api/api/osrm-engine-api-TableAPI-TableCellRef.html

Large diffs are not rendered by default.

213 changes: 213 additions & 0 deletions libosrm-api/api/osrm-engine-api-TableAPI.html

Large diffs are not rendered by default.

228 changes: 228 additions & 0 deletions libosrm-api/api/osrm-engine-api-TableParameters.html

Large diffs are not rendered by default.

99 changes: 99 additions & 0 deletions libosrm-api/api/osrm-engine-api-TileParameters.html

Large diffs are not rendered by default.

89 changes: 89 additions & 0 deletions libosrm-api/api/osrm-engine-api-TripAPI-TripIndex.html

Large diffs are not rendered by default.

129 changes: 129 additions & 0 deletions libosrm-api/api/osrm-engine-api-TripAPI.html

Large diffs are not rendered by default.

200 changes: 200 additions & 0 deletions libosrm-api/api/osrm-engine-api-TripParameters.html

Large diffs are not rendered by default.

66 changes: 66 additions & 0 deletions libosrm-api/api/osrm-engine-api-json-detail.html

Large diffs are not rendered by default.

98 changes: 98 additions & 0 deletions libosrm-api/api/osrm-engine-api-json.html

Large diffs are not rendered by default.

75 changes: 75 additions & 0 deletions libosrm-api/api/osrm-engine-api-tidy-Result.html

Large diffs are not rendered by default.

53 changes: 53 additions & 0 deletions libosrm-api/api/osrm-engine-api-tidy-Thresholds.html

Large diffs are not rendered by default.

65 changes: 65 additions & 0 deletions libosrm-api/api/osrm-engine-api-tidy.html

Large diffs are not rendered by default.

117 changes: 117 additions & 0 deletions libosrm-api/api/osrm-engine-api.html

Large diffs are not rendered by default.

26 changes: 26 additions & 0 deletions libosrm-api/api/osrm-engine-datafacade.html

Large diffs are not rendered by default.

82 changes: 82 additions & 0 deletions libosrm-api/api/osrm-engine.html

Large diffs are not rendered by default.

65 changes: 65 additions & 0 deletions libosrm-api/api/osrm-storage-StorageConfig.html

Large diffs are not rendered by default.

45 changes: 45 additions & 0 deletions libosrm-api/api/osrm-storage.html

Large diffs are not rendered by default.

174 changes: 174 additions & 0 deletions libosrm-api/api/osrm-util-Coordinate.html

Large diffs are not rendered by default.

150 changes: 150 additions & 0 deletions libosrm-api/api/osrm-util-FloatCoordinate.html

Large diffs are not rendered by default.

49 changes: 49 additions & 0 deletions libosrm-api/api/osrm-util-json-Array.html

Large diffs are not rendered by default.

37 changes: 37 additions & 0 deletions libosrm-api/api/osrm-util-json-False.html

Large diffs are not rendered by default.

37 changes: 37 additions & 0 deletions libosrm-api/api/osrm-util-json-Null.html

Large diffs are not rendered by default.

73 changes: 73 additions & 0 deletions libosrm-api/api/osrm-util-json-Number.html

Large diffs are not rendered by default.

49 changes: 49 additions & 0 deletions libosrm-api/api/osrm-util-json-Object.html

Large diffs are not rendered by default.

85 changes: 85 additions & 0 deletions libosrm-api/api/osrm-util-json-String.html

Large diffs are not rendered by default.

37 changes: 37 additions & 0 deletions libosrm-api/api/osrm-util-json-True.html

Large diffs are not rendered by default.

43 changes: 43 additions & 0 deletions libosrm-api/api/osrm-util-json.html

Large diffs are not rendered by default.

31 changes: 31 additions & 0 deletions libosrm-api/api/osrm-util-tag-latitude.html

Large diffs are not rendered by default.

31 changes: 31 additions & 0 deletions libosrm-api/api/osrm-util-tag-longitude.html

Large diffs are not rendered by default.

31 changes: 31 additions & 0 deletions libosrm-api/api/osrm-util-tag-unsafelatitude.html

Large diffs are not rendered by default.

31 changes: 31 additions & 0 deletions libosrm-api/api/osrm-util-tag-unsafelongitude.html

Large diffs are not rendered by default.

29 changes: 29 additions & 0 deletions libosrm-api/api/osrm-util-tag.html

Large diffs are not rendered by default.

233 changes: 233 additions & 0 deletions libosrm-api/api/osrm-util.html

Large diffs are not rendered by default.

43 changes: 43 additions & 0 deletions libosrm-api/api/osrm.html

Large diffs are not rendered by default.

43 changes: 43 additions & 0 deletions libosrm-api/index.html

Large diffs are not rendered by default.

407 changes: 407 additions & 0 deletions libosrm-api/llms-full.txt

Large diffs are not rendered by default.

63 changes: 63 additions & 0 deletions libosrm-api/llms.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# libosrm C++ API

> Represents a Open Source Routing Machine with access to its services.

## API Reference

- [osrm](/api/osrm.html): osrm Classes Name Description OSRM Represents a Open Source Routing Machine with access to its services. EngineConfig Configures an OSRM in…
- [OSRM](/api/osrm-OSRM.html): Represents a Open Source Routing Machine with access to its services.
- [EngineConfig](/api/osrm-EngineConfig.html): Configures an OSRM instance.
- [MatchParameters](/api/osrm-MatchParameters.html): Parameters specific to the OSRM Match service.
- [NearestParameters](/api/osrm-NearestParameters.html): Parameters specific to the OSRM Nearest service.
- [RouteParameters](/api/osrm-RouteParameters.html): Parameters specific to the OSRM Route service.
- [TableParameters](/api/osrm-TableParameters.html): Parameters specific to the OSRM Table service.
- [TileParameters](/api/osrm-TileParameters.html): Parameters specific to the OSRM Tile service.
- [TripParameters](/api/osrm-TripParameters.html): Parameters specific to the OSRM Trip service.
- [util](/api/osrm-util.html): util Classes Name Description Coordinate Represents a coordinate based on longitude and latitude in fixed representation. FloatCoordinate R…
- [Coordinate](/api/osrm-util-Coordinate.html): Represents a coordinate based on longitude and latitude in fixed representation.
- [FloatCoordinate](/api/osrm-util-FloatCoordinate.html): Represents a coordinate based on longitude and latitude in floating representation.
- [engine](/api/osrm-engine.html): engine Classes Name Description Bearing EngineConfig Configures an OSRM instance. Hint Hint is deprecated. It is kept for backward-compatib…
- [Bearing](/api/osrm-engine-Bearing.html): Bearing Copy struct Bearing Defined in include/engine/bearing.hpp:34 List of all members Name Kind Owner bearing variable Declared here ran…
- [engine::EngineConfig](/api/osrm-engine-EngineConfig.html): Configures an OSRM instance.
- [Hint](/api/osrm-engine-Hint.html): Hint is deprecated. It is kept for backward-compatible serialization.
- [SegmentHint](/api/osrm-engine-SegmentHint.html): SegmentHint is deprecated.
- [storage](/api/osrm-storage.html): storage Classes Name Description StorageConfig Configures OSRM 's file storage paths. Functions Return Name Description std::istream & oper…
- [StorageConfig](/api/osrm-storage-StorageConfig.html): Configures OSRM's file storage paths.
- [tag](/api/osrm-util-tag.html): tag Classes Name Description latitude longitude unsafelatitude unsafelongitude
- [tag::latitude](/api/osrm-util-tag-latitude.html): latitude Copy struct latitude Defined in include/util/coordinate.hpp:48
- [tag::longitude](/api/osrm-util-tag-longitude.html): longitude Copy struct longitude Defined in include/util/coordinate.hpp:51
- [tag::unsafelatitude](/api/osrm-util-tag-unsafelatitude.html): unsafelatitude Copy struct unsafelatitude Defined in include/util/coordinate.hpp:54
- [tag::unsafelongitude](/api/osrm-util-tag-unsafelongitude.html): unsafelongitude Copy struct unsafelongitude Defined in include/util/coordinate.hpp:57
- [json](/api/osrm-util-json.html): json Classes Name Description String Typed string wrapper. Number Typed floating point number. True Typed True . False Typed False . Null T…
- [json::String](/api/osrm-util-json-String.html): Typed string wrapper.
- [json::Number](/api/osrm-util-json-Number.html): Typed floating point number.
- [json::True](/api/osrm-util-json-True.html): Typed True.
- [json::False](/api/osrm-util-json-False.html): Typed False.
- [json::Null](/api/osrm-util-json-Null.html): Typed Null.
- [json::Object](/api/osrm-util-json-Object.html): Typed Object.
- [json::Array](/api/osrm-util-json-Array.html): Typed Array.
- [api](/api/osrm-engine-api.html): api Classes Name Description BaseAPI MatchAPI NearestAPI RouteAPI TableAPI TripAPI BaseParameters General parameters for OSRM service queri…
- [api::BaseAPI](/api/osrm-engine-api-BaseAPI.html): BaseAPI Copy class BaseAPI Defined in include/engine/api/base_api.hpp:22 Subclassed by: NearestAPI , RouteAPI , TableAPI List of all member…
- [api::MatchAPI](/api/osrm-engine-api-MatchAPI.html): MatchAPI Copy class MatchAPI Defined in include/engine/api/match_api.hpp:18 Inherits: RouteAPI List of all members Name Kind Owner MatchAPI…
- [MatchAPI::MatchingIndex](/api/osrm-engine-api-MatchAPI-MatchingIndex.html): FIXME this logic is a little backwards.
- [api::NearestAPI](/api/osrm-engine-api-NearestAPI.html): NearestAPI Copy class NearestAPI Defined in include/engine/api/nearest_api.hpp:18 Inherits: BaseAPI List of all members Name Kind Owner par…
- [api::RouteAPI](/api/osrm-engine-api-RouteAPI.html): RouteAPI Copy class RouteAPI Defined in include/engine/api/route_api.hpp:38 Inherits: BaseAPI Subclassed by: MatchAPI , TripAPI List of all…
- [RouteAPI::GeometryVisitor](/api/osrm-engine-api-RouteAPI-GeometryVisitor.html): GeometryVisitor Copy template typename Builder > class GeometryVisitor Defined in include/engine/api/route_api.hpp:568 List of all members…
- [api::TableAPI](/api/osrm-engine-api-TableAPI.html): TableAPI Copy class TableAPI Defined in include/engine/api/table_api.hpp:28 Inherits: BaseAPI List of all members Name Kind Owner TableAPI…
- [TableAPI::TableCellRef](/api/osrm-engine-api-TableAPI-TableCellRef.html): TableCellRef Copy struct TableCellRef Defined in include/engine/api/table_api.hpp:33 List of all members Name Kind Owner row variable Decla…
- [api::TripAPI](/api/osrm-engine-api-TripAPI.html): TripAPI Copy class TripAPI Defined in include/engine/api/trip_api.hpp:16 Inherits: RouteAPI List of all members Name Kind Owner TripAPI fun…
- [TripAPI::TripIndex](/api/osrm-engine-api-TripAPI-TripIndex.html): TripIndex Copy struct TripIndex Defined in include/engine/api/trip_api.hpp:97 List of all members Name Kind Owner sub_trip_index variable D…
- [api::BaseParameters](/api/osrm-engine-api-BaseParameters.html): General parameters for OSRM service queries.
- [api::MatchParameters](/api/osrm-engine-api-MatchParameters.html): Parameters specific to the OSRM Match service.
- [api::NearestParameters](/api/osrm-engine-api-NearestParameters.html): Parameters specific to the OSRM Nearest service.
- [api::RouteParameters](/api/osrm-engine-api-RouteParameters.html): Parameters specific to the OSRM Route service.
- [api::TableParameters](/api/osrm-engine-api-TableParameters.html): Parameters specific to the OSRM Table service.
- [api::TileParameters](/api/osrm-engine-api-TileParameters.html): Parameters specific to the OSRM Tile service.
- [api::TripParameters](/api/osrm-engine-api-TripParameters.html): Parameters specific to the OSRM Trip service.
- [datafacade](/api/osrm-engine-datafacade.html): Fwd. decls.
- [api::json](/api/osrm-engine-api-json.html): json Functions Return Name Description util::json::String makePolyline util::json::Object makeGeoJSONGeometry util::json::Object makeStepMa…
- [api::tidy](/api/osrm-engine-api-tidy.html): tidy Classes Name Description Thresholds Result Typedefs Return Name Description std::vector Mask std::vector Mapping Mask Copy using Mask…
- [tidy::Thresholds](/api/osrm-engine-api-tidy-Thresholds.html): Thresholds Copy struct Thresholds Defined in include/engine/api/match_parameters_tidy.hpp:18 List of all members Name Kind Owner distance_i…
- [tidy::Result](/api/osrm-engine-api-tidy-Result.html): Result Copy struct Result Defined in include/engine/api/match_parameters_tidy.hpp:27 List of all members Name Kind Owner parameters variabl…
- [json::detail](/api/osrm-engine-api-json-detail.html): detail Functions Return Name Description bool isValidModifier inline Check whether to include a modifier in the result of the API. bool has…
- [API Reference](/api.html): Structs api::BaseParameters api::MatchParameters api::NearestParameters api::RouteParameters api::TableParameters api::TileParameters api::…
1 change: 1 addition & 0 deletions libosrm-api/search-index.json

Large diffs are not rendered by default.

61 changes: 61 additions & 0 deletions libosrm-api/sitemap.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- Generated by Sourcey https://sourcey.com -->
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>/api/osrm.html</loc></url>
<url><loc>/api/osrm-OSRM.html</loc></url>
<url><loc>/api/osrm-EngineConfig.html</loc></url>
<url><loc>/api/osrm-MatchParameters.html</loc></url>
<url><loc>/api/osrm-NearestParameters.html</loc></url>
<url><loc>/api/osrm-RouteParameters.html</loc></url>
<url><loc>/api/osrm-TableParameters.html</loc></url>
<url><loc>/api/osrm-TileParameters.html</loc></url>
<url><loc>/api/osrm-TripParameters.html</loc></url>
<url><loc>/api/osrm-util.html</loc></url>
<url><loc>/api/osrm-util-Coordinate.html</loc></url>
<url><loc>/api/osrm-util-FloatCoordinate.html</loc></url>
<url><loc>/api/osrm-engine.html</loc></url>
<url><loc>/api/osrm-engine-Bearing.html</loc></url>
<url><loc>/api/osrm-engine-EngineConfig.html</loc></url>
<url><loc>/api/osrm-engine-Hint.html</loc></url>
<url><loc>/api/osrm-engine-SegmentHint.html</loc></url>
<url><loc>/api/osrm-storage.html</loc></url>
<url><loc>/api/osrm-storage-StorageConfig.html</loc></url>
<url><loc>/api/osrm-util-tag.html</loc></url>
<url><loc>/api/osrm-util-tag-latitude.html</loc></url>
<url><loc>/api/osrm-util-tag-longitude.html</loc></url>
<url><loc>/api/osrm-util-tag-unsafelatitude.html</loc></url>
<url><loc>/api/osrm-util-tag-unsafelongitude.html</loc></url>
<url><loc>/api/osrm-util-json.html</loc></url>
<url><loc>/api/osrm-util-json-String.html</loc></url>
<url><loc>/api/osrm-util-json-Number.html</loc></url>
<url><loc>/api/osrm-util-json-True.html</loc></url>
<url><loc>/api/osrm-util-json-False.html</loc></url>
<url><loc>/api/osrm-util-json-Null.html</loc></url>
<url><loc>/api/osrm-util-json-Object.html</loc></url>
<url><loc>/api/osrm-util-json-Array.html</loc></url>
<url><loc>/api/osrm-engine-api.html</loc></url>
<url><loc>/api/osrm-engine-api-BaseAPI.html</loc></url>
<url><loc>/api/osrm-engine-api-MatchAPI.html</loc></url>
<url><loc>/api/osrm-engine-api-MatchAPI-MatchingIndex.html</loc></url>
<url><loc>/api/osrm-engine-api-NearestAPI.html</loc></url>
<url><loc>/api/osrm-engine-api-RouteAPI.html</loc></url>
<url><loc>/api/osrm-engine-api-RouteAPI-GeometryVisitor.html</loc></url>
<url><loc>/api/osrm-engine-api-TableAPI.html</loc></url>
<url><loc>/api/osrm-engine-api-TableAPI-TableCellRef.html</loc></url>
<url><loc>/api/osrm-engine-api-TripAPI.html</loc></url>
<url><loc>/api/osrm-engine-api-TripAPI-TripIndex.html</loc></url>
<url><loc>/api/osrm-engine-api-BaseParameters.html</loc></url>
<url><loc>/api/osrm-engine-api-MatchParameters.html</loc></url>
<url><loc>/api/osrm-engine-api-NearestParameters.html</loc></url>
<url><loc>/api/osrm-engine-api-RouteParameters.html</loc></url>
<url><loc>/api/osrm-engine-api-TableParameters.html</loc></url>
<url><loc>/api/osrm-engine-api-TileParameters.html</loc></url>
<url><loc>/api/osrm-engine-api-TripParameters.html</loc></url>
<url><loc>/api/osrm-engine-datafacade.html</loc></url>
<url><loc>/api/osrm-engine-api-json.html</loc></url>
<url><loc>/api/osrm-engine-api-tidy.html</loc></url>
<url><loc>/api/osrm-engine-api-tidy-Thresholds.html</loc></url>
<url><loc>/api/osrm-engine-api-tidy-Result.html</loc></url>
<url><loc>/api/osrm-engine-api-json-detail.html</loc></url>
<url><loc>/api.html</loc></url>
</urlset>
2,474 changes: 2,474 additions & 0 deletions libosrm-api/sourcey.css

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions libosrm-api/sourcey.js

Large diffs are not rendered by default.