*/ranks, ranking and results

API with live ranking and results corresponding to splits and to calculations in the leaderboard

Read all about the data processing in the leaderboard:

pageLeaderboard

Request

URL https://racemap.com/api/data/v1/:eventId/ranks Method GET

Live sample https://racemap.com/api/data/v1/61a21210e5d45d000199f7d9/ranks corresponding leaderboard https://racemap.com/timing/100KmDuathlon2018_Repeat

Past sample https://racemap.com/api/data/v1/60a3b443f096f800018add7c/ranks corresponding leaderboard https://racemap.com/timing/sample-event-100km-duathlon_2020

Response

Event object

Field	Description [unit]	Sample
name	Name of event	"Sample | 100km Duathlon"
location	Location	"🇩🇪 Dresden"
startTime	Start time in UTC	"2020-04-25T06:00:00.000Z"
endTime	End time in UTC	"2020-10-30T18:15:00.000Z"
timekeepings	Array for split objects
starters	Array for participant objects

Split object

Field	Description [unit]	Sample
name	Name of split	"Finish"
offset	Distance [m] along the shadowtrack​	100262.4279943064
position	Array with longitude, latitude, altitude [m]	13.704038205094022, 51.02687962934201, 166
id	Unique Racemap ID of split	"64513872c3ab09659eb09683"

Participant object

Field	Description [unit]	Sample
id	Unique Racemap ID of participant	"60a3b67914742230d14a5bf4"
name	Name	"Porstmann"
startNumber	Bib number	"18"
tags	Object with optional attributes to filter participants eg. age group or nation, format "tag": "value"	"age": "40-49", "sex": "mal", "club": "VfA end"
markerColor	Color of dot in tracking map, hex code	"#ffffff"
importId	User-defined ID with imported participant data, Generic API (importId) or RACE|RESULT API (Id)	"UniqueImportId_18" or "null" if no importId exists
rank	Rank	1
state		DSQ, DNS, DNF or null
online	Indicator: coordinates received within last 60 s	true or false
progress	Current distance [m] or current duration [ms]	100310 or null if no locations within startTime and endTime
currentDuration	Total duration [ms] to reach finish	14697500 or null if no locations within startTime and endTime
activeDuration	Duration [ms], movement with speed > 1 km/h, within start- and end time of event	10965700 or null if no locations within startTime and endTime
results	Array for objects with the result for each split	null if split without result

Result object

Field	Description [unit]	Sample
id	Unique Racemap ID of split	"64513872c3ab09659eb09683"
time	Time in UTC	"2020-04-25T12:10:13Z"
relativeProgress	Duration [ms] or distance [m] from first split	22213000
relativeDeltaProgress	Duration [ms] or distance [m] from split before	6974608

