SAP Sailing Analytics Webservices API Version 1.0

URL: /api/v1/gps_fixes

Description:

Adds an arbitrary number GPS-fixes that originated from a device with a universally unique identifier (UUID, all types accepted) to the GPSFixStore. These can be mapped to a competitor or a mark via the DeviceMappings in the RaceLog-Tracking connector.


Note that the "speed" field is provided in meters per second (m/s). The course is the course over ground (COG) in true degrees. The "hdt" field is optional and may be used to represent a true (not magnetic) heading in degrees. Note how this is different from "hdg" which can be used instead of "hdt" to specify a magnetic heading in degrees. The magnetic declination at time and location of the fix will be used then to convert this internally to a true heading.
Webservice Type: REST
Input format: JSON (application/json)
Output format: HTTP 200
Mandatory parameters: None
Optional parameters: returnManeuverUpdate (boolean, default false): if true, a list of races, identified by regatta name and race name, will be returned as a response document that shows those races for which the fix(es) was/were mapped to a competitor for which the maneuver list changed since the last such request. Example output:
		{
		  "maneuverchanged": [
		    {
		      "regattaName": "Ddd",
		      "raceName": "R3",
		      "maneuverChanged": false,
		      "liveDelayInMillis": 5000
		    },
		    {
		      "regattaName": "Ddd",
		      "raceName": "R1",
		      "maneuverChanged": false,
		      "liveDelayInMillis": 5000
		    }
		  ]
		}

returnLiveDelay (boolean, default false): if true, a list of races, identified by regatta name and race name, will be returned as a response document, showing for each race to which the fix was mapped what the race's live delay is in milliseconds. Note that this can be combined with returnManeuverUpdate. For example output see above.
Request method: POST
Example: POST http://www.sapsailing.com/sailingserver/api/v1/gps_fixes 

{
  "deviceUuid" : "af855a56-9726-4a9c-a77e-da955bd289bf",
  "fixes" : [
    {
      "timestamp" : 14144160080000,
      "latitude" : 54.325246,
      "longitude" : 10.148556,
      "speed" : 3.61,
      "course" : 258.11,
      "hdt" : 259.0
    },
    {
      "timestamp" : 14144168490000,
      "latitude" : 55.12456,
      "longitude" : 8.03456,
      "speed" : 5.1,
      "course" : 14.2,
      "hdt" : 14.7
    }
  ]
}
Back to Web Service Overview