6.16 Transportation and Geographic Information Working Group

The goal of Transportation and Geographic Information Working Group is to provide the wealth of information currently locked in the transportation department to the rest of the school community, including transportation as well as geographic information for students.

Click here for non-normative background/supplementary documentation from this group.

6.16.1 BusEquipment

This object contains information about a type of equipment that may be on a bus. Examples include wheelchair, car seat, etc.

SIF_Events are reported for this object.

BusEquipment
Figure 6.16.1-1: BusEquipment BusEquipment RefId Description SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 BusEquipment 

This object contains information about a type of equipment that may be on a bus. Examples include wheelchair, car seat, etc.

 
 
@
key
RefIdM

GUID that identifies this type of equipment.

 
RefIdType
 DescriptionM

Explanation about the type of equipment.

 
xs:string
 SIF_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.1-1: BusEquipment
<BusEquipment RefId="D3E34B359D75101A8C3D00AA001A1652"> <Description>Wheelchair</Description> </BusEquipment>
Example 6.16.1-1: BusEquipment

6.16.2 BusInfo

This object contains all of the information about a bus.

SIF_Events are reported for this object.

BusInfo
Figure 6.16.2-1: BusInfo BusInfo RefId VehicleNumber SeatingCapacity Contractor EquipmentList Equipment BusEquipmentRefId Count SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 BusInfo 

This object contains all of the information about a bus.

 
 
@
key
RefIdM

GUID that identifies this bus.

 
RefIdType
 VehicleNumberM

Vehicle number of the bus.

 
xs:normalizedString
 SeatingCapacityO

The number of people who can ride on the bus at the same time.

 
xs:unsignedInt
 ContractorO

The name of the contractor for this bus.

 
xs:normalizedString
 EquipmentListO

Describes any special equipment that is on this bus.

 
List
 EquipmentList/EquipmentMR

Inventories each piece of special equipment on the bus.

 
 
 EquipmentList/Equipment/BusEquipmentRefId
     
M

GUID that identifies the type of equipment.

 
IdRefType
 EquipmentList/Equipment/Count
     
M

The number of pieces of this type of equipment that are on this bus.

 
xs:unsignedInt
 SIF_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.2-1: BusInfo
<BusInfo RefId="D3E34B359D75101A8C3D00AA001A1652"> <VehicleNumber>63</VehicleNumber> <SeatingCapacity>71</SeatingCapacity> <Contractor>RYDER</Contractor> <EquipmentList> <Equipment> <BusEquipmentRefId>E2F23A5323E87343B9A34BE457321E4A</BusEquipmentRefId> <Count>3</Count> </Equipment> <Equipment> <BusEquipmentRefId>34BE45E87343B9A5323A73212F23E7B3</BusEquipmentRefId> <Count>4</Count> </Equipment> </EquipmentList> </BusInfo>
Example 6.16.2-1: BusInfo

6.16.3 BusPositionInfo

This object exposes telematics information to the zone.

SIF_Events are reported for this object.

BusPositionInfo
Figure 6.16.3-1: BusPositionInfo BusPositionInfo BusInfoRefId Date Time GridLocation TelematicsId TelemetryList Telemetry BusDriver Name EmployeePersonalRefId Status BusStaffList BusStaff Name EmployeePersonalRefId Status RouteStatus BusRouteInfoRefId Status OtherStatus Odometer Unit Speedometer Unit Students Student StudentPersonalRefId Status SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 BusPositionInfo 

This object exposes telematics information to the zone.

 
 
@
key
BusInfoRefIdM

The GUID that identifies the bus. This object only has meaning as current data for this particular bus.

 
IdRefType
 DateM

The date of the report from the bus.

 
xs:date
 TimeM

The time of the report from the bus.

 
xs:time
 GridLocationM

The location of the bus.

 
GridLocation
 TelematicsIdO

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
 TelemetryListO List
 TelemetryList/TelemetryOR

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
 BusDriverO