{
  "name": "Sample | 100km Duathlon",
  "location": "🇩🇪 Dresden",
  "startTime": "2020-04-25T06:00:00Z",
  "endTime": "2020-10-30T18:15:00Z",
  "timekeepings": [
    {
      "name": "Start",
      "offset": 0,
      "position": [13.704069467101244, 51.027617808548015, 159],
      "id": "64513872c3ab09659eb09674"
    },
    {
      "name": "Ruppendorf",
      "offset": 29513.002967649845,
      "position": [13.599722542890463, 50.90910508578093, 377],
      "id": "64513873368d2f24f3a5feb9"
    },
    {
      "name": "🕖",
      "offset": 48125.51853411951,
      "position": [13.633563734472718, 50.77911506210913, 570],
      "id": "64513873a2c6e28dbe010405"
    },
    {
      "name": "Bergwertung",
      "offset": 49950.82522183896,
      "position": [13.623273503927214, 50.76995405256768, 743],
      "id": "64513874c3ab09659eb096b5"
    },
    {
      "name": "🕖",
      "offset": 67658.33026919093,
      "position": [13.69125, 50.82612, 471],
      "id": "645138746451816d07b38788"
    },
    {
      "name": "Bergwertung",
      "offset": 68781.263669599,
      "position": [13.697525647974045, 50.83382486871975, 603],
      "id": "6451387410e583b28d7167e6"
    },
    {
      "name": "Finish",
      "offset": 100262.4279943064,
      "position": [13.704038205094022, 51.02687962934201, 166],
      "id": "64513872c3ab09659eb09683"
    }
  ],
  "starters": [
    {
      "id": "60a3b67914742230ef4a5be2",
      "name": "Leupold",
      "startNumber": "03",
      "tags": {
        "sex": "mal",
        "club": "VfA end",
        "age": "40-49"
      },
      "markerColor": "#ffffff",
      "importId": "UniqueImportId_3",
      "rank": 7,
      "state": null,
      "online": false,
      "progress": 100262.4279943064,
      "currentDuration": 18030000,
      "activeDuration": 17410000,
      "results": [
        {
          "id": "64513872c3ab09659eb09674",
          "time": "2020-04-25T06:00:00Z",
          "relativeProgress": 0,
          "relativeDeltaProgress": 0
        },
        {
          "id": "64513873368d2f24f3a5feb9",
          "time": "2020-04-25T07:48:58.564Z",
          "relativeProgress": 6538564,
          "relativeDeltaProgress": 6538564
        },
        {
          "id": "64513873a2c6e28dbe010405",
          "time": "2020-04-25T08:57:42.140Z",
          "relativeProgress": 10662140,
          "relativeDeltaProgress": 4123576
        },
        {
          "id": "64513874c3ab09659eb096b5",
          "time": "2020-04-25T09:04:26.535Z",
          "relativeProgress": 11066535,
          "relativeDeltaProgress": 404395
        },
        {
          "id": "645138746451816d07b38788",
          "time": "2020-04-25T10:09:49.607Z",
          "relativeProgress": 14989607,
          "relativeDeltaProgress": 3923072
        },
        {
          "id": "6451387410e583b28d7167e6",
          "time": "2020-04-25T10:13:58.392Z",
          "relativeProgress": 15238392,
          "relativeDeltaProgress": 248785
        },
        {
          "id": "64513872c3ab09659eb09683",
          "time": "2020-04-25T12:10:13Z",
          "relativeProgress": 22213000,
          "relativeDeltaProgress": 6974608
        }
      ]
    },
    {
      "id": "60a3b67914742223014a5bea",
      "name": "Michi",
      "startNumber": "11",
      "tags": {
        "sex": "mal",
        "age": "30-39",
        "club": "Flaming Sideburns"
      },
      "markerColor": "#ffffff",
      "importId": "UniqueImportId_11",
      "rank": 11,
      "state": null,
      "online": false,
      "progress": 100262.4279943064,
      "currentDuration": 23430000,
      "activeDuration": 21700000,
      "results": [
        {
          "id": "64513872c3ab09659eb09674",
          "time": "2020-05-02T06:06:00Z",
          "relativeProgress": 0,
          "relativeDeltaProgress": 0
        },
        {
          "id": "64513873368d2f24f3a5feb9",
          "time": "2020-05-02T08:07:19Z",
          "relativeProgress": 7279000,
          "relativeDeltaProgress": 7279000
        },
        {
          "id": "64513873a2c6e28dbe010405",
          "time": "2020-05-02T09:14:27.931Z",
          "relativeProgress": 11307931,
          "relativeDeltaProgress": 4028931
        },
        {
          "id": "64513874c3ab09659eb096b5",
          "time": "2020-05-02T09:26:40.137Z",
          "relativeProgress": 12040137,
          "relativeDeltaProgress": 732206
        },
        {
          "id": "645138746451816d07b38788",
          "time": "2020-05-02T10:33:39.165Z",
          "relativeProgress": 16059165,
          "relativeDeltaProgress": 4019028
        },
        {
          "id": "6451387410e583b28d7167e6",
          "time": "2020-05-02T10:41:37.087Z",
          "relativeProgress": 16537087,
          "relativeDeltaProgress": 477922
        },
        {
          "id": "64513872c3ab09659eb09683",
          "time": "2020-05-02T12:33:50.567Z",
          "relativeProgress": 23270567,
          "relativeDeltaProgress": 6733480
        }
      ]
    },
    {
      "id": "60a3b679147422101b4a5be3",
      "name": " KRad",
      "startNumber": "04",
      "tags": {
        "sex": "mal",
        "club": "VfA end",
        "age": "30-39"
      },
      "markerColor": "#ffffff",
      "importId": "UniqueImportId_4",
      "rank": 16,
      "state": null,
      "online": false,
      "progress": 100262.4279943064,
      "currentDuration": 23310000,
      "activeDuration": 21225000,
      "results": [null, null, null, null, null, null, null]
    }
  ]
}