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 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
1 LOI means Location of Interest; called “Zone” in the GPS tools and reports found within the Ground Traffic Control web application.
