Skip to content

Commit 0de4663

Browse files
authored
Merge pull request #977 from openmobilityfoundation/release-2.1.0-prep
Feedback and Cleanup ahead of MDS 2.1 release
2 parents fd9542e + 5f71c33 commit 0de4663

File tree

4 files changed

+16
-13
lines changed

4 files changed

+16
-13
lines changed

README.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,9 @@ The Mobility Data Specification (**MDS**), a project of the [Open Mobility Found
3232

3333
### History
3434

35-
**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).
35+
**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.
36+
37+
![MDS Global Map](https://i.imgur.com/Mx8qHwz.png)
3638

3739
[Top][toc]
3840

@@ -84,7 +86,7 @@ Many parts of the MDS definitions and APIs align across each other. In these cas
8486

8587
You can read more in our **[Understanding the different MDS APIs](https://github.com/openmobilityfoundation/governance/blob/main/technical/Understanding-MDS-APIs.md)** guide.
8688

87-
![MDS APIs and Endpoints](https://i.imgur.com/i27Mmfw.png)
89+
![MDS APIs and Endpoints](https://i.imgur.com/4xVWwbj.png)
8890

8991
## GBFS Requirement
9092

@@ -101,7 +103,7 @@ MDS supports multiple "modes", defined as a distinct regulatory framework for a
101103
- **[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.
102104
- **[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.
103105
- **[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.
104-
- **[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.
106+
- **[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.
105107

106108
<p align="center">
107109
<a href="/modes/micromobility.md"><img src="https://i.imgur.com/bKGsiXz.png" alt="MDS Mode - Micromobility" style="float: left; border: 0; width: 170px;"></a> &nbsp; &nbsp; &nbsp;
@@ -119,7 +121,7 @@ Support for other shared modes, services, programs, and vehicles has been discus
119121

120122
# Versions
121123

122-
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.
124+
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.
123125

124126
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.
125127

@@ -172,7 +174,7 @@ Read about [how to become an OMF member](https://www.openmobilityfoundation.org/
172174

173175
# Cities Using MDS
174176

175-
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).
177+
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).
176178
- 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.
177179

178180
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.
@@ -183,7 +185,7 @@ To add yourself to the [agency list](/agencies.csv) and add your [Policy Require
183185

184186
# Providers Using MDS
185187

186-
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.
188+
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.
187189

188190
- 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.
189191
- A provider needs a unique ID for each [mode](#modes) they operate under.
@@ -194,7 +196,7 @@ To add yourself to the provider list, please let us know [via our website](https
194196

195197
# Software Companies Using MDS
196198

197-
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.
199+
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.
198200

199201
- 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/).
200202
- For a table list with unique IDs, see the MDS [provider list](/providers.csv) which includes both service operators and data solution providers.
@@ -232,7 +234,7 @@ How cities use MDS depends on a variety of factors: their transportation goals,
232234
- **Resident Complaints:** Investigate and validate complaints from residents about operations, parking, riding, speed, etc, usually reported through 311
233235
- **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
234236

235-
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).
237+
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).
236238

237239
Please [let us know](https://docs.google.com/forms/d/e/1FAIpQLScrMPgeb1TKMYCjjKsJh3y1TPTJO8HR_y1NByrf1rDmTEJS7Q/viewform) if you have recommended updates or use cases to add.
238240

modes/delivery-robots.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
<img src="https://i.imgur.com/bw2O9t8.png" width="200" align="right" alt="MDS Modes - Delivery Robots" border="0">
44

5-
**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.
5+
**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.
66

77
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.
88

@@ -401,8 +401,8 @@ This is the list of `vehicle_state` and `event_type` pairings that constitute th
401401
|----------------------|--------------------|---------------------------|-----------------------------------------------------------------------------------------------|
402402
| `on_trip` | `elsewhere` | `trip_leave_jurisdiction` | The vehicle has left jurisdictional boundaries while on a trip |
403403
| `on_trip` | `non_contactable` | `comms_lost` | The vehicle has gone out of comms while on a trip to pick up the order |
404-
| `on_trip` | `stopped` | `order_drop_off` | The vehicle is at the customer's place and is waiting for them |
405-
| `on_trip` | `stopped` | `order_pick_up` | The vehicle has come to pick up the order at the restaurant |
404+
| `on_trip` | `stopped` | `order_drop_off` | The vehicle is at the customer's place |
405+
| `on_trip` | `stopped` | `order_pick_up` | The vehicle has come to pick up the order from the origin point |
406406
| `on_trip` | `stopped` | `trip_pause` | The vehicle has paused while on a trip |
407407

408408
| From `vehicle_state` | To `vehicle_state` | `event_type` | Description |

modes/event_types.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@ As with all MDS definitions, they should be described in a way that maximizes th
2828
| `not_located` | Location unknown |
2929
| `off_hours` | Off hours - end of service |
3030
| `on_hours` | On hours - start of service |
31-
| `order_drop_off` | Pick up of the order at business |
32-
| `order_pick_up` | Delivery of the order at the customer location |
31+
| `order_drop_off` | Delivery of the order at the customer location |
32+
| `order_pick_up` | Pick up of the order at business |
3333
| `passenger_cancellation` | Passenger cancelled a trip (if known, and more specific than `trip_cancel`) |
3434
| `provider_cancellation` | Provider cancelled a trip (if known, and more specific than `trip_cancel`) |
3535
| `provider_drop_off` | Drop off by the provider |

providers.csv

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,3 +84,4 @@ Getaround,car-share,ede4d096-1641-4077-b986-37c602e881ae,https:getaround.com/,,h
8484
Transwest,passenger-services,8cf2ebbb-f2d4-46a7-98d2-e10e229cf718,https://www.transwestco.com/,,
8585
Drop Mobility,micromobility,f219d244-5f62-45f1-8e79-fb0274ac58fe,https://dropmobility.com/,https://mds.dropmobility.com,https://gbfs.dropmobility.com
8686
DoorDash,delivery-robots,6728346d-5ad1-4ddb-81d6-161c915a3d35,https://www.doordash.com/,,
87+
Peak Transit,passenger-services,b0a0cc68-6248-4d5c-b514-bc44fbfb5d96,https://www.peaktransit.com/,,

0 commit comments

Comments
 (0)