Tracking: Storing positions

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

Target URL

The web service to call to store positions is available at: https://api.geoconcept.com/GEOLOC/record
Call this web service through a POST 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
Content-Type: application/json
Accept: application/json

Request body

The body of the request should contain a JSON object defining a list of positions for a given equipment external reference, such as:

{
  "positions" : [ {
    "lon" : 3.844786,
    "lat" : 43.612738,
    "speed" : 17.0,
    "heading" : 0.0,
    "batteryLevel" : 0.0,
    "status" : 0,
    "flags" : 4,
    "positionMethod" : 0,
    "accuracy" : 90.0,
    "time" : 1543406160000,
    "privateMode" : false
  } ],
  "extRef" : "GPS2"
}

Response codes

201: The positions were created and added
200: A positions record already existed with same timestamp and were ignored

Response body

In case of error, the response contains an explanation in a JSON object such as:

{
  "status" : "ERROR",
  "message" : "..."
}