GPS Data Web Service API

Application Integration

Getting to your data

Getting your GPS tracking data out of the web service is as easy as fetching a web page - or making an HTTP request programmatically in your programming language of choice.

Editing your data

Editing the data is conceptually simple: first make a GET request to retrieve a data object, then change the properties on the object, and PUT it back to the same URL you retrieved it from. It's a good idea to change only those properties you wish to edit, and leave any additional ones intact. In that way, newly available properties that your program doesn't expect can be preserved.

Web Application Integration

HTTP Proxy + JavaScript

To enable web-based applications to take full advantage of the GPS data web service, we have added a few features that make JavaScript integration particularly easy.

One way to access the service is to dedicate a portion of your URL space as a proxy to the gink webservice. This makes it possible to make Ajax Requests directly via your proxy URL. For example, you could create a folder gink-ws containing the following files on the Apache webserver, with mod_rewrite, mod_proxy and mod_proxy_http enabled:

.htaccess
allows your application to access the gink webservice via its own URL:
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule .* http://mygink.com/rest/v2/$0 [P]
jquery.js
the excellent jQuery library, required by gink.js for Ajax requests, this must precede gink.js.
json2.min.js
Douglas Crockford's JSON library, required by gink.js to serialize JSON objects when making PUT or POST requests (download full or minified)
gink.js
creates a single object, gink, in the global namespace, with methods get, post, put, del and gateway. Includes logic to resolve the relative URLs from the web service to your proxy URL, as well as optional console logging and turning caching on/off. (download)

PHP

Another way to access the webservice is via your favorite programming language's HTTP library. There is a sample GinkClient class programmed in PHP (requires cURL), and a sample script available here.

iframe embed

It is possible to embed the entire Infleet Portal in an iframe, for example on your own Intranet, using the webservice. An example using Apache and PHP is available here.