One to many routing Computes the minimal duration from one place to many or vice versa. The order in the response array corresponds to the order of coordinates of the \`many\` parameter in the query.
Query parameters
geo location as latitude;longitude
geo locations as latitude;longitude,latitude;longitude,...
The number of accepted locations is limited by server config variable onetomany_max_many.
Optional. Defaults to the current time.
Departure time ($arriveBy=false) / arrival date ($arriveBy=true),
The maximum travel time in minutes. If not provided, the routing uses the value hardcoded in the server which is usually quite high.
Warning: Use with care. Setting this too low can lead to optimal (e.g. the least transfers) journeys not being found. If this value is too low to reach the destination at all, it can lead to slow routing performance.
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.
Optional. Defaults to false, i.e. one to many search
true = many to one false = one to many
The maximum number of allowed transfers (i.e. interchanges between transit legs, pre- and postTransit do not count as transfers). maxTransfers=0 searches for direct transit connections without any transfers. If you want to search only for non-transit connections (FOOT, CAR, etc.), send an empty transitModes parameter instead.
If not provided, the routing uses the server-side default value which is hardcoded and very high to cover all use cases.
Warning: Use with care. Setting this too low can lead to optimal (e.g. the fastest) journeys not being found. If this value is too low to reach the destination at all, it can lead to slow routing performance.
Optional. Default is 0 minutes.
Minimum transfer time for each transfer in minutes.
Optional. Default is 0 minutes.
Additional transfer time reserved for each transfer in minutes.
Optional. Default is 1.0
Factor to multiply minimum required transfer times with. Values smaller than 1.0 are not supported.
Optional. Default is false.
Whether to use transfers routed on OpenStreetMap data.
Different accessibility profiles for pedestrians.
Optional. Default is FOOT.
Accessibility profile to use for pedestrian routing in transfers between transit connections and the first and last mile respectively.
Average speed for pedestrian routing in meters per second
Optional
Average speed for pedestrian routing.
Average speed for bike routing in meters per second
Optional
Average speed for bike routing.
Vehicle height for HGV routing in meters
Vehicle width for HGV routing in meters
Vehicle length for HGV routing in meters
Vehicle gross weight for HGV routing in tons
Whether the vehicle carries hazardous materials for HGV routing
Whether the vehicle carries hazardous materials dangerous to water for HGV routing
Axle count for HGV routing
Maximum axle load for HGV routing in tons
Whether the vehicle has a trailer for HGV routing
Vehicle top speed for HGV routing in km/h
Whether the vehicle is allowed to use low-emission zones for HGV routing
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.
Optional. Default is NONE.
Set an elevation cost profile, to penalize routes with incline.
- NONE: No additional costs for elevations. This is the default behavior
- LOW: Add a low cost for increase in elevation and incline along the way. This will prefer routes with less ascent, if small detours are required.
- HIGH: Add a high cost for increase in elevation and incline along the way. This will prefer routes with less ascent, if larger detours are required.
As using an elevation costs profile will increase the travel duration, routing through steep terrain may exceed the maximal allowed duration, causing a location to appear unreachable. Increasing the maximum travel time for these segments may resolve this issue.
The profile is used for routing on both the first and last mile.
Elevation cost profiles are currently used by following street modes:
- BIKE
Optional. Default is TRANSIT which allows all transit modes (no restriction). Allowed modes for the transit part. If empty, no transit connections will be computed. For example, this can be used to allow only SUBURBAN,SUBWAY,TRAM.
Optional. Default is WALK. Does not apply to direct connections (see directMode).
A list of modes that are allowed to be used for the first mile, i.e. from the coordinates to the first transit stop. Example: WALK,BIKE_SHARING.
Optional. Default is WALK. Does not apply to direct connections (see directMode).
A list of modes that are allowed to be used for the last mile, i.e. from the last transit stop to the target coordinates. Example: WALK,BIKE_SHARING.
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
Default is WALK which will compute walking routes as direct connections.
Mode used for direction connections from start to destination without using transit.
Currently supported non-transit modes: `WALK`, `BIKE`, `CAR`
Optional. Default is 15min which is 900. Maximum time in seconds for the first street leg. Is limited by server config variable street_routing_max_prepost_transit_seconds.
Optional. Default is 15min which is 900. Maximum time in seconds for the last street leg. Is limited by server config variable street_routing_max_prepost_transit_seconds.
Optional. Default is 30min which is 1800. Maximum time in seconds for direct connections.
If a value smaller than either maxPreTransitTime or maxPostTransitTime is used, their maximum is set instead. Is limited by server config variable street_routing_max_direct_seconds.
Optional. Default is false. If true, the response includes the distance in meters for each path. This requires path reconstruction and is slower than duration-only queries.
withDistance is currently limited to street routing.
Optional. Default is false.
If set to true, all used transit trips are required to allow bike carriage.
Optional. Default is false.
If set to true, all used transit trips are required to allow car carriage.
Optional. Default is false.
If set to true, all used transit trips are required to be usable without compulsory reservation.
Response
A list of durations. If no path was found, the object is empty.