You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: general-information.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -233,13 +233,15 @@ A Trip is defined by the following structure:
233
233
|`trip_attributes`| Array | Optional |**[Mode](/modes#list-of-supported-modes) Specific**. [Trip attributes](/modes#trip-attributes) given as unordered key-value pairs |
234
234
|`start_time`|[Timestamp][ts]| Required | Start of the passenger/driver trip |
235
235
|`end_time`|[Timestamp][ts]| Required | End of the passenger/driver trip |
236
-
|`start_location`|`{ lat: number, lng: number }`| Required | Location of the start of the trip. See also [Stop-based Geographic Data][stop-based-geo]. |
237
-
|`end_location`|`{ lat: number, lng: number }`| Required | Location of the end of the trip. See also [Stop-based Geographic Data][stop-based-geo]. |
236
+
|`start_location`|[Point](point)| Required | Location of the start of the trip. See also [Stop-based Geographic Data][stop-based-geo]. |
237
+
|`end_location`|[Point](point)| Required | Location of the end of the trip. See also [Stop-based Geographic Data][stop-based-geo]. |
238
238
|`publication_time`|[Timestamp][ts]| Optional | Date/time that trip became available through the trips endpoint |
239
239
|`fare`|[Fare](#fare)| Conditionally Required | Fare for the trip (required if trip was completed) |
240
240
241
241
(?) Document that the route is obtained by hitting the /telemetry endpoint with a `trip_id`?
242
242
243
+
(?) Should we replace `Point` with `Telemetry`?
244
+
243
245
(?) Should we keep mix of `trip_` prefix vs. no prefix? E.g. `start_time`.
244
246
245
247
(?) Does anyone use `publication_time`?
@@ -252,7 +254,7 @@ Examples of mode-specific `trip_attributes`:
252
254
| ----- | -------- | ----------------- | ----- |
253
255
|`dispatch_time`|[Timestamp][ts]| Conditionally Required | Time the vehicle was dispatched to the customer (required if trip was dispatched) |
254
256
|`quoted_trip_start_time`|[Timestamp][ts]| Required | Time the trip was estimated or scheduled to start, that was provided to the passenger |
255
-
|`requested_trip_start_location`|`{ lat: number, lng: number }`| Conditionally Required | Location where the customer requested the trip to start (required if this is within jurisdictional boundaries) |
257
+
|`requested_trip_start_location`|[Point](point)| Conditionally Required | Location where the customer requested the trip to start (required if this is within jurisdictional boundaries) |
256
258
|`reservation_method`| Enum | Required | Way the customer created their reservation, see [reservation-method](#reservation-method)|
257
259
|`reservation_time`|[Timestamp][ts]| Required | Time the customer *requested* a reservation |
258
260
|`reservation_type`| Enum | Required | Type of reservation, see [reservation-type](#reservation-type)|
0 commit comments