43.0 List Personnel (Z Pass / Ridership) Events

43.2 Data Returned

Back to Index
logvers = 1 DTD
<!ELEMENT persevents (count, event*)>
<!ATTLIST persevents ver CDATA #REQUIRED>
<!ATTLIST persevents count CDATA #REQUIRED>
<!ELEMENT event (asset?, personnel)>
<!ATTLIST event timestamp CDATA #REQUIRED>
<!ATTLIST event sn CDATA #REQUIRED>
<!ATTLIST event type CDATA #REQUIRED>
<!ATTLIST event latlong CDATA #REQUIRED>
<!ATTLIST event loiname CDATA #REQUIRED>
<!ELEMENT asset (fleet, assetid, assettag, exsid, assettype)>
<!ELEMENT asset fleet CDATA #REQUIRED>
<!ELEMENT asset assetid CDATA #REQUIRED>
<!ELEMENT asset assettag CDATA #REQUIRED>
<!ELEMENT asset exsid CDATA #REQUIRED>
<!ELEMENT asset assettype CDATA #REQUIRED>
<!ELEMENT personnel (tagid, ptype)>
<!ELEMENT personnel tagid CDATA #REQUIRED>
<!ELEMENT personnel ptype CDATA #REQUIRED>

 

logvers >= 2 student DTD

<!ELEMENT persevents (count, event*)>
<!ATTLIST persevents ver CDATA #REQUIRED>
<!ATTLIST persevents count CDATA #REQUIRED>
<!ELEMENT event (address, asset?, personnel)>
<!ATTLIST event timestamp CDATA #REQUIRED>
<!ATTLIST event sn CDATA #REQUIRED>
<!ATTLIST event type CDATA #REQUIRED>
<!ATTLIST event latlong CDATA #REQUIRED>
<!ATTLIST event loiname CDATA #REQUIRED>
<!ELEMENT address (street, number, zip, city, state, country)>
<!ELEMENT street (#PCDATA)>
<!ELEMENT number (#PCDATA)>
<!ELEMENT zip (#PCDATA)>
<!ELEMENT city (#PCDATA)>
<!ELEMENT state (#PCDATA)>
<!ELEMENT country (#PCDATA)>
<!ELEMENT asset (fleet, assetid, assettag, exsid, assettype)>
<!ELEMENT fleet CDATA #REQUIRED>
<!ELEMENT assetid CDATA #REQUIRED>
<!ELEMENT assettag CDATA #REQUIRED>
<!ELEMENT exsid CDATA #REQUIRED>
<!ELEMENT assettype CDATA #REQUIRED>
<!ELEMENT personnel (tagid, ptype)>
<!ELEMENT tagid CDATA #REQUIRED>
<!ELEMENT ptype CDATA #REQUIRED>

 

logvers = 3 driver DTD

<!ELEMENT persevents (count, event*)>
<!ATTLIST persevents ver CDATA #REQUIRED>
<!ATTLIST persevents count CDATA #REQUIRED>
<!ELEMENT event (address, asset?, personnel)>
<!ATTLIST event timestamp CDATA #REQUIRED>
<!ATTLIST event sn CDATA #REQUIRED>
<!ATTLIST event type CDATA #REQUIRED>
<!ATTLIST event latlong CDATA #REQUIRED>
<!ATTLIST event loiname CDATA #REQUIRED>
<!ELEMENT address (street, number, zip, city, state, country)>
<!ELEMENT street (#PCDATA)>
<!ELEMENT number (#PCDATA)>
<!ELEMENT zip (#PCDATA)>
<!ELEMENT city (#PCDATA)>
<!ELEMENT state (#PCDATA)>
<!ELEMENT country (#PCDATA)>
<!ELEMENT asset (fleet, assetid, assettag, exsid, assettype)>
<!ELEMENT fleet CDATA #REQUIRED>
<!ELEMENT assetid CDATA #REQUIRED>
<!ELEMENT assettag CDATA #REQUIRED>
<!ELEMENT exsid CDATA #REQUIRED>
<!ELEMENT assettype CDATA #REQUIRED>
<!ELEMENT personnel (tagid, fname, lname, exsid)>
<!ATTLIST personnel cardtype (student|driver) #REQUIRED>
<!ELEMENT tagid CDATA #REQUIRED>
<!ELEMENT fname CDATA #REQUIRED>
<!ELEMENT lname CDATA #REQUIRED>
<!ELEMENT exsid CDATA #REQUIRED>

 

Personnel Event Reply
Reply Data
Name Description
version The version number of the API call and return data.
count The number of results returned.
timestamp The time the event occurred. Unix epoch timestamp (UTC).
sn The serial number of the GPS unit that collected the event. A positive integer.
type The type of event that occurred. A short text label identifying the event type. Text, 24 characters maximum length.
latlong The latitude and longitude position of where the event occurred (format: lat,long).
loiname The name of the Location of Interest* that the vehicle was in when the event was logged. This will be either
the smallest of the LOIs that the event position is contained within, or
in the case of
multiple LOIs the most recently added one. Text, 100 characters maximum
length.
Asset The asset that was associated with the GPS unit collecting the event data. If the GPS unit question
was not assigned to an asset this element will not be present.
fleet The asset fleet number. Usually displayed in the web interface as Asset No. Alphanumeric, 20 characters maximum.
This may be empty if the asset does not have a fleet number.
assettag The Zonar RFID tag number of the asset the data is associated with. Numeric either a positive integer or zero.
This may be zero if the asset does not have a tag number.
exsid External system identifier of the asset the data is associated with.
This may be empty if the asset does not have an exsid. Arbitrary text up to 40 characters in length.
assetype The type of the asset.
See asset types for more details.
assetid Database id of the asset the data is associated with. This will be a positive integer.
tagid The RFID tag number used by the individual.
ptype Student only, the type of personnel that the individual is. Text 24 characters maximum length.
fname Driver only, the first name of the driver who created the event.
lname Driver only, the last name of the driver who created the event.
exsid Driver only, the exsid of the driver who created the event.
Example Request:

http://development.zonarsystems.net/interface.php?format=xml&action=showevents&operation=list&version=2

Example Success Reply logvers=1
Example Success Reply logvers=2
Example Success Reply logvers=3