Field Hub - Location History

A Field Hub reports its GPS location to the server every 30 seconds. When accessing /FieldHubs/:id/Locations via GET, the Slingshot API Server will return a document that contains all the locations that have been registered for the Field Hub identified by {id} in descending order.

When supplying a date, we will return all results from the date supplied until the end of the calendar month of the date supplied.

HTTP Method and URL

GET https://api.ravenslingshot.com/fieldhubs/{id}/locations

URL Parameters

Parameter	Description
id	The {id} portion of the URI is taken from the XML Document returned by a GET request to the /FieldHub URI.

HTTP Query Parameters

To learn more about these parameters, read about Result Set Paging.

Parameter	Description
pagesize	[Optional] Number of rows to return for a result page.
page	[Optional] Specific result page to return.
date	[Optional] Date in ISO8601 format. (Example: 2022-02-28 19:00:000).

HTTP Headers

To learn more about these parameters, read about Authentication.

Header	Description
X-SS-AccessKey	[Required] Token issued to a Slingshot user from the Raven Slingshot Portal Server.
X-SS-APIKey	[Required] Token issued to the Slingshot developer from Raven.
X-SS-Signature	[Required] The signature generated for a specific request.
X-SS-TimeStamp	[Required] The timestamp of when the request was generated.

Sample Responses

JSON

{
	"DeviceLocation": [
		{
			"ID": "249329823",
			"DeviceId": "352974026203117",
			"SubType": "Field Hub",
			"Lat": 43.550893333333,
			"Lon": -96.724844333333,
			"Alt": 454,
			"Speed": 0,
			"Direction": 0,
			"Valid": false,
			"GPSDateTime": "2013-05-06T17:20:01Z"
		}
	],
	"TotalCount": 1,
	"PageSize": 20,
	"IsPreviousPage": false,
	"IsNextPage": false,
	"PageIndex": 0,
	"TotalPages": 1
}