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.

Changed on
get/api/v6/map/trips

Request

  • Base URL
    https://api.transitous.org
  • URL
    https://api.transitous.org/api/v6/map/trips
  • Auth
    none declared

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 for the departure or arrival of this leg

polylinestring required

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

Changes

  • c370238a1905Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • dbfe4b7f2babRevision changes
    • warning

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

    • warning

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

    • warning

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