API Endpoints

gll

The gll endpoint is used to retrieve or save large numbers of points in a single API call. The gll endpoint supports GET and POST methods used to retrieve glls or save glls respectively.

GET

Method	Description
/me/gll?limit=10	return 10 entries for the authenticated user
/me/gll&until=2011-01-02T14:01:00.0&limit=100	return entries from now until date specified or 100, whichever is less for the authenticated user
/me/gll&since=2011-01-02T14:01:00.0&limit=10	return 10 entries starting from since and earlier for the authenticated user
/me/gll&since=2011-01-03T14:01:00.0&until=2011-01-01T14:01:00.0&limit=20	return 20 entries between since and until

Example1: GET Glls Example

GET http://api.hipgeo.com/me/gll?access_token=TOKENVALUE

Returns:
{
  "count":20,
  "data":[
    {
      "id":"g_4133557",
      "lat":33.871095,
      "lon":-117.924089,
      "alt":51.1287,
      "hacc":5,
      "vacc":9.5,
      "vel":0,
      "when":"2011-09-20 04:57:21.487"
    },

== some entries removed ==

    {
      "id":"g_4133092",
      "lat":33.871095,
      "lon":-117.924089,
      "alt":52.19843,
      "hacc":5,
      "vacc":9.5,
      "vel":0,
      "when":"2011-09-20 03:49:08.732"
    }
  ],
  "result":"success"
} 

Error Code	Possible Errors
400	Requires an ID
401	Authentication failed Token expired Insufficient Permissions
404	ID not found

POST

A gll is a set of data that describes a user's position, velocity, bearing and other information at a particular time. These entries are typically grouped to reduce upload overhead for the device and the server. The following fields are required for each gll. Additional fields shown below are highly recommended and aid in creating journal entries, but not required:

• when
• lat
• lon
• alt
• hacc

Gll's with a hacc of greater than or equal to 10000 are considered to be 'status only'. The lat, lon, vel, alt, and vacc are considered invalid and ignored if they are specified at all. This allows the client to send status without a valid location.

Method	Desciption
/me/gll	Save list of glls (see example below)

Example2: POST me/gll

POST http://api.hipgeo.com/me/gll?access_token=TOKENVALUE

Data:
    [
      { "lat":23.1243, "lon":123.23, "hacc":2, "alt":23, "vel":9.8, "when":"2010-09-06T16:07:44.0000", "bat":34.0 },
      { "lat":23.1300, "lon":123.23, "hacc":3.4, "alt":29.3, "vel":4.8, "when":"2010-09-06T16:08:44.0000", "bat":34.0 }
    ]

Returns:
{
  "count":2,
  "duplicates":0,
  "result":"success"
} 

Error Code	Possible Errors
400	Requires an ID Unable to parse data
401	Authentication failed Token expired Insufficient Permissions 'me' requires authentication
404	ID not found