Information identifying the driver.

 
 
 BusDriver/NameC

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/StatusM

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
 BusStaffListO

List identifying other staff. This may include aides, nurses, proctors, etc.

 
List
 BusStaffList/BusStaffOR

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
 RouteStatusC

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/StatusM

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
@BusRouteDetailRefIdO

If the bus is currently at a stop in this route, identify the stop's SIF object.

 
IdRefType
 OtherStatusC

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
 OdometerO

Current odometer reading.

 
xs:decimal
@UnitM

Units used in the odometer reading.

 
values:
km
Kilometers
m
Miles
 SpeedometerO

Current speedometer reading.

 
xs:decimal
@UnitM

Units used in the speedometer reading. 

 
values:
km
Kilometers/hour
m
Miles/hour
 StudentsOA 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/StudentOR

Each student's status.

 
 
 Students/Student/StudentPersonalRefId
     
M

GUID that identifies the student that this element refers to.

 
IdRefType
 Students/Student/StatusM

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_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.3-1: BusPositionInfo
<BusPositionInfo BusInfoRefId="A2E35B359D75101A8C3D00AA001A0000"> <Date>2003-10-13</Date> <Time>13:39:12-08:00</Time> <GridLocation> <Latitude>41.850000</Latitude> <Longitude>-87.650000</Longitude> </GridLocation> <TelematicsId>NexTel866-456-7890</TelematicsId> <TelemetryList> <Telemetry>Close</Telemetry> </TelemetryList> <BusDriver> <EmployeePersonalRefId>BB0300099D75101A8C3D00AA001A0000</EmployeePersonalRefId> <Status>Sched</Status> </BusDriver> <RouteStatus> <BusRouteInfoRefId>D3E34B359D75101A8C3D00AA001A1652</BusRouteInfoRefId> <Status>Continue</Status> </RouteStatus> <Odometer Unit="km">100000.0</Odometer> <Speedometer Unit="km">60</Speedometer> <Students> <Student> <StudentPersonalRefId>F3B35B359D75101A8C3D00AA001A0000</StudentPersonalRefId> <Status>Entered</Status> </Student> <Student> <StudentPersonalRefId>A7E35B359D75101A8C3D00BB211A0000</StudentPersonalRefId> <Status>Entered</Status> </Student> <Student> <StudentPersonalRefId>A9D35B359D75101A8C3D00AA001A9999</StudentPersonalRefId> <Status>Entered</Status> </Student> </Students> </BusPositionInfo>
Example 6.16.3-1: BusPositionInfo

6.16.4 BusRouteDetail

This object contains the schedule for the bus route.

SIF_Events are reported for this object.

BusRouteDetail
Figure 6.16.4-1: BusRouteDetail BusRouteDetail RefId BusRouteInfoRefId BusStopInfoRefId ArrivalTime SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 BusRouteDetail 

This object contains the schedule for the bus route.

 
 
@
key
RefIdM

GUID that identifies this object.

 
RefIdType
@BusRouteInfoRefIdM

GUID that identifies the bus route.

 
IdRefType
 BusStopInfoRefIdM

GUID that identifies a bus stop on the route.

 
IdRefType
 ArrivalTimeM

The time that the bus associated with this route will stop at this bus stop.

 
xs:time
 SIF_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.4-1: BusRouteDetail
<BusRouteDetail RefId="D3E34B359D75101A8C3D00AA001A1652" BusRouteInfoRefId="C2F23F450B86234B9B3D00AA001A1652"> <BusStopInfoRefId>B7A34E561C97345C0A4E11BB112B2753</BusStopInfoRefId> <ArrivalTime>15:39:00-08:00</ArrivalTime> </BusRouteDetail>
Example 6.16.4-1: BusRouteDetail

6.16.5 BusRouteInfo

This object contains all of the information about a bus route.

SIF_Events are reported for this object.

