MapQuest Observer

Trace History APIs

GET

Last Values

Resource URL

https://www.mapquestapi.com/daas/v1/trace/lastValues/

Resource Information

Response Formats	GEOJSON, JSON, CSV
Authentication	Yes (Requires Key)
Rate Limited	Yes

Overview

This endpoint returns a limited number of traces from a specified device.

Request Parameters

Request Parameter	Description	Required?
key String	The API Key, which is needed to make requests to MapQuest services.	Yes
deviceid UUID	The advertising identifier associated with the device. Depending on the platform, this value can be the Apple IDFA identifier or the Google Play identifier. Note: Please see example request to see how this request is structured.	Yes
limit Integer	Integer value used to indicated the number of traces requested, if fewer traces exist in the datastore to satisfy this limit then all traces will be returned.	Yes
format String	Optional format of the returned data. Defaults to geojson. geojson json csv	No

Formats

The GeoJSON specification is described here: http://geojson.org/geojson-spec.html

Response

Response Field	Description
id UUID	The advertising identifier associated with the device. Depending on the platform, this value can be the Apple IDFA identifier or the Google Play identifier.
time Long	The UNIX epoch time stamp detailing when the observation was made of the device.
longitude Decimal	The x-coordinate expressed in decimal degrees. Constraint: Values between -180 and 180.
latitude Decimal	The y-coordinate expressed in decimal degrees. Constraint: Values between -90 and 90.
Additional properties can be in the response depending on the device and operating system.

Example Request

Retrieve the last 2 readings from device with id 'AAAAAA-B457-4C89-8363-0940406A0162' in compact json format (as opposed to the default geojson).

GET

https://www.mapquestapi.com/daas/v1/trace/lastValues/AAAAAA-B457-4C89-8363-0940406A0162/2?format=json&key=KEY

Example Response

[
  {
    "type": "FeatureCollection",
    "features": [
      {
        "id": "AAAAAA-B457-4C89-8363-0940406A0162",
        "type": "Feature",
        "properties": {
          "latitude": "36.084072",
          "longitude": "-79.180147",
          "time": "1453849149000"
        },
        "geometry": {
          "type": "Point",
          "coordinates": [
            -79.180147,
            36.084072
          ]
        }
      },
      {
        "id": "AAAAAA-B457-4C89-8363-0940406A0162",
        "type": "Feature",
        "properties": {
          "latitude": "36.084072",
          "longitude": "-79.180147",
          "time": "1453849148000"
        },
        "geometry": {
          "type": "Point",
          "coordinates": [
            -79.180147,
            36.084072
          ]
        }
      }
    ]
  }
]

[
  {
    "id": "AAAAAA-B457-4C89-8363-0940406A0162",
    "time": 1453849149000,
    "properties": {
      "latitude": "36.084072",
      "longitude": "-79.180147"
    }
  },
  {
    "id": "AAAAAA-B457-4C89-8363-0940406A0162",
    "time": 1453849148000,
    "properties": {
      "latitude": "36.084072",
      "longitude": "-79.180147"
    }
  }, ...
]

id,time,latitude,longitude
AAAAAA-B457-4C89-8363-0940406A0162,1453849149000,36.084072,-79.180147
AAAAAA-B457-4C89-8363-0940406A0162,1453849148000,36.084072,-79.180147