Skip to content
This repository has been archived by the owner on Nov 10, 2022. It is now read-only.

Commit

Permalink
Add publication_time fields to trips and status changes
Browse files Browse the repository at this point in the history
These fields will be optional in 0.3.2 and mandatory in a future
version. They reflect the time that the provider made the relevant data
available through the API.

This commit partially fixes openmobilityfoundation#307, but it's not a complete fix since it
doesn't include the ability to query by publication time.
  • Loading branch information
rf- committed Jun 11, 2019
1 parent 7652956 commit c706d34
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions provider/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,6 +191,7 @@ Schema: [`trips` schema][trips-schema]
| `accuracy` | Integer | Required | The approximate level of accuracy, in meters, of `Points` within `route` |
| `start_time` | [timestamp][ts] | Required | |
| `end_time` | [timestamp][ts] | Required | |
| `publication_time` | [timestamp][ts] | Optional | Date/time that trip became available through the trips endpoint |
| `parking_verification_url` | String | Optional | A URL to a photo (or other evidence) of proper vehicle parking |
| `standard_cost` | Integer | Optional | The cost, in cents, that it would cost to perform that trip in the standard operation of the System |
| `actual_cost` | Integer | Optional | The actual cost, in cents, paid by the customer of the *mobility as a service* provider |
Expand Down Expand Up @@ -290,6 +291,7 @@ Schema: [`status_changes` schema][sc-schema]
| `event_type` | Enum | Required | See [event types](#event-types) table |
| `event_type_reason` | Enum | Required | Reason for status change, allowable values determined by [`event type`](#event-types) |
| `event_time` | [timestamp][ts] | Required | Date/time that event occurred at. See [Event Times](#event-times) |
| `publication_time` | [timestamp][ts] | Optional | Date/time that event became available through the status changes endpoint |
| `event_location` | GeoJSON [Point Feature][geo] | Required | |
| `battery_pct` | Float | Required if Applicable | Percent battery charge of device, expressed between 0 and 1 |
| `associated_trip` | UUID | Required if Applicable | Trip UUID (foreign key to Trips API), required if `event_type_reason` is `user_pick_up` or `user_drop_off`, or for any other status change event that marks the end of a trip. |
Expand Down

0 comments on commit c706d34

Please sign in to comment.