BusRouteInfo
Figure 6.16.5-1: BusRouteInfo BusRouteInfo RefId BusInfoRefId RouteNumber RouteType MaximumLoad Description Name RouteDurationLoaded RouteDurationTotal RouteDistanceLoaded Unit RouteDistanceTotal Unit SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 BusRouteInfo 

This object contains all of the information about a bus route.

 
 
@
key
RefIdM

GUID that identifies this bus route.

 
RefIdType
 BusInfoRefIdM

GUID that identifies the bus that is associated with this route.

 
IdRefType
 RouteNumberM

A unique identifier for the route. It may contain any printable ASCII character. F or instance, you may have route 16AM in the morning and a 16PM in the afternoon.

 
xs:normalizedString
 RouteTypeM

The type of route.

 
values:
Inbound
Outbound
 MaximumLoadO

The maximum number of students who are on the bus at any point along this route.

 
xs:unsignedInt
 DescriptionO

Short explanation of the route. It may be used to designate an area, or used to color-code bus routes (the "orange" route).

 
xs:string
 NameO

Name of the driver who drives this route.

 
Name
 RouteDurationLoadedO

Refers to the amount of time that at least one student is riding the bus.

 
xs:duration
 RouteDurationTotalO

Includes time when no student is on the bus, including time driving to and from the garage, etc.

 
xs:duration
 RouteDistanceLoadedO

Refers to the distance the bus drives when at least one student is riding the bus.

 
xs:decimal
@UnitM

Distance unit used.

 
values:
km
kilometers
m
miles
 RouteDistanceTotalO

Includes the total distance driven for this route including to and from garage.

 
xs:decimal
@UnitM

Distance unit used.

 
values:
km
kilometers
m
miles
 SIF_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.5-1: BusRouteInfo
<BusRouteInfo RefId="D3E34B359D75101A8C3D00AA001A1652"> <BusInfoRefId>A2E35B359D75101A8C3D00AA001A0000</BusInfoRefId> <RouteNumber>16AM</RouteNumber> <RouteType>Inbound</RouteType> <MaximumLoad>40</MaximumLoad> <Description>1st Transfer Bus</Description> <Name Type="02"> <LastName>Smith</LastName> <FirstName>Jon</FirstName> </Name> <RouteDurationLoaded>PT16M45S</RouteDurationLoaded> <RouteDurationTotal>PT28M00S</RouteDurationTotal> <RouteDistanceLoaded Unit="m">5.23</RouteDistanceLoaded> <RouteDistanceTotal Unit="m">9.9</RouteDistanceTotal> </BusRouteInfo>
Example 6.16.5-1: BusRouteInfo

6.16.6 BusStopInfo

This object contains information about a bus stop.

SIF_Events are reported for this object.

BusStopInfo
Figure 6.16.6-1: BusStopInfo BusStopInfo RefId Description GridLocation SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 BusStopInfo 

This object contains information about a bus stop.

 
 
@
key
RefIdM

GUID that identifies this location.

 
RefIdType
 DescriptionM

An explanation of this location.

 
xs:string
 GridLocationO

The location of the bus stop.

 
GridLocation
 SIF_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.6-1: BusStopInfo
<BusStopInfo RefId="D3E34B359D75101A8C3D00AA001A1652"> <Description>Elm St @ Pine Ave</Description> <GridLocation> <Latitude>41.850000</Latitude> <Longitude>-87.650000</Longitude> </GridLocation> </BusStopInfo>
Example 6.16.6-1: BusStopInfo

6.16.7 StudentTransportInfo

This object contains transportation information about a student. Students should have at least two StudentTransportInfo objects associated with them: one for inbound information (getting to school) and one for outbound information (leaving school). If their transportation changes based on the day of the week, then a student will have more than two StudentTransportInfo objects.

SIF_Events are reported for this object.

