Status Operational Status

Mileage Reporting

  • Last edited on

Use this call to obtain a report of the elapsed mileage for assets in the system or a specific asset for a specified time range. This value is computed using the following process:

  1. The reported mileage value for the earliest inspection within the specified time range is found.
  2. This value is subtracted from the reported mileage value for the latest inspection within the specified time range.
  3. The result is the elapsed mileage for that asset.

To find the current reported mileage value for an asset, use the Get Assets call. 

Though the term mileage is used, this number may refer to kilometers, hours of operation or any other value collected during the asset inspection. Implementers should understand the nature of the inspections they are working with and the data collected.

Request Data

This action was added to protocol version 1.01.

This action has changed in version 2. When requesting a specific asset using either the tag or fleet request types the asset type must also be specified. Version 1.x requests will assume a type of Standard (0) in these situations.

Required Information
Name Description
action showstats
operation mileage
format xml
startyear Year component of the report start date. Integer.
startmonth Month component of the report start date. Integer between 1 and 12 inclusive.
startday Day component of the report start date. Integer.
endyear Year component of the report end date. Integer.
endmonth Month component of the report end date. Integer between 1 and 12 inclusive.
endday Day component of the report end date. Integer.
Optional Information
logvers Log version for this API call. Acceptable values are:
  • 2 This allows for two now parameters to be sent; start and end
start Epoch timestamp for the report start. Note that start is only valid when used with logvers=2
end Epoch timestamp for the report end. Note that start is only valid when used with logvers=2
location Location to filter with. Text. If provided only assets assigned to that location will be returned. If location is not supplied or an empty location is specified, assets from all locations will be returned.

If a target is specified, the location filter is not applied.
showactiveonly If specified as 'true' only assets with an elapsed mileage greater than 0 will be returned and negative elapsed mileages will not be counted towards the total mileage for the fleet.
target Specific asset to report mile for, rather than entire fleet. If specified then reqtype must be specified as well. See asset target for details.
reqtype Flag to identify the key being used to query. Acceptable values:
  • tag Key is a Zonar RFID tag number. In version 2 a type must also be specified.
  • exsid Key is the external system id.
  • vin Key is the Vehicle Identification Number (VIN).
  • dbid Key is the internal id number. This is the most reliable key to use.
  • fleet Key is the asset fleet number. In version 2 a type must also be specified.
type When using reqtype of tag or fleet this must also be specified in version 2.X. In version 1.x type Standard (0) is assumed. See asset types for more details.

Example Request

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=showstats&operation=mileage&format=xml&logvers=2&start=1541173351&end=1541518951

Data Returned

A list of assets with their elapsed mileage.

DTD

<!ELEMENT assetmileagelist (asset*)>
<!ATTLIST assetmileagelist ver CDATA #REQUIRED>
<!ATTLIST assetmileagelist assetcount CDATA #REQUIRED>
<!ATTLIST assetmileagelist activecount CDATA #REQUIRED>
<!ATTLIST assetmileagelist total CDATA #REQUIRED>
<!ELEMENT assetmiles (name, tag, vin, fleet, exsid, mileage, location, elapsed)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT tag (#PCDATA)>
<!ELEMENT vin (#PCDATA)>
<!ELEMENT fleet (#PCDATA)>
<!ELEMENT exsid (#PCDATA)>
<!ELEMENT mileage (#PCDATA)>
<!ELEMENT location (#PCDATA)>
<!ELEMENT elapsed (#PCDATA)>

Example Success Reply

<assetmileagelist ver="1.19" assetcount="119" activecount="0" total="0">
 <assetmiles>
  <name>1308013</name>
  <tag>32108445</tag>
  <vin>1GB56316181162864</vin>
  <fleet>08-445</fleet>
  <exsid/>
  <mileage>0</mileage>
  <location>Outreach Work Assets</location>
  <elapsed>0</elapsed>
 </assetmiles>
</assetmileagelist>

Example Error Reply

<error ver="1.0">
 <action>showstats</action>
 <code>110</code>
 <message>Invalid value for end: </message>
</error>

 

GPS Track and Trace

See more