Tracking: Retrieving positions

The Nomadia software positions storage component can be addressed through its web services.

Target URL

The web service to call to retrieve positions is available at: https://api.geoconcept.com/GEOLOC/position/betweenDates
Call this web service through a GET method.

Request headers

The authentication is achieved through the following HTTP headers:

appkey: your application key to authenticate on the positions server
apptoken: your application token to authenticate on the positions server

Request parameters

The request should contain some URL parameters to define the filter for the desired positions:

extRef: the equipment external reference
from: the UTC time for starting the time range
to: the UTC time for ending the time range

https://api.geoconcept.com/GEOLOC/position/betweenDates?extRef=GPS2&from=2019-08-20T11:00:00.000Z&to=2019-08-20T12:59:59.999Z

Response codes

200: A list of positions was successfully returned

Response body

The response contains a JSON object describing the list of positions such as:

{
    "status": "OK",
    "result": {
        "positions": [
            {
                "lon": -76.1663577,
                "lat": 44.3258816,
                "speed": -1,
                "heading": -1,
                "batteryLevel": 0.94,
                "status": 0,
                "flags": 0,
                "positionMethod": 0,
                "accuracy": 15,
                "time": 1566304313823,
                "privateMode": false
            },
            {
                "lon": -75.5552621,
                "lat": 44.7119333,
                "speed": 35.04,
                "heading": 44,
                "batteryLevel": 0.35,
                "status": 0,
                "flags": 0,
                "positionMethod": 0,
                "accuracy": 48,
                "time": 1566319731999,
                "privateMode": false
            }
        ],
        "extRef": "GPS2"
    }
}