-
Notifications
You must be signed in to change notification settings - Fork 4
/
vehicle_locations.schema.json
231 lines (231 loc) · 6.91 KB
/
vehicle_locations.schema.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
{
"primaryKey": "location_ping_id",
"missingValues": [
"NA",
"NaN",
""
],
"fields": [
{
"name": "location_ping_id",
"type": "string",
"description": "Identifies the recorded vehicle location event.",
"constraints": {
"required": true,
"unique": true
}
},
{
"name": "service_date",
"type": "date",
"description": "Service date. References GTFS"
},
{
"name": "event_timestamp",
"type": "datetime",
"description": "Recorded event timestamp.",
"constraints": {
"required": true
}
},
{
"name": "trip_id_performed",
"type": "string",
"title": "ID referencing trips_performed.trip_id_performed",
"description": "Identifies the trip performed. If trips_performed table is used, this must be populated in order to link to it."
},
{
"name": "trip_id_scheduled",
"type": "string",
"title": "ID referencing trips_performed.trip_id_scheduled",
"description": "Identifies the scheduled trip. "
},
{
"name": "trip_stop_sequence",
"type": "integer",
"title": "Positive integer referencing stop_visits.trip_stop_sequence",
"description": "The actual order of stops visited within a performed trip. The values must start at 1 and must be consecutive along the trip.<br/> Example: A bus departs the first stop and detours around the second and third scheduled stops, visiting one unscheduled stop and resuming regular service at the 4th scheduled stop. The `scheduled_stop_sequence` is [1, null, 4], and the `trip_stop_sequence` is [1, 2, 3].",
"constraints": {
"minimum": 1
}
},
{
"name": "scheduled_stop_sequence",
"type": "integer",
"title": "positive integer referencing GTFS stop_times.stop_sequence",
"description": "Scheduled order of stops for a particular trip. The values must increase along the trip but do not need to be consecutive. References GTFS",
"constraints": {
"minimum": 0
}
},
{
"name": "vehicle_id",
"type": "string",
"title": "ID referencing vehicles.vehicle_id",
"description": "Identifies a vehicle.",
"constraints": {
"required": true
}
},
{
"name": "device_id",
"type": "string",
"title": "ID references devices.device_id",
"description": "Identifies the device that recorded the vehicle location. May be null if only a single device is reporting vehicle location and the device_id is not distinct from vehicle_id."
},
{
"name": "pattern_id",
"type": "string",
"title": "unique identifier for the route-pattern",
"description": "Identifies the unique stop-path for a trip, may be distinct from GTFS shapes.shape_id"
},
{
"name": "stop_id",
"type": "string",
"title": "ID referencing GTFS stops.stop_id",
"description": "Identifies the stop the vehicle is approaching or serving currently. References GTFS"
},
{
"name": "current_status",
"type": "string",
"description": "Indicates the status of the vehicle in reference to a stop. References GTFS-Realtime",
"constraints": {
"enum": [
"Incoming at",
"Stopped at",
"In transit to"
]
}
},
{
"name": "latitude",
"type": "number",
"description": "Degrees North, in the WGS-84 coordinate system. References GTFS-Realtime",
"constraints": {
"minimum": -90,
"maximum": 90
}
},
{
"name": "longitude",
"type": "number",
"description": "Degrees East, in the WGS-84 coordinate system. References GTFS-Realtime",
"constraints": {
"minimum": -180,
"maximum": 180
}
},
{
"name": "gps_quality",
"type": "string",
"description": "Indicates the quality of data and communication provided by the GPS.",
"constraints": {
"enum": [
"Excellent",
"Good",
"Poor"
]
}
},
{
"name": "heading",
"type": "number",
"description": "Heading, in degrees, clockwise from true north, e.g., 0 would mean north and 90 would mean east. This can be the compass bearing, or the direction towards the next stop or intermediate location. This should not be deduced from the sequence of previous positions, which clients can compute from previous data. References GTFS-Realtime",
"constraints": {
"minimum": 0,
"maximum": 360
}
},
{
"name": "speed",
"type": "number",
"description": "Momentary speed measured by the vehicle, in meters per second. References GTFS-Realtime",
"constraints": {
"minimum": 0
}
},
{
"name": "odometer",
"type": "number",
"description": "Odometer value, in meters. References GTFS-Realtime",
"constraints": {
"minimum": 0
}
},
{
"name": "schedule_deviation",
"type": "integer",
"description": "Indicates schedule adherence in seconds. A negative value represents an early vehicle. (An unscheduled trip would not have a scheduled deviation.)"
},
{
"name": "headway_deviation",
"type": "integer",
"description": "Indicates headway adherence in seconds. A negative value represents a shorter than scheduled headway."
},
{
"name": "trip_type",
"type": "string",
"description": "Indicates status of travel with regard to service.",
"constraints": {
"enum": [
"In service",
"Deadhead",
"Layover",
"Pullout",
"Pullin",
"Extra Pullout",
"Extra Pullin",
"Deadhead To Layover",
"Deadhead From Layover",
"Other not in service"
]
}
},
{
"name": "schedule_relationship",
"type": "string",
"description": "Indicates the status of the stop.",
"constraints": {
"enum": [
"Scheduled",
"Skipped",
"Added",
"Missing"
]
}
}
],
"foreignReferences": [
{
"fields": ["service_date", "trip_id_performed"],
"reference": {
"resource": "trips_performed",
"fields": ["service_date", "trip_id_performed"]
}
},
{
"fields": ["service_date", "trip_id_performed", "stop_sequence"],
"reference": {
"resource": "stop_times",
"fields": ["service_date", "trip_id_performed", "stop_sequence"]
}
},
{
"fields": "vehicle_id",
"reference": {
"resource": "vehicles",
"fields": "vehicle_id"
}
},
{
"fields": "device_id",
"reference": {
"resource": "devices",
"fields": "device_id"
}
}
],
"name": "vehicle_locations.schema.json",
"description": "Timestamped vehicle locations and speeds.",
"_table_type": "Event"
}