Vehicle Positions Properties

[jmfield2]

Per https://developers.google.com/transit/gtfs-realtime/reference/VehiclePosition, the vehicle positions system should be updated to include any defined properties that are currently missing. Some properties may not be provided by Syncromatics, and others could be included outside of the spec as a workaround - more discussion of this @ opentripplanner/OpenTripPlanner#2329

TripDescriptor:

• trip_id string
• route_id string
• direction_id uint32
• start_time string
• start_date string
• schedule_relationship ScheduleRelationship

ScheduleRelationship:

• SCHEDULED
• ADDED
• UNSCHEDULED
• CANCELED

VehicleDescriptor:

• id string
• label string
• license_plate string

VehicleStopStatus:

• INCOMING_AT
• STOPPED_AT
• IN_TRANSIT_TO

Position:

• latitude float
• longitude float
• bearing float
• odometer double
• speed float

CongestionLevel:

• UNKNOWN_CONGESTION_LEVEL
• RUNNING_SMOOTHLY
• STOP_AND_GO
• CONGESTION
• SEVERE_CONGESTION

OccupancyStatus:

• EMPTY
• MANY_SEATS_AVAILABLE
• FEW_SEATS_AVAILABLE
• STANDING_ROOM_ONLY
• CRUSHED_STANDING_ROOM_ONLY
• FULL
• NOT_ACCEPTING_PASSENGERS

VehiclePosition:

• trip TripDescriptor
• vehicle VehicleDescriptor
• position Position
• current_stop_sequence uint32
• stop_id string
• current_status VehicleStopStatus
• timestamp uint64 (Time when the position was measured)
• congestion_level CongestionLevel
• occupancy_status OccupancyStatus

Proposed timestamp workaround:
Modify api/resource/VehiclePositionsList and add the following header information:

"agency": "University of South Florida",
"version": "1.0",
"numStops": 728,
"TimeStamp": "2016-10-13T06:10:57-07:00",

Either at the root level, or inside another element like "header", so the resulting XML would be

<VehiclePositionsList><header/><Vehicles><Vehicle/></Vehicles></VehiclePositionsList>

Currently, we add the agencyId into each Vehicle element - it seems like this should be moved to the <header/> area.

• TripDescriptor
• VehicleDescriptor
• VehicleStopStatus
• Position
• CongestionLevel
• OccupancyStatus
• VehiclePosition

Checklist:

• OTP Updater
• GTFS-RT Generator
• REST API and Frontend