HipGeo Objects

Travel Object

A travel object is a collection of points between two locations. It can describe the route taken by a user in detail, may contain only a few points, or may be empty (no points).

Travel objects support only the GET method.

Example: /TRAVELID - travel object

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

Returns:
{
  "travel":{
    "id":"t_15227",
    "shareable":1,
    "canmerge":0,
    "uid":"u_214",
    "beginname":"Chino Hills, CA",
    "endname":"Diamond Bar, CA",
    "duration":712,
    "duration_sec":712,
    "distance":10756.5,
    "hidestats":0,
    "type":2,
    "starttime":"2011-03-30 03:07:21.1",
    "endtime":"2011-03-30 03:19:12.999999",
    "startcoord":{
      "lat":34.014133,
      "lon":-117.743378,
      "alt":"258.872009277344"
    },
    "endcoord":{
      "lat":33.993351,
      "lon":-117.816841,
      "alt":"281.411010742188"
    },
    "gll_count":24,
    "jid":"j_14047",
    "mapdata":{
      "markers":[
        {
          "type":0,
          "label":"A",
          "points":[
            [
              34.014133,
              -117.743378,
              "1301454441000001"
            ]
          ]
        },
        {
          "type":0,
          "label":"B",
          "points":[
            [
              33.993351,
              -117.816841,
              "1301455152999999"
            ]
          ]
        }
      ],
      "lines":[
        {
          "type":0,
          "points":[
            [
              34.014133,
              -117.743378,
              "1301454441000001"
            ],
            [
              34.014198,
              -117.742996,
              "1301454442000421"
            ],

== Some Entries Removed ==

            [
              33.993198,
              -117.817101,
              "1301455152000765"
            ],
            [
              33.993351,
              -117.816841,
              "1301455152999999"
            ]
          ]
        }
      ],
      "circles":[
        
      ],
      "zoom":null,
      "center":null
    }
  },
  "result":"success"
} 
Error Code Possible Errors
400
  1. Requires an ID
401
  1. Authentication failed
  2. Token expired
  3. Insufficient Permissions
404
  1. ID not found
HipGeo Icon