wiki:api_history

Get Location History

This method returns history for the device specified by device_id(returned from /dev/api/devices/)

Path: /dev/api/history/

Parameters

  • api_key (required)
  • device_id (required)
  • start (required)
  • end (required)
  • output (optional)

start and end are the Start and End Date for the location history. The format for the date is:

MM/DD/YYYY HH:MM:SS

09/09/2008 00:00:00

All dates should be in UTC time zone.

Note: The maximum number of locations returned is 500. If there are more locations than 500 in the history, you must paginate it by using a smaller date interval.

Example Request(json output)

 http://moostrax.com/dev/api/history/?start=09/01/2008 00:00:00&end=10/31/2008 00:00:00&api_key=myapikey&device_id=2340&output=json

{"status": "ok", "response": {"locations": ["location", {"altitude": 354.0, "longitude": -108.950364, "date": "2008-10-30 23:59:37", "latitude": 30.438396, "accuracy": 2.12, "speed": 0.18, "heading": 323.0475, "device_id": "2340"}, {"altitude": 354.0, "longitude": -108.950364, "date": "2008-10-30 23:59:37", "latitude": 30.438396, "accuracy": 2.12, "speed": 0.18, "heading": 323.0475, "device_id": "2340"}, {"altitude": 354.0, "longitude": -108.950364, "date": "2008-10-30 23:59:37", "latitude": 30.438396, "accuracy": 2.12, "speed": 0.18, "heading": 323.0475, "device_id": "2340"}, {"altitude": 354.0, "longitude": -108.950364, "date": "2008-10-30 23:59:37", "latitude": 30.438396, "accuracy": 2.12, "speed": 0.18, "heading": 323.0475, "device_id": "2340"}, {"altitude": 354.0, "longitude": -108.950364, "date": "2008-10-30 23:59:37", "latitude": 30.438396, "accuracy": 2.12, "speed": 0.18, "heading": 323.0475, "device_id": "2340"}]}}

Example Request(xml output)

 http://moostrax.com/dev/api/history/?start=09/01/2008 00:00:00&end=10/31/2008 00:00:00&api_key=myapikey&device_id=2340

<?xml version="1.0" ?>
<moostrax><status>ok</status><response><locations><location><altitude>354.00000</altitude><longitude>-108.95036</longitude><date>2008-10-30 23:59:37</date><latitude>30.43840</latitude><accuracy>2.12000</accuracy><speed>0.18000</speed><heading>323.04750</heading><device_id>2340</device_id></location><location><altitude>354.00000</altitude><longitude>-108.95036</longitude><date>2008-10-30 23:59:37</date><latitude>30.43840</latitude><accuracy>2.12000</accuracy><speed>0.18000</speed><heading>323.04750</heading><device_id>2340</device_id></location><location><altitude>354.00000</altitude><longitude>-108.95036</longitude><date>2008-10-30 23:59:37</date><latitude>30.43840</latitude><accuracy>2.12000</accuracy><speed>0.18000</speed><heading>323.04750</heading><device_id>2340</device_id></location><location><altitude>354.00000</altitude><longitude>-108.95036</longitude><date>2008-10-30 23:59:37</date><latitude>30.43840</latitude><accuracy>2.12000</accuracy><speed>0.18000</speed><heading>323.04750</heading><device_id>2340</device_id></location><location><altitude>354.00000</altitude><longitude>-108.95036</longitude><date>2008-10-30 23:59:37</date><latitude>30.43840</latitude><accuracy>2.12000</accuracy><speed>0.18000</speed><heading>323.04750</heading><device_id>2340</device_id></location></locations></response></moostrax>