| | BusPositionInfo | | This object exposes telematics information to the zone. | |
@
 | BusInfoRefId | M | The GUID that identifies the bus. This object only has meaning as current data for this particular bus. | IdRefType |
| | Date | M | The date of the report from the bus. | xs:date |
| | Time | M | The time of the report from the bus. | xs:time |
| | GridLocation | M | The location of the bus. | GridLocation |
| | TelematicsId | O | ID of the hardware unit on the bus that tracks & reports location and status. The interpretation of the content is deployment specific, but the format must be compact. | xs:normalizedString |
| | TelemetryList | O | | List |
| | TelemetryList/Telemetry | OR | Indicators and values provided by the hardware along with this position snapshot. For events, it is safe to assume that one of these items triggered the hardware to issue an update. The following values are suggested for common reports to enhance interoperability, but each deployment will have items dictated by the infrastructure. A format for reporting continuous-value metrics is also suggested. Suggested Values: Panic—panic button pressed Accident—airbag deployed or some other detection Checkpoint—manually triggered per procedures Assistance—non-emergency request Timer—timed report RouteStatus—change to RouteStatus/Status Open—door open Close—door closed ToD—shifted into "Drive" OffD—shifted off "Drive" StpLght—Stop Lights are on WrngLght—Warning lights are on StpArm—Stop arm is out CrsngGt—Crossing gate is extended EcmOp—ECM Oil Pressure is Low EcmOt—ECM Oil Temperature is high EcmTt—ECM transmission temperature is high EcmTp—Transmission Oil Pressure is low EcmFuelPrs—ECM Fuel Pressure is low EcmExtIdle—ECM Extended engine idle period EcmOvrSpeed—ECM engine over Speed EcmVltg—ECM Voltage is low OutBndry—Out of Boundary FuelGauge-34pct—suggested continuous-value syntax, minimal use of special characters | xs:normalizedString |
| | BusDriver | O | Information identifying the driver. | |
| | BusDriver/Name | C | The name of the driver. Condition is that at least one of this and EmployeePersonalRefId must be included. | Name |
| | BusDriver/EmployeePersonalRefId
| C | The GUID of the driver's EmployeePersonal object. Condition is that at least one of this and BusDriver/Name must be included. | IdRefType |
| | BusDriver/Status | M | Boarding status of the driver. | values:
- On
- Driver boarded the bus and no exit detected
- Off
- Driver exited the bus
- Sched
- Scheduled for this run, but either hasn't boarded or the telematics hardware can't confirm who the driver is
|
| | BusStaffList | O | List identifying other staff. This may include aides, nurses, proctors, etc. | List |
| | BusStaffList/BusStaff | OR | Information about an individual staff member on the bus. | |
| | BusStaffList/BusStaff/Name
| C | The name of this staff member. Condition is that at least one of this and EmployeePersonalRefId must be included. | Name |
| | BusStaffList/BusStaff/EmployeePersonalRefId
| C | The GUID of the employee's EmployeePersonal object. Condition is that at least one of this and BusStaff/Name must be included. | IdRefType |
| | BusStaffList/BusStaff/Status
| M | Boarding status of this staff member. | values:
- On
- Boarded the bus and no exit detected
- Off
- Exited the bus
- Sched
- Scheduled for this run, but either hasn't boarded or the telematics hardware can't confirm this staff's identity
|
| | RouteStatus | C | If the bus is running a route, this element must be included in the object.
Absence means the bus is not operating a route. | |
| | RouteStatus/BusRouteInfoRefId
| M | The GUID that identifies the route. | IdRefType |
| | RouteStatus/Status | M | Status of the route. | values:
- Begin
- No students have been picked up yet
- End
- All students have been dropped off
- Continue
- In the midst of a run
|
| @ | BusRouteDetailRefId | O | If the bus is currently at a stop in this route, identify the stop's SIF object. | IdRefType |
| | OtherStatus | C | If the bus is not running a regularly scheduled route but is transporting (or positioning to transport) passengers as approved and directed by the school district, this element describes the activity. It's also used for maintenance, repair, and other authorized movements. This element is mutually exclusive with RouteStatus. Absence of both RouteStatus and OtherStatus is acceptable, but may indicate unauthorized operation. The following values are suggested to enhance interoperability, but the field is free-form. Suggested Values: Field Trip Sporting Event Support Services Maintenance Repair | xs:normalizedString |
| | Odometer | O | Current odometer reading. | xs:decimal |
| @ | Unit | M | Units used in the odometer reading. | values:
- km
- Kilometers
- m
- Miles
|
| | Speedometer | O | Current speedometer reading. | xs:decimal |
| @ | Unit | M | Units used in the speedometer reading. | values:
- km
- Kilometers/hour
- m
- Miles/hour
|
| | Students | O | A list of students and their statuses. The complete list may be sent with some events (e.g. change in RouteStatus) per district policy, but it is more typical of responses. | List |
| | Students/Student | OR | Each student's status. | |
| | Students/Student/StudentPersonalRefId
| M | GUID that identifies the student that this element refers to. | IdRefType |
| | Students/Student/Status | M |
Boarding status of this student. Note: Values Sched, On and Off are typical of responses. Values Entered
and Exited are typical of events.
| values:
- On
- Student boarded the bus and no exit detected
- Off
- Student exited the bus
- Entered
- Boarded the bus since previous event
- Exited
- Left the bus since previous event
- Sched
- Scheduled for this run, but either hasn't boarded or the telematics hardware can't confirm student identities
|
| | SIF_Metadata | O | | SIF_Metadata |
| | SIF_ExtendedElements | O | | SIF_ExtendedElements |
