routing

Street routing from one to many places or many to one. The order in the response array corresponds to the order of coordinates of the \`many\` parameter in the request body.

post/api/v1/one-to-many

Request body

onestring required

geo location as latitude;longitude

manystring[] required

geo locations as latitude;longitude,latitude;longitude,...

The number of accepted locations is limited by server config variable onetomany_max_many.

Street modes

WALK
BIKE
RENTAL Experimental. Expect unannounced breaking changes (without version bumps) for all parameters and returned structs.
CAR
HGV Heavy goods vehicles (only supported for direct connections)
CAR_PARKING Experimental. Expect unannounced breaking changes (without version bumps) for all parameters and returned structs.
CAR_DROPOFF Experimental. Expect unannounced breaking changes (without version bumps) for all perameters and returned structs.
ODM on-demand taxis from the Prima+ÖV Project
RIDE_SHARING ride sharing from the Prima+ÖV Project
FLEX flexible transports

Transit modes

TRANSIT: translates to TRAM,FERRY,AIRPLANE,BUS,COACH,RAIL,ODM,RIDE_SHARING,FUNICULAR,AERIAL_LIFT,OTHER
TRAM: trams
SUBWAY: subway trains (Paris Metro, London Underground, but also NYC Subway, Hamburger Hochbahn, and other non-underground services)
FERRY: ferries
AIRPLANE: airline flights
BUS: short distance buses (does not include COACH)
COACH: long distance buses (does not include BUS)
RAIL: translates to HIGHSPEED_RAIL,LONG_DISTANCE,NIGHT_RAIL,REGIONAL_RAIL,SUBURBAN,SUBWAY
HIGHSPEED_RAIL: long distance high speed trains (e.g. TGV)
LONG_DISTANCE: long distance inter city trains
NIGHT_RAIL: long distance night trains
REGIONAL_FAST_RAIL: deprecated, REGIONAL_RAIL will be used
REGIONAL_RAIL: regional train
SUBURBAN: suburban trains (e.g. S-Bahn, RER, Elizabeth Line, ...)
ODM: demand responsive transport
RIDE_SHARING: ride sharing
FUNICULAR: Funicular. Any rail system designed for steep inclines.
AERIAL_LIFT: Aerial lift, suspended cable car (e.g., gondola lift, aerial tramway). Cable transport where cabins, cars, gondolas or open chairs are suspended by means of one or more cables.
AREAL_LIFT: deprecated
METRO: deprecated
CABLE_CAR: deprecated

maxnumber required

maximum travel time in seconds. Is limited by server config variable street_routing_max_direct_seconds.

maxMatchingDistancenumber required

maximum matching distance in meters to match geo coordinates to the street network

Is limited by server config variable max_max_matching_distance, larger values are capped to this limit.

elevationCosts'NONE' | 'LOW' | 'HIGH'

Different elevation cost profiles for street routing. Using a elevation cost profile will prefer routes with a smaller incline and smaller difference in elevation, even if the routed way is longer.

NONE: Ignore elevation data for routing. This is the default behavior
LOW: Add a low penalty for inclines. This will favor longer paths, if the elevation increase and incline are smaller.
HIGH: Add a high penalty for inclines. This will favor even longer paths, if the elevation increase and incline are smaller.

arriveByboolean required

true = many to one false = one to many

withDistanceboolean

If true, the response includes the distance in meters for each path. This requires path reconstruction and may be slower than duration-only queries.

Response

A list of durations. If no path was found, the object is empty.

durationnumber

duration in seconds if a path was found, otherwise missing

distancenumber

distance in meters if a path was found and distance computation was requested, otherwise missing

Changes

Changed in 5 of the 52 revisions of this API.511

Jul 16, 2026dbfe4b7f2bab1See the full diff
- ○
  added the new HGV enum value to the request property
  request-property-enum-value-added
Feb 24, 202655cf0dab5be03See the full diff
- ○
  the request property became optional
  request-property-became-optional
- ○
  the request property became optional
  request-property-became-optional
- ○
  the request property default value false was added
  request-property-default-value-added
Feb 24, 202630900fce77f112See the full diff
- ▲
  the request property became required
  request-property-became-required
- ○
  the request property default value false was removed
  request-property-default-value-removed
- ○
  added the non-success response with the status
  response-non-success-status-added
Feb 22, 20266775a2d6764d3See the full diff
- ○
  added the new DEBUG_BUS_ROUTE enum value to the request property
  request-property-enum-value-added
- ○
  added the new DEBUG_FERRY_ROUTE enum value to the request property
  request-property-enum-value-added
- ○
  added the new DEBUG_RAILWAY_ROUTE enum value to the request property
  request-property-enum-value-added
Feb 21, 2026b7bf68a0d6f342See the full diff
- ▲
  removed the enum value DEBUG_BUS_ROUTE of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value DEBUG_FERRY_ROUTE of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value DEBUG_RAILWAY_ROUTE of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value HGV of the request property
  request-property-enum-value-removed
- ○
  the request property with a default value became required
  request-property-became-required-with-default
- ○
  removed the non-success response with the status
  response-non-success-status-removed
This revision also has 30 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history