GET /locate/:id

Returns locate request information.

You'll need to retrieve a device location request id from PUT /locate/:id first.

Resource URL

https://connect-portal.blacklinegps.com/1/locate/:id

Parameters

id required The request id from the locate request.

Example Value: 1234

Example Request

GET https://connect-portal.blacklinegps.com/1/locate/1234?access_token=abcd

Example Response

If we're waiting for the device to respond to the locate request:

{
    "status": "sent"
}

If the device has successfully responded with a location:

{
    "type": "gps",
    "position_date":"2012-07-05 18:34:19",
    "latitude":"51.0382660",
    "longitude":"-114.0342112",
    "altitude":1065,
    "heading":0,
    "speed":0,
    "satellite_count":7
}

or,

{
    "type": "gsm",
    "position_date":"2012-07-05 18:34:19",
    "latitude":"51.0382660",
    "longitude":"-114.0342112",
    "altitude":0,
    "timingAdvance": 3,
    "uncertainty": 50
}

If the device cannot determine its current location:

{
    "error":"no_gps_location_timout",
    "error_description":"No GPS Location Timeout"
}