MDS Vehicles
A guide for how the MDS Provider Vehicles endpoint can be used to help cities manage fleets of devices.
MDS is a modular 'kit of parts' standard and cities can use the only parts they need.
A city can choose to use just Vehicles as its only MDS tool.
Vehicles is authenticated and secure between the provider and the agency.
How the MDS vehicles fields map to the GBFS free bike status fields.
Chart of items that are significantly divergent between GBFS and MDS’s real-time status endpoints.
| GBFS - free_bike_status v2.1rc | MDS - Provider vehicles v1.0.0 | |
|---|---|---|
| Identifier | Randomized ID | Unchanging ID |
| Status | 4 possible types | 12 types/reasons including user/company drop-offs, maintenance, rebalancing. |
| Visibility | Public: visible to all | Private: for internal city management and policy enforcement |
For a full chart of all fields with more details, and a link to presentation slides, see this supporting MDS / GBFS Real-time Status Comparison Document.
There are some fields that are included with Vehicles that are not in Free Bike Status:
- Static vehicle ID
- More vehicle information around non-public operations (company drop off, maintenance, rebalance.)
- Battery percent (instead of estimated range)
