47. Get GPS Units

Returns a list of GPS units in the system.

47.1 Request Data

Select a list of GPS Units can be selected by either GPS id or GPS serial number.

Required Information
Name Description
action showopen
operation showgps
format xml
Optional Information
target Specify an individual target to view. Note: if used a reqtype must be specified.
reqtype Only return GPS units with the specified type. Possible values are
  • id The GPS unit's id.
  • gpssn The GPS unit's serial number.
filter Only return GPS units with the specified status.
  • 1 Show all assigned GPS units.
  • 2 Show all unassigned GPS units.
  • 3 Unassigned GPS units that have data.

47.2 Data Returned

Returned information:
A list of GPS Units.
DTD:
<!ELEMENT gpslist (gps*)>
<!ATTLIST gpslist ver CDATA #REQUIRED>
<!ELEMENT gps (id, sn, lastinspdate)>
<!ELEMENT asset (#PCDATA)>
<!ATTLIST asset id CDATA #IMPLIED>
<!ATTLIST asset exsid CDATA #IMPLIED>
<!ATTLIST asset tag CDATA #IMPLIED>
<!ELEMENT lastpositiondate (#PCDATA)>
<!ELEMENT firmware (#PCDATA)>
<!ELEMENT scid (#PCDATA)>
<!ELEMENT lastcallhome (#PCDATA)>

Reply Data
Name Description
gps The individual GPS unit.
id (gps) The individual GPS unit's database id.
lastinspdate (gps) The last reported inspection date by the GPS unit.
SN (gps) The GPS unit's serial number.
asset The asset the GPS unit is assigned to.
id (asset) The asset's database identifier.
exsid (asset) The external systems identifier.
tag (asset) Zonar RFID tag number. Integer, the tagid type combination must be unique if supplied.
lastpositiondate The last date reported by the GPS unit.
firmware Current firmware version for that GPS unit.
scid The GPS unit's SIM Card ID.
lastcallhome The last time the GPS unit made a call back.

Example Request:

http://development.zonarsystems.net/interface.php?action=showopen&operation=showgps&format=xml


Example Success Reply