?
Where Am I now ?

The "breadcrumbs" element is always present, on top of the page.

It shows you where you are on the lab.

It enables you to reach any page on the lab.

OTP1 → OTP2 TL;DR

The happy path from planner-v1 to the two OTP 2 recipes, call next to call. Every parameter is in the breaking changes tables.

planner-v2-1

OTP 2 as it is: one call is one OTP 2 query. Pick it when you need a precise or asymmetric trip shape.

Walk and transit, the everyday call. Places and time go through unchanged (fromPlace, toPlace, date, time, datetime, arriveBy, locale). Drop mode altogether: no mode parameter means walk everywhere plus every transit mode. Two renames: numItineraries → numTripPatterns, wheelchair → wheelchairAccessible.

planner-v1/api/routing/trip-planner/recipe/bmc-planner-v1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&mode=WALK,TRANSIT&numItineraries=5&wheelchair=true
v2-1/api/routing/trip-planner/recipe/bmc-planner-v2-1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&numTripPatterns=5&wheelchairAccessible=true

Any other mode: split the bag. The street modes of mode go to the three slots (accessMode to the first stop, egressMode from the last one, directMode door to door, one value each), the transit modes go to transportModes, lowercase. accessMode and egressMode always go together; leave directMode out for transit only.

planner-v1/api/routing/trip-planner/recipe/bmc-planner-v1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&mode=BICYCLE,RAIL
v2-1/api/routing/trip-planner/recipe/bmc-planner-v2-1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&accessMode=bicycle&egressMode=bicycle&directMode=bicycle&transportModes=rail

Transfer tuning: rename, and mind the defaults. maxTransfers → maximumTransfers (default 2 → 12), minTransferTime → transferSlack (default 0 → 120 s), boardSlack / alightSlack → boardSlackDefault / alightSlackDefault. bannedAgencies, walkSpeed and the reluctances keep their name. A next page is no longer a new call with a later time: pass the pageCursor of the response.

planner-v1/api/routing/trip-planner/recipe/bmc-planner-v1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&mode=WALK,BUS,TRAM&maxTransfers=2&minTransferTime=180&bannedAgencies=tec
v2-1/api/routing/trip-planner/recipe/bmc-planner-v2-1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&accessMode=foot&egressMode=foot&directMode=foot&transportModes=bus,tram&maximumTransfers=2&transferSlack=180&bannedAgencies=tec

planner-v2-1-preset

The shortest migration: a named intent instead of mode slots. The mode selection UX page shows which preset fits which screen.

One parameter instead of three. Same recipe, same parameters, but modePreset replaces the three slots. public-transit is the default, so the everyday call needs no mode parameter at all; transportModes still narrows the transit modes.

planner-v1/api/routing/trip-planner/recipe/bmc-planner-v1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&mode=WALK,TRAM,SUBWAY
v2-1-preset/api/routing/trip-planner/recipe/bmc-planner-v2-1-preset?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&modePreset=public-transit&transportModes=tram,metro

Several shapes, still one call. Own bike, bike Park&Ride and rental bike are three OTP 2 queries. bike-multimodal runs them in one request: results merged, one pageCursor for the lot. Same idea for car-multimodal.

planner-v1/api/routing/trip-planner/recipe/bmc-planner-v1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&mode=BICYCLE,BICYCLE_RENT,BICYCLE_PARK,TRANSIT
v2-1-preset/api/routing/trip-planner/recipe/bmc-planner-v2-1-preset?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&modePreset=bike-multimodal

The car. car-only is the door to door drive of mode=CAR. Prefer car to also get the transit alternatives (two queries: OTP 2 would otherwise drop the transit itineraries slower than the drive), or best to let OTP 2 pick.

