GET
/machines/{id}/locationHistory
Machine Location History
Become a beta tester for MachineMonitoring resources.
GET /machines /{id} /locationHistory
Machine Location History
The machine location service allows the client to view a list of location reports for a machine. A location report will include the machine's longitude, latitude, and altitude. For each location report, the response will link to the /machines resource.
 
Request URI
GET https://apicert.soa-proxy.deere.com/platform/machines/{id}/locationHistory
Accept: application/vnd.deere.axiom.v3+xml OR application/vnd.deere.axiom.v3+json
 
Request Parameters
Parameter Type Example Description Default Required?
lastKnown boolean false Includes the last known machine location. N/A No.
startDate dateTime 2010-10-04T14:35:05.000Z Retrieves results that occurred after a specified date. The format is in the ISO 8601 Standard. N/A No.
endDate dateTime 2010-10-04T14:38:35.000Z Retrieves results that occurred before a specified date. The format is in the ISO 8601 Standard. N/A No.
 
Response Details
Field Type Example Description
point N/A N/A Contains the <lat>, <lon>, and <altitude> tags.
lat double 41.688612 The latitude of the machine's location.
lon double -93.693612 The longitude of the machine's location.
altitude measurement AsDouble See sample response below. The altitude of the machine's location. The value and unit of measurement are both included.
event TimeStamp dateTime 2012-11-07T18:42:07.186Z Timestamp of the machine location report. All timestamps follow the ISO 8601 standard format.
gpsFixTimestamp dateTime 2010-10-04T15:06:24.000Z The last time the machine noted its GPS location.
 
Sample Response [JSON]
GET https://apicert.soa-proxy.deere.com/platform/machines/4321/locationHistory
200 OK
Content-Type: application/vnd.deere.axiom.v3+json;charset=UTF-8

{
   "links": [
      {
         "rel": "self",
         "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321/locationHistory"
      },
      {
         "rel": "nextPage",
         "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321/locationHistory;start=10;count=10"
      }
   ],
   "total": 2,
   "values": [
      {
         "point": {
            "lat": 41.597164,
            "lon": -90.54383,
            "altitude": {
               "@type": "measurementAsDouble",
               "valueAsDouble": 0,
               "links": null,
               "unit": "meters"
            },
            "links": null
         },
         "eventTimestamp": "2010-10-20T22:32:16.000Z",
         "gpsFixTimestamp": "1970-01-01T00:00:00.000Z",
         "links": [
            {
               "rel": "machine",
               "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321"
            }
         ]
      },
      {
         "point": {
            "lat": 41.597305,
            "lon": -90.543884,
            "altitude": {
               "@type": "measurementAsDouble",
               "valueAsDouble": 0,
               "links": null,
               "unit": "meters"
            },
            "links": null
         },
         "eventTimestamp": "2010-10-04T15:06:34.000Z",
         "gpsFixTimestamp": "2010-10-04T15:06:24.000Z",
         "links": [
            {
               "rel": "machine",
               "uri": "https://apicert.soa-proxy.deere.com/platform/machines/4321"
            }
         ]
      }
   ]
}