GET devices/{deviceId}/locationhistory?date={date}

Returns a list of device's coordinates.

Remarks

C4M Error Code returned:

  • null

    Location History returned successfully.

  • DeviceNotFound

    The requested device does not exist on this environment.

HTTP Status returned:
  • 403 - Forbidden

    The authenticated user doesn't have permission to access the resource.

Request Information

Parameters

NameDescriptionAdditional information
deviceId
The device's identifier.

Define this parameter in the request URI.

date
The date for the location history.

Define this parameter in the request URI.

Response Information

Operation result.

Response body formats

application/json, text/json

Sample:
[
  {
    "receivedDate": "2020-05-15T17:03:27.6960553-03:00",
    "accuracy": 1.1,
    "altitude": 1.1,
    "bearing": 1.1,
    "coordinate": {
      "latitude": 1.0,
      "longitude": 2.0
    },
    "deviceDate": {
      "date": "2020-05-15T17:03:27.6960553-03:00",
      "timeZoneId": "E. South America Standard Time",
      "utcOffset": -180
    },
    "speed": 1.1
  },
  {
    "receivedDate": "2020-05-15T17:03:27.6960553-03:00",
    "accuracy": 1.1,
    "altitude": 1.1,
    "bearing": 1.1,
    "coordinate": {
      "latitude": 1.0,
      "longitude": 2.0
    },
    "deviceDate": {
      "date": "2020-05-15T17:03:27.6960553-03:00",
      "timeZoneId": "E. South America Standard Time",
      "utcOffset": -180
    },
    "speed": 1.1
  }
]