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
Parameter | Description |
---|---|
id | The {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.
Parameter | Description |
---|---|
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.
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
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
}