Gll Object

A gll object is a Geographic Latitude and Longitude that represents a single geospatial position or "fix" for a user at a specific time. In addition to latitude, longitude and time, horizontal accuracy and altitude are required to allow HipGeo's collection algorithms to use the point appropriately.

Velocity, vertical accuracy and course (bearing) information are also highly recommended if they are available. The more information that is supplied, the better the fix can be used to determine the activity the point represents.

Gll's with a horizontal accuracy (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.

Gll objects support only the GET method.

GET Gll Object Example

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

Returns:
{
  "gll":{
    "id":"g_619266",
    "lat":33.884899,
    "lon":-117.940002,
    "alt":36.1283,
    "hacc":10,
    "vacc":19,
    "vel":0,
    "when":"2011-03-05 02:05:56.674000",
    "did":2,
    "dstate":513,
    "course":-1,
    "batt":80,
    "info":"31.0,0.0,SLCFull,008",
    "ver":"8"
  },
  "result":"success"
} 

did definition

did
  bit 31 unused
  bits 16-30 device specific hash(1)
  bits 8-15 device type
    0 = iphone
    1 = android
  bit 0-7 subdevice information
    iphone
    1 = iphone3
    2 = iphone4/att
    3 = iphone4/verizon
    android
    [tbd]

(1) 15 bit hash (0-32767) of least significant digits of devices identifier\
      (e.g. UDID)

dstate definition

dstate (iphone specific)
  bit 31 unused
  bits 24-30 future
  bits 16-23 signal (handset connectivity)
    bit 0 unknown
    bit 1 cell tower
    bit 2 wifi
    bit 3 gps
    bit 4-7 undefined
  bits 12-15 upld (reason for GLL upload)
    0=undefined
    1=normal update
    2=runout (non-motion timeout reached)
    3=demand (gll required as a result of user interaction 
         (e.g. photo or comment upload)
    4=gll engine stopping
    5=gll engine starting
  bits 8-11 estat (GLL engine state)
    0=undefined
    1=init
    2=Starting
    3=started
    4=stopping
    5=stopped
    6=waiting for trigger
    7=waiting for SLC
    8=Honing GPS
    9=FULL ON
  bits 4-7 astat (application state)
    0=UNDEFINED
    1=forground
    2=foreground sleep
    3=background
  bits 0-3 eid (gll engine ID)
    1=IDLE engine
    2=FULL ON engine
    3=SLC engine