Skip to content

Commit 85930ae

Browse files
committed
incorporate pierre-bouffort feedback
1 parent 8175ba0 commit 85930ae

2 files changed

Lines changed: 8 additions & 2 deletions

File tree

general-information.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,7 @@ A standard point of vehicle telemetry. References to latitude and longitude impl
279279
| -------------- | -------------- | --------------------- | ------------------------------------------------------------ |
280280
| `device_id` | UUID | Required | ID used in [Register](#vehicle---register) |
281281
| `timestamp` | [timestamp][ts]| Required | Date/time that event occurred. Based on GPS or GNSS clock |
282+
| `trip_id` | UUID | Required | If telemetry occurred during a trip, the ID of the trip. If not in a trip, `null`.
282283
| `gps` | Object | Required | Telemetry position data |
283284
| `gps.lat` | Double | Required | Latitude of the location |
284285
| `gps.lng` | Double | Required | Longitude of the location |

provider/README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,10 @@ This specification contains a data standard for *mobility as a service* provider
2121
* [Trips - Query Parameters](#trips---query-parameters)
2222
* [Routes](#routes)
2323
* [Events][events]
24-
* [Events - Query Parameters](#events---query-parameters)
24+
* [Recent Events](#recent-events)
25+
* [Recent Events - Query Parameters](#recent-events---query-parameters)
26+
* [Historical Events](#historical-events)
27+
* [Historical Events - Query Parameters](#events---query-parameters)
2528
* [Telemetry][telemetry]
2629
* [Telemetry - Query Parameters](#telemetry---query-parameters)
2730
* [Vehicles][vehicles]
@@ -244,7 +247,9 @@ Trips that start or end at a [Stop][stops] must include a `stop_id` property in
244247

245248
## Events
246249

247-
The `/events/recent` and `/events/historical/` endpoints return a list of Event objects, describing the activity of the Provider's vehicles. Recent events are at most two weeks old and can be queried with start/stop time, and historical events are packaged in hour-sized chunks for ease of implementation.
250+
The `/events/recent` and `/events/historical/` endpoints return a list of Event objects, describing the activity of the Provider's vehicles. Recent events are at most two weeks old and can be queried with start/stop time, and historical events are packaged in hour-sized chunks for ease of implementation.
251+
252+
(?) This distinction is a holdover from MDS 1.x. Dramatic simplification of the query is meant to make cold storage by hourly chunks trivial without a database. We should ask Providers if that has been a concern in practice.
248253

249254
Unless stated otherwise by the municipality, this endpoint must return only those status changes with a `event_location` that [intersects](#intersection-operation) with the [municipality boundary](#municipality-boundary).
250255

0 commit comments

Comments
 (0)