Skip to content

TOMP‐API v2.0 Functionalities

Edwin van den Belt edited this page Oct 6, 2025 · 6 revisions

Two-wheeled shared vehicles

Setup

  • serves both station-based and free-floating setups. Even dynamic setups.

Offering & booking

  • direct booking of assets on the street AND search for assets
  • use GBFS's published vehicles
  • book assets in the (near) future
  • use deposits
  • Purchase products, like monthly cards, subscriptions or multi-ride vouchers
  • Usable with external route planners

Execute the trip

  • can be used to open locks of any kind.
  • can be used to open lockers and chargers
  • copes with helmets and helmet boxes
  • start, stop, pause and resume trips
  • deliver proof (photos) of correct parking

Support the traveler

  • facilitates any support scenario, even the replacement of the asset
  • allows for adjusting the rental until the start of the trip
  • reuse existing published data, like MDS policies: (no-)parking zones, speed limits, etc.

Payment & after sales

  • offers functionalities for different payment methods
  • charge different prices based on pause status
  • request payment directly after the trip has finished

Shared cars

Setup

  • serves both station-based, free-floating and round-trip setups.

Offering & booking

  • Search for offers, but also book a car on the street
  • In case of offerings, adjust the offer (additional services, child seats, insurance, ..) and specify traveler's details (e.g. driver's license)
  • Purchase the offer or adjusted package
  • Purchase products, like monthly cards, subscriptions or multi-ride vouchers
  • Usable with external route planners

Execute the trip

  • can be used to open garage doors
  • start, stop, pause and resume trips
  • deliver proof (photos) of correct parking
  • custom functionality to operate the car, charging equipment or garage doors
  • publish on-street and off-street parking locations

Support the traveler

  • reporting incidents, flat tires, etc
  • request to extend the usage time
  • request location of parked vehicle
  • formalized process to replace the (broken) vehicle
  • warn the traveler based on MDS policy-zones
  • inform the traveler (time left, operational instructions)

Payment & after sales

  • Report the balance
  • Request immediate payment after the trip
  • Redress options, like refunding
  • Handling fines

DRT & Taxis

Setup

  • usable with route planners
  • can be used with e.g. GTFS-OnDemand
  • supports from full AVs to traditional taxis
  • call-a-cab; instant booking
  • specify connecting services, allowing to publish guarantees

Offering & booking

  • pickup / drop off locations
  • specify luggage sizes and weights
  • specify personal details, reduced mobility
  • confirm after scheduling (and dispatching)

Execute the trip

  • report ETA till pick up point (incl. location)
  • the driver/chauffeur controls the execution (not the traveler), and starts/stops the (leg of the) trip
  • custom functions for AV

Support the traveler & driver

  • Reporting no-show (of taxi & traveler)
  • Unable to locate

Payment & after sales

  • Fixed prices, corrections at the end
  • Pay when finished
  • Redress options, like refunds and compensations

Line based Public Transport

Setup

  • Offers With or without seat reservation
  • Check-in/Check-out, Gate controlled, Be-in/Be-out, Check-in/Be-out

Offering & booking

  • Search for offers, modify the offered packages (additional services, personal details)
  • Or directly purchase the offer

Execute the trip

Support the traveler

Payment & after sales

Zonal based Public Transport

Setup

Offering & booking

Execute the trip

Support the traveler

Payment & after sales

Parking & charging

Setup

Offering & booking

Execute the trip

Support the traveler

Payment & after sales

Clone this wiki locally