1 unstable release
0.1.0 | Aug 8, 2024 |
---|
#283 in Geospatial
Used in bbox-server
125KB
3K
SLoC
BBOX Routing Service
Routing services with Contraction Hierarchy.
Features:
- OGC API - Routes - Part 1: Core
- Multiple search APIs
- OGC API route requests
- Basic from/to requests
- Valhalla API compatible requests
- Builtin storage backends: PostGIS, GeoPackage
- Extract routing graphs from OSM planet files
Configuration
GeoPackage line geometry table:
[[routing.service]]
profile = "railway"
gpkg = "../assets/railway-test.gpkg"
table = "flows"
geom = "geom"
PostGIS Edge/Vertices tables:
# Node search distance
search_dist = 0.01
# Edge table
table = "rail_arcs"
# Node/Vertices table
node_table = "rail_arcs_vertices_pgr"
# Geometry column
geom = "geom"
# Node ID column in node table
node_id = "id"
# Cost column
cost = "cost"
# Column with source node ID
node_src = "source"
# Column with destination (target) node ID
node_dst = "target"
This assumes tables created e.g. with PgRouting pgr_createTopology
.
The contraction hierarchy is created on first startup and stored as cache files named .graph.bin
and .nodes.bin
Usage
Request examples:
curl -s -X 'POST' \
'http://localhost:8080/routes?mode=sync' \
-H 'accept: application/geo+json' \
-H 'Content-Type: application/json' \
-d '{
"name": "Route from A to B",
"waypoints": {
"type": "MultiPoint",
"coordinates": [
[9.35213353, 47.0935012],
[9.3422712, 47.1011887]
]
},
"preference": "fastest",
"dataset": "OSM"
}'
Basic from/to request:
curl -s 'http://localhost:8080/routes/basic?profile=railway&from_pos=9.35213353,47.0935012&to_pos=9.3422712,47.1011887'
Zurich - Munich:
curl -s 'http://localhost:8080/routes/basic?profile=railway&from_pos=8.53636,47.37726&to_pos=11.56096,48.14019'
Valhalla endpoint (e.g. for Valhalla QGIS Plugin):
Base URL: http://localhost:8080/routes/valhalla
Dependencies
~95MB
~1.5M SLoC