From 2fdfef21f994b03a2c326ec472fdc16cd143320f Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Fri, 27 Mar 2026 13:28:17 -0400 Subject: [PATCH 1/8] Added world map Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index efa785eb0..ab2126c56 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,9 @@ The Mobility Data Specification (**MDS**), a project of the [Open Mobility Found ### History -**MDS** is an open-source project originally created by the [Los Angeles Department of Transportation](http://ladot.io) (LADOT). In November 2019, stewardship of MDS and the ownership of this repository were transferred to the [Open Mobility Foundation](http://www.openmobilityfoundation.org). GitHub automatically redirects any links to this repository from the `CityOfLosAngeles` organization to the `openmobilityfoundation` instead. MDS continues to be used by LADOT and [many other municipalities](#cities-using-mds) and companies (confirmed over 200 mobility operators, operating in over 1,000 cities globally, and 2 billion trips sent). +**MDS** is an open-source project originally created by the [Los Angeles Department of Transportation](http://ladot.io) (LADOT). In November 2019, stewardship of MDS and the ownership of this repository were transferred to the [Open Mobility Foundation](http://www.openmobilityfoundation.org). GitHub automatically redirects any links to this repository from the `CityOfLosAngeles` organization to the `openmobilityfoundation` instead. MDS continues to be used by LADOT and [many other municipalities](#cities-using-mds) and companies (confirmed over 200 mobility operators, operating in over 1,200 cities globally, and 2 billion trips sent) as a global standard. + +![MDS Global Map](https://i.imgur.com/Mx8qHwz.png) [Top][toc] From 76c4188bd18ad9c5cbce5f0fab838384653fc11c Mon Sep 17 00:00:00 2001 From: Marcus V Date: Wed, 8 Apr 2026 14:29:34 -0700 Subject: [PATCH 2/8] Update providers with Peak Transit.csv Signed-off-by: Marcus V --- providers.csv | 1 + 1 file changed, 1 insertion(+) diff --git a/providers.csv b/providers.csv index c76e9f7e0..c525d4437 100644 --- a/providers.csv +++ b/providers.csv @@ -84,3 +84,4 @@ Getaround,car-share,ede4d096-1641-4077-b986-37c602e881ae,https:getaround.com/,,h Transwest,passenger-services,8cf2ebbb-f2d4-46a7-98d2-e10e229cf718,https://www.transwestco.com/,, Drop Mobility,micromobility,f219d244-5f62-45f1-8e79-fb0274ac58fe,https://dropmobility.com/,https://mds.dropmobility.com,https://gbfs.dropmobility.com DoorDash,delivery-robots,6728346d-5ad1-4ddb-81d6-161c915a3d35,https://www.doordash.com/,, +Peak Transit,passenger-services,b0a0cc68-6248-4d5c-b514-bc44fbfb5d96,https://www.peaktransit.com/,, From 4a0d1ad3d1d4cd86818c88bfb9325657e3c37f24 Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Tue, 14 Apr 2026 11:47:14 -0400 Subject: [PATCH 3/8] Fixed order drop off/pick up descriptions Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- modes/event_types.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modes/event_types.md b/modes/event_types.md index 5046d9e6a..b71e73e6b 100644 --- a/modes/event_types.md +++ b/modes/event_types.md @@ -28,8 +28,8 @@ As with all MDS definitions, they should be described in a way that maximizes th | `not_located` | Location unknown | | `off_hours` | Off hours - end of service | | `on_hours` | On hours - start of service | -| `order_drop_off` | Pick up of the order at business | -| `order_pick_up` | Delivery of the order at the customer location | +| `order_drop_off` | Delivery of the order at the customer location | +| `order_pick_up` | Pick up of the order at business | | `passenger_cancellation` | Passenger cancelled a trip (if known, and more specific than `trip_cancel`) | | `provider_cancellation` | Provider cancelled a trip (if known, and more specific than `trip_cancel`) | | `provider_drop_off` | Drop off by the provider | From 8c329f0f99f707e1d97f69e396792c8215bbfdf3 Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Tue, 14 Apr 2026 11:48:34 -0400 Subject: [PATCH 4/8] Minor update to order pick up/drop off description Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- modes/delivery-robots.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modes/delivery-robots.md b/modes/delivery-robots.md index b3caf1333..52dbc337a 100644 --- a/modes/delivery-robots.md +++ b/modes/delivery-robots.md @@ -401,8 +401,8 @@ This is the list of `vehicle_state` and `event_type` pairings that constitute th |----------------------|--------------------|---------------------------|-----------------------------------------------------------------------------------------------| | `on_trip` | `elsewhere` | `trip_leave_jurisdiction` | The vehicle has left jurisdictional boundaries while on a trip | | `on_trip` | `non_contactable` | `comms_lost` | The vehicle has gone out of comms while on a trip to pick up the order | -| `on_trip` | `stopped` | `order_drop_off` | The vehicle is at the customer's place and is waiting for them | -| `on_trip` | `stopped` | `order_pick_up` | The vehicle has come to pick up the order at the restaurant | +| `on_trip` | `stopped` | `order_drop_off` | The vehicle is at the customer's place | +| `on_trip` | `stopped` | `order_pick_up` | The vehicle has come to pick up the order from the origin point | | `on_trip` | `stopped` | `trip_pause` | The vehicle has paused while on a trip | | From `vehicle_state` | To `vehicle_state` | `event_type` | Description | From 164a39cbc66364355263e4a82eaf8a9cd6d80e06 Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Tue, 14 Apr 2026 11:52:52 -0400 Subject: [PATCH 5/8] Version updates on home page Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index ab2126c56..48c1f8e27 100644 --- a/README.md +++ b/README.md @@ -121,7 +121,7 @@ Support for other shared modes, services, programs, and vehicles has been discus # Versions -MDS has a **current release** (version 2.0.0), **previous releases** (both recommended and longer recommended for use), and **upcoming releases** in development. For a full list of releases, their status, recommended versions, and timelines, see the [Official MDS Releases](https://github.com/openmobilityfoundation/governance/wiki/Releases) page. +MDS has a **current release** (version 2.1.0), **previous releases** (both recommended and longer recommended for use), and **upcoming releases** in development. For a full list of releases, their status, recommended versions, and timelines, see the [Official MDS Releases](https://github.com/openmobilityfoundation/governance/wiki/Releases) page. The OMF provides guidance on upgrading for cities, providers, and software companies, and sample permit language for cities. See our [MDS Version Guidance](https://github.com/openmobilityfoundation/governance/blob/main/technical/OMF-MDS-Version-Guidance.md) for best practices on how and when to upgrade MDS as new versions become available. Our complimentary [MDS Policy Language Guidance](https://github.com/openmobilityfoundation/governance/blob/main/technical/OMF-MDS-Policy-Language-Guidance.md) document is for cities writing MDS into their operating policy and includes sample policy language. @@ -174,7 +174,7 @@ Read about [how to become an OMF member](https://www.openmobilityfoundation.org/ # Cities Using MDS -More than 200 cities and public agencies across 21 countries around the world are known to use MDS, and it has been implemented by most major [mobility service providers](#providers-using-mds). +More than 1,200 cities and public agencies across 21 countries around the world are known to use MDS, and it has been implemented by over 200 major [mobility service providers](#providers-using-mds). - See our **[list of cities using MDS](https://www.openmobilityfoundation.org/mds-users/#cities-using-mds)** with links to public mobility websites and policy/permit documents. Please let us know [via our website](https://www.openmobilityfoundation.org/get-in-touch/) or in the [public discussion area](https://github.com/openmobilityfoundation/mobility-data-specification/discussions) if you are an agency using MDS so we can add you to the city resource list, especially if you have published your policies or documents publicly. @@ -185,7 +185,7 @@ To add yourself to the [agency list](/agencies.csv) and add your [Policy Require # Providers Using MDS -Over four dozen mobility service providers (MSPs) around the world use MDS, allowing them to create tools around a single data standard for multiple cities. +Over 200 mobility service providers (MSPs) around the world use MDS, allowing them to create tools around a single data standard for multiple cities globally. - See our **[list of providers using MDS](https://www.openmobilityfoundation.org/mds-users/#mobility-providers-using-mds)**. For a table list with unique IDs, see the MDS [provider list](/providers.csv) which includes both service operators and data solution providers. - A provider needs a unique ID for each [mode](#modes) they operate under. @@ -196,7 +196,7 @@ To add yourself to the provider list, please let us know [via our website](https # Software Companies Using MDS -An open source approach to data specifications benefits cities and companies by creating a space for collaborative development, reducing costs, and nurturing a healthy, competitive ecosystem for mobility services and software tools. The open model promotes a competitive ecosystem for software tools built by dozens of software companies providing their services to cities, agencies, and providers. +An open source approach to data specifications benefits cities and companies by creating a space for collaborative development, reducing costs, and nurturing a healthy, competitive ecosystem for mobility services and software tools. The open model promotes a competitive ecosystem for software tools built by dozens of software companies and vendors providing their services to cities, agencies, and providers. - See our **[list of third party software companies using MDS](https://www.openmobilityfoundation.org/mds-users/#software-companies-using-mds)** and an article about the [benefits of an open approach](https://www.openmobilityfoundation.org/why-open-behind-omfs-unique-open-source-model/). - For a table list with unique IDs, see the MDS [provider list](/providers.csv) which includes both service operators and data solution providers. @@ -234,7 +234,7 @@ How cities use MDS depends on a variety of factors: their transportation goals, - **Resident Complaints:** Investigate and validate complaints from residents about operations, parking, riding, speed, etc, usually reported through 311 - **Infrastructure Planning:** Determine where to place new bike/scooter lanes and drop zones based on usage and demand, start and end points, and trips taken -A list of use cases is useful to show what's possible with MDS, to list what other cities are accomplishing with the data, to see many use cases up front for privacy considerations, and to use for policy discussions and policy language. More details and examples can be seen on the [OMF website](https://www.openmobilityfoundation.org/whats-possible-with-mds/) and our [Wiki Database](https://github.com/openmobilityfoundation/governance/wiki/MDS-Use-Cases). An agency may align their program to specific use cases by publishing [Policy Requirement use cases](/policy#requirement-apis). +A list of more than 60 use cases is useful to show what's possible with MDS, to list what other cities are accomplishing with the data, to see many use cases up front for privacy considerations, and to use for policy discussions and policy language. More details and examples can be seen on the [OMF website](https://www.openmobilityfoundation.org/whats-possible-with-mds/) and our [Wiki Database](https://github.com/openmobilityfoundation/governance/wiki/MDS-Use-Cases). An agency may align their program to specific use cases by publishing [Policy Requirement use cases](/policy#requirement-apis). Please [let us know](https://docs.google.com/forms/d/e/1FAIpQLScrMPgeb1TKMYCjjKsJh3y1TPTJO8HR_y1NByrf1rDmTEJS7Q/viewform) if you have recommended updates or use cases to add. From 8b66af8c252eea144371cd166e53cf16c2249b39 Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Wed, 15 Apr 2026 11:47:37 -0400 Subject: [PATCH 6/8] New API diagram with Incidents Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 48c1f8e27..ac9439b7d 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,7 @@ Many parts of the MDS definitions and APIs align across each other. In these cas You can read more in our **[Understanding the different MDS APIs](https://github.com/openmobilityfoundation/governance/blob/main/technical/Understanding-MDS-APIs.md)** guide. -![MDS APIs and Endpoints](https://i.imgur.com/i27Mmfw.png) +![MDS APIs and Endpoints](https://i.imgur.com/4xVWwbj.png) ## GBFS Requirement From a363386b7ee9b1295fe029e0497aab33b9ec96f2 Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Thu, 16 Apr 2026 14:56:07 -0400 Subject: [PATCH 7/8] Added delivery examples Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ac9439b7d..dc14799b1 100644 --- a/README.md +++ b/README.md @@ -103,7 +103,7 @@ MDS supports multiple "modes", defined as a distinct regulatory framework for a - **[Micromobility](/modes/micromobility.md)** - customer operated dockless or docked small devices moving customers and goods, such as scooters, bikeshare, cargo bikes, adaptive scooters, docked bikes, mopeds, trikes, and quadracycles. - **[Passenger](/modes/passenger-services.md)** - employees and contractors, autonomous, and remotely operated transporting individuals or goods with a vehicle driven by another entity, including taxis, for-hire AVs, robotaxis, busses, transportation network companies (TNCs), commercial transport apps (CTAs), and private hire vehicles (PHVs), shuttles, paratransit, on demand vehicles, limosines, and microtransit. - **[Fleet](/modes/car-share.md)** - customer, employees and contractors, autonomous, and remotely operated shared point-to-point, station-based, or free-floating multi-passenger or cargo vehicles like consumer car share, sanitation vehicles (garbage, recycling), city fleets, vehicle rentals, street sweepers, snow plows, utility services, construction, emergency response (police, fire, ambulance), tree maintenance, inspection and permitting vehicles, mobile health clinics, and heavy maintenance vehicles. -- **[Delivery](/modes/delivery-robots.md)** - employees and contractors, autonomous, and remotely operated sidewalk robots, app delivery, packages, freight, goods, food, private hire vehicles, postal service, medicine, and other delivery services. +- **[Delivery](/modes/delivery-robots.md)** - employees and contractors, autonomous, and remotely operated sidewalk robots, app delivery, packages, freight, goods, food, private hire vehicles, electric cargo bikes and trikes, mopeds and motorcycles, box trucks, bike and scooter couriers, cargo vans, semi-trucks and tractor-trailers, postal service, medicine, and other delivery services.

MDS Mode - Micromobility       From 5f71c337ec201e8bb37ae47c87e28e9045f5e019 Mon Sep 17 00:00:00 2001 From: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> Date: Thu, 16 Apr 2026 14:56:36 -0400 Subject: [PATCH 8/8] Added more delivery types Signed-off-by: Michael Schnuerle <1285077+schnuerle@users.noreply.github.com> --- modes/delivery-robots.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modes/delivery-robots.md b/modes/delivery-robots.md index 52dbc337a..9477e41b0 100644 --- a/modes/delivery-robots.md +++ b/modes/delivery-robots.md @@ -2,7 +2,7 @@ MDS Modes - Delivery Robots -**Delivery** refers to employees and contractors, autonomous, and remotely operated sidewalk robots, app delivery, packages, freight, goods, food, private hire vehicles, postal service, medicine, and other delivery services. +**Delivery** refers to employees and contractors, autonomous, and remotely operated sidewalk robots, app delivery, packages, freight, goods, food, private hire vehicles, electric cargo bikes and trikes, mopeds and motorcycles, box trucks, bike and scooter couriers, cargo vans, semi-trucks and tractor-trailers, postal service, medicine, and other delivery services. There can be one or multiple orders on different trips at the same time, connected via the journey identifier. The state machine tracks the trip states of the orders separately from the vehicle state.