POST /location

Send a location for a device

Resource URL

https://eu.connect-prod.blacklinesafety.com/1/location

Parameters

None

POST Data

device_id required The id of the device.

Example Value: 555

latitude required The latitude (min: -90.0000000, max: 90.0000000).

Example Value: 51.4788678

longitude required The longitude (min: -180.0000000, max: 180.0000000).

Example Value: 0.0106564

altitude optional The altitude in meters from -1000m (min: 0, max: 19480).

Example Value: 3455

heading optional The heading in degrees, referenced clockwise from true North (min: 0, max: 360).

Example Value: 65

speed optional The speed in Km/hr (min: 0, max: 1023)

Example Value: 32

satellite_count optional The satellite count.

Example Value: 4

date optional The date the location occurred in UTC. Must be in format YYYY-MM-DD hh:mm:ss. If no value is specified, then the date this POST was made is used.

Example Values: 2012-02-28 18:08:05

Example Request

POST https://eu.connect-prod.blacklinesafety.com/1/location?access_token=abcd

Request Data

{
    "device_id":555,
    "latitude":51.4788678,
    "longitude":0.0106564,
    "altitude":3455,
    "heading":65,
    "speed":32,
    "satellite_count":4,
    "date":"2012-02-28 18:08:05"
}

Example Response

No response data is sent on a successful POST.