26.0 Current Location

26.2a XML Data Returned

Back to Index

The current location(s) for the specified assets (all if none specified) are returned in XML format.

DTD

<!ELEMENT currentlocation (asset*)>

<!ELEMENT asset (long, lat, heading, time, speed, power, loi_distance)>
<!ATTLIST asset tagid CDATA #REQUIRED>
<!ATTLIST asset fleet CDATA #REQUIRED>
<!ATTLIST asset id CDATA #REQUIRED>
<!ATTLIST asset type CDATA #REQUIRED>

<!ELEMENT long (#PCDATA)>
<!ELEMENT lat (#PCDATA)>
<!ELEMENT loi (#PCDATA)>
<!ELEMENT heading (#PCDATA)>
<!ELEMENT time (#PCDATA)>
<!ELEMENT speed (#PCDATA)>
<!ATTLIST speed unit CDATA #REQUIRED>
<!ELEMENT power (#PCDATA)>
<!ELEMENT loi_distance (#PCDATA)>
<!ATTLIST loi_distance name CDATA #REQUIRED>
<!ATTLIST loi_distance unit CDATA #REQUIRED>
<!ATTLIST loi_distance inside CDATA #REQUIRED>

logvers=3.1 DTD

<!ELEMENT currentlocation (asset*)>
<!ELEMENT asset (long, lat, heading, time, speed, power, loi_distance)>
<!ATTLIST asset tagid CDATA #REQUIRED>
<!ATTLIST asset fleet CDATA #REQUIRED>
<!ATTLIST asset id CDATA #REQUIRED>
<!ATTLIST asset type CDATA #REQUIRED>

<!ELEMENT long (#PCDATA)>
<!ELEMENT lat (#PCDATA)>
<!ELEMENT loi (#PCDATA)>
<!ELEMENT heading (#PCDATA)>
<!ELEMENT time (#PCDATA)>
<!ELEMENT speed (#PCDATA)>
<!ATTLIST speed unit CDATA #REQUIRED>
<!ELEMENT power (#PCDATA)>
<!ELEMENT loi_distance (#PCDATA)>
<!ATTLIST loi_distance name CDATA #REQUIRED>
<!ATTLIST loi_distance unit CDATA #REQUIRED>
<!ATTLIST loi_distance inside CDATA #REQUIRED>
<!ELEMENT odometer (#PCDATA)>

logvers=3.4 DTD

<!ELEMENT currentlocation (asset*)>
<!ELEMENT asset (long, lat, heading, time, speed, power, loi_distance>
<!ATTLIST asset tagid CDATA #REQUIRED>
<!ATTLIST asset fleet CDATA #REQUIRED>
<!ATTLIST asset id CDATA #REQUIRED>
<!ATTLIST asset type CDATA #REQUIRED>
<!ATTLIST asset exsid CDATA #REQUIRED>
<!ELEMENT long (#PCDATA)>
<!ELEMENT lat (#PCDATA)>
<!ELEMENT loi (#PCDATA)>
<!ELEMENT heading (#PCDATA)>
<!ELEMENT time (#PCDATA)>
<!ELEMENT speed (#PCDATA)>
<!ATTLIST speed unit CDATA #REQUIRED>
<!ELEMENT power (#PCDATA)>
<!ELEMENT loi_distance (#PCDATA)>
<!ATTLIST loi_distance name CDATA #REQUIRED>
<!ATTLIST loi_distance unit CDATA #REQUIRED>
<!ATTLIST loi_distance inside CDATA #REQUIRED>
<!ELEMENT address (#PCDATA)>

logvers=3.5 DTD

<!ELEMENT currentlocation (asset*)>
<!ELEMENT asset (long, lat, heading, time, speed, power, loi_distance)>
<!ATTLIST asset tagid CDATA #REQUIRED>
<!ATTLIST asset fleet CDATA #REQUIRED>
<!ATTLIST asset id CDATA #REQUIRED>
<!ATTLIST asset type CDATA #REQUIRED>
<!ELEMENT long (#PCDATA)>
<!ELEMENT lat (#PCDATA)>
<!ELEMENT loi (#PCDATA)>
<!ELEMENT heading (#PCDATA)>
<!ELEMENT time (#PCDATA)>
<!ELEMENT speed (#PCDATA)>
<!ATTLIST speed unit CDATA #REQUIRED>
<!ELEMENT power (#PCDATA)>
<!ELEMENT odometer (#PCDATA)>
<!ELEMENT odo_offset (#PCDATA)>
<!ELEMENT source (#PCDATA)>
<!ELEMENT fuel_counter (#PCDATA)>
<!ATTLIST fuel_counter unit CDATA #REQUIRED>
<!ELEMENT fuel_level_pct (#PCDATA)>
<!ELEMENT fuel_counter (#PCDATA)>
<!ELEMENT avg_rpm (#PCDATA)>
<!ATTLIST loi_distance name CDATA #REQUIRED>
<!ATTLIST loi_distance unit CDATA #REQUIRED>
<!ATTLIST loi_distance inside CDATA #REQUIRED>

logvers=3.6 DTD

<!ELEMENT currentlocation (asset*)>
<!ELEMENT asset (long, lat, heading, time, speed, power, loi_distance)>
<!ATTLIST asset tagid CDATA #REQUIRED>
<!ATTLIST asset fleet CDATA #REQUIRED>
<!ATTLIST asset id CDATA #REQUIRED>
<!ATTLIST asset type CDATA #REQUIRED>
<!ELEMENT long (#PCDATA)>
<!ELEMENT lat (#PCDATA)>
<!ELEMENT loi (#PCDATA)>
<!ELEMENT heading (#PCDATA)>
<!ELEMENT time (#PCDATA)>
<!ELEMENT speed (#PCDATA)>
<!ATTLIST speed unit CDATA #REQUIRED>
<!ELEMENT power (#PCDATA)>
<!ELEMENT odometer (#PCDATA)>
<!ELEMENT odo_offset (#PCDATA)>
<!ELEMENT source (#PCDATA)>
<!ELEMENT fuel_counter (#PCDATA)>
<!ATTLIST fuel_counter unit CDATA #REQUIRED>
<!ELEMENT fuel_level_pct (#PCDATA)>
<!ELEMENT fuel_counter (#PCDATA)>
<!ELEMENT avg_rpm (#PCDATA)>
<!ATTLIST loi_distance name CDATA #REQUIRED>
<!ATTLIST loi_distance unit CDATA #REQUIRED>
<!ATTLIST loi_distance inside CDATA #REQUIRED>
<!ELEMENT address (#PCDATA)>

Reply Data
Name Description
tagid The Zonar RFID tag number assigned to the asset.
fleet Fleet number. An arbitrary text string of up to 20 characters in length.
type The asset type identifier.
long the longitude of the last location
lat the latitude of the last location
time the timestamp of the last reported location
heading the heading at the last location.
speed the speed at the last location
unit(speed) the units associated with the speed value
power the status of the power flag.
loi_distance the distance from the asset to the center of the LOI (if supplied).
name (loi_distance) name of the queried LOI
unit (loi_distance) the unit associated with the LOI1 distance
inside (loi_distance) 0 or 1 to indicate the asset is outside or inside the LOI respectively
odometer Odometer value measured in meters.
odo_offset Odometer offset value measured in meters.
address Geocoded Address based on lat/long.
source Data source (GPS or ECM).
fuel_counter Fuel counter at the last location.
unit(fuel_counter) The unit associated with the fuel counter.
fuel_level_pct Fuel level percentage at the last location.
avg_rpm Average RPM between the last location and the GPS point before it.

 

Example XML Request (single asset)

http://gpsdev.zonarsystems.net/interface.php?action=showposition
&operation=current&format=xml&version=2&logvers=3&customer=cfg0013
&target=182&reqtype=dbid

Example Success Reply XML

 

Example XML Request (single asset, with location)

http://gpsdev.zonarsystems.net/interface.php?action=showposition
&operation=current&format=xml&version=2&logvers=3&customer=cfg0013&target=182
&reqtype=dbid&loilocation=AcmeHQ

Example Success Reply XML

 

Example XML Request (multiple assets)

http://gpsdev.zonarsystems.net/interface.php?action=showposition
&operation=current&format=xml&version=2&logvers=3&customer=cfg0013&startrow=0
&count=10&sortfield=lasttime&sortdir=asc

Example Success Reply XML

 

1 LOI means Location of Interest; called “Zone” in the GPS tools and reports found within the Ground Traffic Control web application.

Is this api manual documents helpful?
0 out of 0 said Yes
YesNo