planner-v1/api/routing/trip-planner/recipe/bmc-planner-v1?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&mode=CAR
v2-1-preset/api/routing/trip-planner/recipe/bmc-planner-v2-1-preset?fromPlace=50.8467,4.3525&toPlace=50.8798,4.4006&modePreset=car-only
Command Palette
?
LabData/en/data
ApidateAPI params in:BMC v1BMC v2OTP 1ApidateTimeAPI params in:BMC v1BMC v2OTP 1OTP 2OTP 2.10
LabDataGtfs/en/data/gtfs
LabDataGtfs RT/en/data/gtfs-rt
LabDataGbfs/en/data/gbfs
LabDataRedis/en/data/redis
LabPlanMigrating to OTP2OTP1 → OTP2 TL;DR/en/planner/migrating-to-otp2/tldr
LabMigrating to OTP2OTP1 → OTP2 TL;DRplanner-v2-1/en/planner/migrating-to-otp2/tldr
LabMigrating to OTP2OTP1 → OTP2 TL;DRplanner-v2-1-preset/en/planner/migrating-to-otp2/tldr
LabDataGtfsAgencies/en/data/gtfs/feed/agencies/
LabDataGtfsRoutes/en/data/gtfs/feed/routes/
LabDataGtfsTrips/en/data/gtfs/feed/trips/
LabDataGtfsStops/en/data/gtfs/feed/stops/
LabDataGtfsTrip Patterns/en/data/gtfs/trip-patterns
LabDataGtfsGtfs Archives/en/data/gtfs/archives
LabDataGtfs RTAlerts/en/data/gtfs-rt/feed/alerts
LabDataGtfs RTTrip Updates/en/data/gtfs-rt/feed/trip-updates
LabDataGbfsAgencies/en/data/gbfs/agencies
LabDataGbfsStations/en/data/gbfs/stations
LabDataGbfsStation Statuses/en/data/gbfs/station-statuses
LabDataGbfsFree Floating Bikes/en/data/gbfs/free-floating-bikes
LabDataGbfsMap/en/data/gbfs/map
LabDataRedisredisCacher/gtfsRtAlertsDeLijn/en/data/redis/redisCacher/gtfsRtAlertsDeLijn
LabDataRedisredisCacher/gtfsRtAlertsEurostar/en/data/redis/redisCacher/gtfsRtAlertsEurostar
LabDataRedisredisCacher/gtfsRtAlertsNmbsSncb/en/data/redis/redisCacher/gtfsRtAlertsNmbsSncb
LabDataRedisredisCacher/gtfsRtAlertsStibMivb/en/data/redis/redisCacher/gtfsRtAlertsStibMivb
LabDataRedisredisCacher/gtfsRtAlertsTec/en/data/redis/redisCacher/gtfsRtAlertsTec
LabDataRedisredisCacher/gtfsRtAlertsTecRaw/en/data/redis/redisCacher/gtfsRtAlertsTecRaw
LabDataRedisredisCacher/gtfsRtTripUpdatesDeLijn/en/data/redis/redisCacher/gtfsRtTripUpdatesDeLijn
LabDataRedisredisCacher/gtfsRtTripUpdatesEurostar/en/data/redis/redisCacher/gtfsRtTripUpdatesEurostar
LabDataRedisredisCacher/gtfsRtTripUpdatesNmbsSncb/en/data/redis/redisCacher/gtfsRtTripUpdatesNmbsSncb
LabDataRedisredisCacher/gtfsRtTripUpdatesStibMivb/en/data/redis/redisCacher/gtfsRtTripUpdatesStibMivb
LabDataRedisredisCacher/gtfsRtTripUpdatesTec/en/data/redis/redisCacher/gtfsRtTripUpdatesTec
LabDataRedisredisCacher/gtfsRtTripUpdatesDeLijnRaw/en/data/redis/redisCacher/gtfsRtTripUpdatesDeLijnRaw
LabDataRedisredisCacher/gtfsRtTripUpdatesEurostarRaw/en/data/redis/redisCacher/gtfsRtTripUpdatesEurostarRaw
LabDataRedisredisCacher/gtfsRtTripUpdatesNmbsSncbRaw/en/data/redis/redisCacher/gtfsRtTripUpdatesNmbsSncbRaw
LabDataRedisredisCacher/gtfsRtTripUpdatesTecRaw/en/data/redis/redisCacher/gtfsRtTripUpdatesTecRaw
LabDataRedisredisCacher/pointsByLinesStibMivb/en/data/redis/redisCacher/pointsByLinesStibMivb
LabDataRedisredisCacher/waitingTimesStibMivb/en/data/redis/redisCacher/waitingTimesStibMivb
LabSearch/en/search
LabPlan/en/planner-home
LabPlanPlanner v1/en/planner-tec-app
LabPlanPlanner v2/en/planner-v2-bmc
LabPlanOTP 1/en/planner
LabPlanOTP 2/en/planner-v2
LabPlanOTP 2.10/en/planner-otp-2-10
LabPlanPlanner v2.1/en/planner-v2-1
LabPlanPlanner v2.1 preset/en/planner-v2-1-preset
LabPlanMigrating to OTP2/en/planner/migrating-to-otp2
LabPlanMigrating to OTP2Get started/en/planner/migrating-to-otp2
LabMigrating to OTP2Get startedHow the engine thinks/en/planner/migrating-to-otp2
LabMigrating to OTP2Get startedTwo recipes/en/planner/migrating-to-otp2
LabMigrating to OTP2Get startedOn these pages/en/planner/migrating-to-otp2
LabPlanMigrating to OTP2OTP1 → OTP2 Breaking changes/en/planner/migrating-to-otp2/breaking-changes
LabMigrating to OTP2OTP1 → OTP2 Breaking changesChanged parameters/en/planner/migrating-to-otp2/breaking-changes
LabMigrating to OTP2OTP1 → OTP2 Breaking changesOTP2 only/en/planner/migrating-to-otp2/breaking-changes
LabMigrating to OTP2OTP1 → OTP2 Breaking changesSame name/en/planner/migrating-to-otp2/breaking-changes
LabPlanMigrating to OTP2Mode selection UX/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UXSettings/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UXUser preferences/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UXRestrict modes/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UX1 Monomodal presets/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UX2 Multimodal presets/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UX3 Simple select, progressive reveal/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UX4 Rent and park toggles/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UX5 Rent or park switches/en/planner/migrating-to-otp2/mode-ux
LabMigrating to OTP2Mode selection UXPros & cons/en/planner/migrating-to-otp2/mode-ux
LabPlanMigrating to OTP2Query matrix/en/planner/migrating-to-otp2/query-matrix
LabPlanMigrating to OTP2Coverage review/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewStreet modes/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewTransit-vs-street filter/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewUnset slots/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewTransit modes/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewWho: operators, lines/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewWhere: places/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewWhen: time/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewTraveller profile/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewIntents check/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewPreset recipe/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewOne cursor, many queries/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewBudget per shape/en/planner/migrating-to-otp2/coverage-review
LabMigrating to OTP2Coverage reviewRecommendations/en/planner/migrating-to-otp2/coverage-review
LabMap/en/map
LabMapMap Base/en/map/base-light
LabMapMap Transit/en/map/transit-light
LabMapMap Transit (via proxy)/en/map/transit-light-proxy
LabDeparture/en/departure
LabDoc/en/doc
LabDocPlanner Cases Library/en/doc/planner-lib
LabDocUi/Ux/en/doc/user-interface
LabDocUi/UxPlanner/en/doc/user-interface/planner/
LabUi/UxPlannerInstant | Duration | Distance/en/doc/user-interface/planner/
LabUi/UxPlannerItinerary Time Overview/en/doc/user-interface/planner/
LabUi/UxPlannerLeg Overview/en/doc/user-interface/planner/
LabUi/UxPlannerItinerary Overview/en/doc/user-interface/planner/
LabUi/UxPlannerLeg Detail/en/doc/user-interface/planner/
LabDocUi/UxDeparture/en/doc/user-interface/departure
LabDocUi/UxInput/en/doc/user-interface/input/
LabHelp/en/help
ApifromPlaceAPI params in:BMC v1BMC v2OTP 1OTP 2OTP 2.10ApitoPlaceAPI params in:BMC v1BMC v2OTP 1OTP 2OTP 2.10ApiarriveByAPI params in:BMC v1BMC v2OTP 1OTP 2OTP 2.10ApitimeAPI params in:BMC v1BMC v2OTP 1ApibannedAgenciesAPI params in:BMC v1OTP 1OTP 2OTP 2.10ApibannedRoutesAPI params in:BMC v1OTP 1ApiwalkSpeedAPI params in:BMC v1OTP 1OTP 2OTP 2.10ApiwheelchairAPI params in:BMC v1BMC v2OTP 1ApinumItinerariesAPI params in:BMC v1BMC v2OTP 1ApimodeAPI params in:BMC v1BMC v2OTP 1ApialightSlackAPI params in:BMC v1BMC v2OTP 1ApiboardSlackAPI params in:BMC v1BMC v2OTP 1ApilocaleAPI params in:BMC v1OTP 1ApishowIntermediateStopsAPI params in:BMC v1OTP 1ApimaxWalkDistanceAPI params in:BMC v1OTP 1ApistartTransitStopIdAPI params in:BMC v1OTP 1ApistartTransitTripIdAPI params in:BMC v1OTP 1ApiwaitReluctanceAPI params in:BMC v1OTP 1OTP 2OTP 2.10ApiwalkReluctanceAPI params in:BMC v1OTP 1OTP 2OTP 2.10ApiroutingProfileAPI params in:BMC v2ApipageCursorsAPI params in:BMC v2ApibannedStopsAPI params in:OTP 1ApibannedStopsHardAPI params in:OTP 1ApibannedTripsAPI params in:OTP 1ApibatchAPI params in:OTP 1ApibikeBoardCostAPI params in:OTP 1ApibikeSpeedAPI params in:OTP 1OTP 2OTP 2.10ApibikeSwitchCostAPI params in:OTP 1ApidisableAlertFilteringAPI params in:OTP 1ApidisableRemainingWeightHeuristicAPI params in:OTP 1ApigeoidElevationAPI params in:OTP 1ApiignoreRealtimeUpdatesAPI params in:OTP 1OTP 2OTP 2.10ApiintermediatePlacesAPI params in:OTP 1ApimaxHoursAPI params in:OTP 1ApimaxPreTransitTimeAPI params in:OTP 1ApimaxTransfersAPI params in:OTP 1ApiminTransferTimeAPI params in:OTP 1ApinonpreferredTransferPenaltyAPI params in:OTP 1ApioptimizeAPI params in:OTP 1ApiotherThanPreferredRoutesPenaltyAPI params in:OTP 1ApipreferredAgenciesAPI params in:OTP 1ApipreferredRoutesAPI params in:OTP 1ApireverseOptimizeOnTheFlyAPI params in:OTP 1ApitransferPenaltyAPI params in:OTP 1OTP 2OTP 2.10ApitriangleSafetyFactorAPI params in:OTP 1ApitriangleSlopeFactorAPI params in:OTP 1ApitriangleTimeFactorAPI params in:OTP 1ApiunpreferredAgenciesAPI params in:OTP 1ApiunpreferredRoutesAPI params in:OTP 1ApiuseRequestedDateTimeInMaxHoursAPI params in:OTP 1ApiwaitAtBeginningFactorAPI params in:OTP 1ApiwalkBoardCostAPI params in:OTP 1ApitimetableViewAPI params in:OTP 2OTP 2.10ApinumTripPatternsAPI params in:OTP 2OTP 2.10ApimaximumTransfersAPI params in:OTP 2OTP 2.10ApimaximumAdditionalTransfersAPI params in:OTP 2OTP 2.10ApisearchWindowAPI params in:OTP 2OTP 2.10ApiincludePlannedCancellationsAPI params in:OTP 2OTP 2.10ApiincludeRealtimeCancellationsAPI params in:OTP 2OTP 2.10ApitransferSlackAPI params in:OTP 2OTP 2.10ApiboardSlackDefaultAPI params in:OTP 2OTP 2.10ApiboardSlackListAPI params in:OTP 2OTP 2.10ApialightSlackDefaultAPI params in:OTP 2OTP 2.10ApialightSlackListAPI params in:OTP 2OTP 2.10ApibicycleOptimisationMethodAPI params in:OTP 2OTP 2.10ApitransportModesAPI params in:OTP 2OTP 2.10ApiegressModeAPI params in:OTP 2OTP 2.10ApidirectModeAPI params in:OTP 2OTP 2.10ApiaccessModeAPI params in:OTP 2OTP 2.10ApiitineraryFiltersDebugAPI params in:OTP 2OTP 2.10ApipageCursorAPI params in:OTP 2OTP 2.10ApiwheelchairAccessibleAPI params in:OTP 2OTP 2.10ApitriangleFactorsSafetyAPI params in:OTP 2OTP 2.10ApitriangleFactorsSlopeAPI params in:OTP 2OTP 2.10ApitriangleFactorsTimeAPI params in:OTP 2OTP 2.10ApiuseBikeRentalAvailabilityInformationAPI params in:OTP 2OTP 2.10ApimaxDirectDurationForModeAPI params in:OTP 2OTP 2.10ApifiltersAPI params in:OTP 2OTP 2.10ApirelaxTransitGroupPriorityAPI params in:OTP 2OTP 2.10ApifromServiceJourneyIdAPI params in:ApifromServiceDateAPI params in:ApifromStopLocationIdAPI params in:ApifromAimedDepartureTimeAPI params in:ApiwhiteListedAgenciesAPI params in:ApibannedLinesAPI params in:ApiwhiteListedLinesAPI params in:ApibannedServiceJourneysAPI params in:ApibannedRentalNetworksAPI params in:ApiwhiteListedRentalNetworksAPI params in:ApipassThroughPointsAPI params in:ApirelaxTransitGroupPriorityRatioAPI params in:ApirelaxTransitGroupPriorityConstantAPI params in:ApimaxAccessEgressDurationForModeAPI params in:ApimodePresetAPI params in:
DocOTP 1Full Open API Documentation
DocOTP 2Full Open API Documentation
DocOTP 2.10Full Open API Documentation
DocPlanner v1Full Open API Documentation
DocPlanner v2Full Open API Documentation
DocPlanner v2.1Full Open API Documentation
DocPlanner v2.1 presetFull Open API Documentation