Sign in
map

Given a area frame (box defined by top right and bottom left corner) and a time frame, it returns all trips and their respective shapes that operate in this area + time frame. Trips are filtered by zoom level. On low zoom levels, only long distance trains will be shown while on high zoom levels, also metros, buses and trams will be returned.

get/api/v6/map/trips

Query parameters

zoomnumber required

current zoom level

minstring required

latitude,longitude pair of the lower right coordinate

maxstring required

latitude,longitude pair of the upper left coordinate

startTimestring date-time required

start of the time window

endTimestring date-time required

end if the time window

precisionnumber

precision of returned polylines. Recommended to set based on zoom: zoom >= 11 ? 5 : zoom >= 8 ? 4 : zoom >= 5 ? 3 : 2

languagestring[]

language tags as used in OpenStreetMap / GTFS (usually BCP-47 / ISO 639-1, or ISO 639-2 if there's no ISO 639-1)

Response

a list of trips

routeColorstring
mode'WALK' | 'BIKE' | 'RENTAL' | 'CAR' | 'HGV' | 'CAR_PARKING' | 'CAR_DROPOFF' | 'ODM' | 'RIDE_SHARING' | 'FLEX' | 'DEBUG_BUS_ROUTE' | 'DEBUG_RAILWAY_ROUTE' | 'DEBUG_FERRY_ROUTE' | 'TRANSIT' | 'TRAM' | 'SUBWAY' | 'FERRY' | 'AIRPLANE' | 'BUS' | 'COACH' | 'RAIL' | 'HIGHSPEED_RAIL' | 'LONG_DISTANCE' | 'NIGHT_RAIL' | 'REGIONAL_FAST_RAIL' | 'REGIONAL_RAIL' | 'SUBURBAN' | 'FUNICULAR' | 'AERIAL_LIFT' | 'OTHER' | 'AREAL_LIFT' | 'METRO' | 'CABLE_CAR' required

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
distancenumber required

distance in meters

departurestring date-time required

departure time

arrivalstring date-time required

arrival time

scheduledDeparturestring date-time required

scheduled departure time

scheduledArrivalstring date-time required

scheduled arrival time

realTimeboolean required

Whether there is real-time data about this leg

polylinestring required

Google polyline encoded coordinate sequence (with precision 5) where the trip travels on this segment.

Changes

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

  • dbfe4b7f2bab3See the full diff
    • ●

      added the new HGV enum value to the items/from/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the items/mode response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the items/to/modes/items/ response property for the response status 200

      response-property-enum-value-added

  • a2ab90068a352See the full diff
    • ○

      added the optional property items/from/stopCode to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property items/to/stopCode to the response with the 200 status

      response-optional-property-added

  • f808465a02ed2See the full diff
    • ●

      added the new SPECIAL_EVENT enum value to the items/from/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new SPECIAL_EVENT enum value to the items/to/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

  • a3620bf004a31See the full diff
    • ○

      endpoint added

      endpoint-added

  • b7bf68a0d6f31See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 30 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog