52. Get GPS Phone Home

52.1 Request Data

Required Information
Name	Description
action	showopen
operation	getphonehome
format	xml
startdate	date for report start limit - must be in epoch format
enddate	date for report end limit - must be in epoch format(total time must be less than 24 hours)
Optional Information
Name	Description
target	Specific asset to report for, rather than entire fleet. If specified then reqtype and type must be specified as well.
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. Type Standard (0) is assumed. See asset types for more details.

Required Information

Name

Description

action

showopen

operation

getphonehome

format

xml

startdate

date for report start limit - must be in epoch format

enddate

date for report end limit - must be in epoch format(total time must be less than 24 hours)

Optional Information

Name

Description

target

Specific asset to report for, rather than entire fleet. If specified then reqtype and type must be specified as well.

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. Type Standard (0) is assumed. See asset types for more details.

52.2 Data Returned

Returned information:
DTD:


      <!ELEMENT gpsphonelist (gpsphonecall*) >

      <!ATTLIST gpsphonelist ver CDATA #REQUIRED>

      <!ELEMENT gpsphonecall (asset, scid, fwver, uploc, logvers, gpssn, timestamp) >

      <!ELEMENT asset >

      <!ATTLIST asset tagid CDATA #REQUIRED>

      <!ATTLIST asset fleet CDATA #REQUIRED>

      <!ATTLIST asset id CDATA #REQUIRED>

      <!ATTLIST asset exsid CDATA #REQUIRED>

      <!ATTLIST asset type CDATA #REQUIRED>

      <!ELEMENT scid (#PCDATA)>

      <!ELEMENT fwver (#PCDATA)>

      <!ELEMENT uploc (#PCDATA)>

      <!ELEMENT logvers (#PCDATA)>

      <!ELEMENT gpssn (#PCDATA)>

      <!ELEMENT timestamp (#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.
id	ID. The internal database identification number.
exsid	EXSID. The external system identification number.
type	The asset type identifier.
scid	SCID of the unit sending data
fwver	Firmware version of GPS unit sending data
uploc	Upload location name of where the data was sent
logvers	Logvers of the unit sending data
gpssn	GPS Serial Number of GPS unit sending data
timestamp	Datetime stamp of when the data was sent

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.

ID. The internal database identification number.

exsid

EXSID. The external system identification number.

type

The asset type identifier.

scid

SCID of the unit sending data

fwver

Firmware version of GPS unit sending data

uploc

Upload location name of where the data was sent

logvers

Logvers of the unit sending data

gpssn

GPS Serial Number of GPS unit sending data

timestamp

Datetime stamp of when the data was sent

Example Request:


      http://development.zonarsystems.net/interface.php?action=showopen&operation=getphonehome&startdate=1237100400&enddate=1237186800&format=xml