StudentTransportInfo
Figure 6.16.7-1: StudentTransportInfo StudentTransportInfo RefId StudentPersonalRefId Type DayOfWeek SchoolInfoRefId Eligibility HomeBusRouteDetail SIF_RefObject TransferPoints TransferPoint EmbarkBusRouteDetail SIF_RefObject DisembarkBusRouteDetail SIF_RefObject SchoolBusRouteDetail SIF_RefObject SIF_Metadata SIF_ExtendedElements
 Element/@AttributeCharDescriptionType
 StudentTransportInfo 

This object contains transportation information about a student. Students should have at least two StudentTransportInfo objects associated with them: one for inbound information (getting to school) and one for outbound information (leaving school). If their transportation changes based on the day of the week, then a student will have more than two StudentTransportInfo objects.

 
 
@
key
RefIdM

GUID that identifies this object.

 
RefIdType
@StudentPersonalRefIdM

GUID that identifies the student that this object refers to.

 
IdRefType
@TypeM

The direction of transportation that this object refers to.

 
values:
Inbound
Outbound
@DayOfWeekM

This attribute indicates the day(s) of the week to which this object refers.

 
xs:token
xs:pattern(Mo)?(Tu)?(We)?(Th)?(Fr)?(Sa)?(Su)?
@SchoolInfoRefIdM

GUID referring to the school that the student attends on these day(s) of the week.

 
IdRefType
 EligibilityO

Eligibility status of student for district transportation for this trip.

 
values:
Bus
Walk
BusHazard
BusOutOfAttendance
ParentPay
Unknown
 HomeBusRouteDetailO

GUID referring to a BusRouteDetail object that identifies the origin bus stop for an inbound route or the destination bus stop for an outbound route.

If the HomeBusRouteDetail element does not exist, then the student does not ride a bus to/from school.

 
IdRefType
@SIF_RefObjectM values:
BusRouteDetail
 TransferPointsO List
 TransferPoints/TransferPoint
     
OR

There should be one TransferPoint element for each intermediate point on a trip. The "embark" and "disembark" bus stops for a single transfer point must be at the same location. To order multiple TransferPoint elements, use the Time element of the BusStopInfo objects referenced by the attributes.

 
 
 TransferPoints/TransferPoint/
     EmbarkBusRouteDetail
M

GUID that identifies the bus stop/route where the student gets on the bus.

 
IdRefType
@SIF_RefObjectM values:
BusRouteDetail
 TransferPoints/TransferPoint/
     DisembarkBusRouteDetail
M

GUID that identifies the bus stop/route where the student gets off the bus.

 
IdRefType
@SIF_RefObjectM values:
BusRouteDetail
 SchoolBusRouteDetailO

GUID referring to a BusRouteDetail object that identifies the origin bus stop for an outbound route or the destination bus stop for an inbound route.

If the SchoolBusRouteDetail does not exist, then the student does not ride a bus to/from school.

 
IdRefType
@SIF_RefObjectM values:
BusRouteDetail
 SIF_MetadataO SIF_Metadata
 SIF_ExtendedElementsO SIF_ExtendedElements
Table 6.16.7-1: StudentTransportInfo
<StudentTransportInfo RefId="D3E34B359D75101A8C3D00AA001A1652" StudentPersonalRefId="C2F23F450B86234B9B3D00AA001A1652" Type="Inbound" DayOfWeek="MoWeFr" SchoolInfoRefId="B7A34E561C97345C0A4E11BB112B2753"> <Eligibility>Bus</Eligibility> <HomeBusRouteDetail SIF_RefObject="BusRouteDetail">A3B7564E971C5C344E0ABB11EE272B53</HomeBusRouteDetail> <SchoolBusRouteDetail SIF_RefObject="BusRouteDetail">7B3AE465C17943C5A0E411BB11B27235</SchoolBusRouteDetail> </StudentTransportInfo>
Example 6.16.7-1: StudentTransportInfo

Valid XHTML 1.0 Transitional