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