
Note: The 'rf' and 'rt' date ranges may be specified in 'Unix Epoch' time format (number of seconds since midnight Jan
1 1970) or in "yyyy/mm/dd/HH:MM:SS" format. If not specified, the last 100 events will be returned.
6.3.a) Note regarding secure web access:
Configuration and use of 'https' (ie. SSL) is highly recommended as the URL includes the account password
and will be encrypted via 'https', but will be sent in the clear if plain 'http' is used. Instructions for
configuring Tomcat to support SSL can be found on the Apache Tomcat website.
Some examples:
• https://localhost:8080/events/data.csv?a=opendmtp&p=mypass&d=mobile
Return a CSV formatted data file ('data.csv') containing the last 100 event record for the device
'opendmtp'/'mobile'. The data is returned via an http SSL connection. (Note: replace 'mypass' with
the proper password)
• http://localhost:8080/events/data.json?a=demo&p=mypass&d=demo
Return a JSON formatted data file ('data.json') containing the last 100 event record for the device
'demo'/'demo'. (Note: replace 'mypass' with the proper password)
• http://localhost:8080/events/data.kml?a=gts&p=mypass&d=dev&rf=1145776000&rt=1145777000
Return a KML (XML) fomatted data file ('data.kml') with the first 100 events within the specified
range for the device "gts/dev".
• http://localhost:8080/events/data.gpx?a=gts&p=mypass&d=dev&rf=1145776000&rt=1145777000
Return a GPX (XML) fomatted data file ('data.gpx') with the first 100 events within the specified
range for the device "gts/dev" (see "http://www.topografix.com/gpx.asp" for information regarding the
GPX data format).
Google Earth has the capability of automatically polling data from this URL at specified intervals. To
configure Google Earth to read event data points from the server, click on "Add" on the main menu bar, then
select "Network Link". Add the KML retrieval URL to the server and click "Refresh Parameters" to be able to
enter periodic refresh times. To always display the most recent events within Google Earth, omit the date
range option ("rf" and "rt") and instead specify the option "limit" to cause the returned list to always
include the latest set of events.
• http://localhost:8080/events/data.kml?a=gts&p=mypass&d=dev&limit=100
Return a KML (XML) fomatted data file ('data.kml') with the last 100 available events for the
device "gts/dev".
• http://localhost:8080/events/data.kml?a=gts&p=mypass&d=dev&limit=1
Return a KML (XML) fomatted data file ('data.kml') with only the last (most recent) event for the
device "gts/dev".
OpenGTS Configuration and Installation Manual Page 21 of 60
Comentários a estes Manuais