Skip to main content

Field Computer - Current Location for One

A Field Computer registers its GPS location every five minutes.

When accessing /FieldComputers/:id/CurrentLocation via GET, the Slingshot API Server will return an XML document that contains the most recent location of the Field Computer identified by {id}.

HTTP Method and URL

GET https://api.ravenslingshot.com/fieldcomputers/{id}/currentlocation

URL Parameters

ParameterDescription
idThe {id} portion of the URI is taken from the XML Document returned by a GET request to the /FieldComputers URI.

HTTP Query Parameters

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

ParameterDescription
pagesize[Optional] Number of rows to return for a result page.
page[Optional] Specific result page to return.

HTTP Headers

To learn more about these parameters, read about Authentication.

HeaderDescription
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

XML

<!--?xml version="1.0"?-->
<slingshotindex xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.ravenslingshot.com/SlingshotIndex/2010">
<totalcount>1</totalcount>
<pagesize>20</pagesize>
<ispreviouspage>false</ispreviouspage>
<isnextpage>false</isnextpage>
<pageindex>0</pageindex>
<totalpages>1</totalpages>
<devicelocation>
<id>114871</id>
<deviceid>9940</deviceid>
<subtype>Field Computer</subtype>
<lat>0</lat>
<lon>0</lon>
<alt>0</alt>
<speed>0</speed>
<direction>0</direction>
<valid>false</valid>
<gpsdatetime>0000-00-00 00:00:00</gpsdatetime>
</devicelocation>
</slingshotindex>

JSON

{
"DeviceLocation": [
{
"ID": "114871",
"DeviceId": "9940",
"SubType": "Field Computer",
"Lat": 0,
"Lon": 0,
"Alt": 0,
"Speed": 0,
"Direction": 0,
"Valid": false,
"GPSDateTime": "0000-00-00 00:00:00"
}
],
"TotalCount": 1,
"PageSize": 20,
"IsPreviousPage": false,
"IsNextPage": false,
"PageIndex": 0,
"TotalPages": 1
}