Ask or search…
K
Links

*/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:

Request

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

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]
}
]
}