*/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
100314.54
id
Unique Racemap ID of split
"_muwe600tp"
position
Array with longitude, latitude, altitude [m]
13.704065646, 51.027126995, 164

Participant object

Field
Description [unit]
Sample
id
Unique Racemap ID of participant
"60a3b67914742230d14a5bf4"
importId
User-defined ID with imported participant data, Generic API (importId) or RACE|RESULT API (Id)
"UniqueImportId_18" or "null" if no importId exists
name
Name
"Porstmann"
startNumber
Bib number
"18"
currentDuration
Total duration [ms] to reach finish
14697500 or null if no locations within startTime and endTime
rank
Rank
1
state
DSQ, DNS, DNF or null
progress
Current distance [m] or current duration [ms]
100310 or null if no locations within startTime and endTime
results
Array for objects with the result for each split
null if split without result
online
Indicator: coordinates received within last 60 s
true or false

Result object

Field
Description [unit]
Sample
id
Unique Racemap ID of split
"_muwe600tp"
time
UNIX time of result
1588417161434.7778
relativeProgress
Duration [ms] or distance [m] from first split
19171434.7779
relativeDeltaProgress
Duration [ms] or distance [m] from split before
4342361.8762
1
{
2
"name": "Sample | 100km Duathlon",
3
"location": "🇩🇪 Dresden",
4
"startTime": "2020-04-25T06:00:00.000Z",
5
"endTime": "2020-10-30T18:15:00.000Z",
6
"timekeepings": [
7
{
8
"name": "Start",
9
"offset": 0,
10
"id": "_t9kp7roge",
11
"position": [13.704099056608415, 51.02740202001082, 161]
12
},
13
{
14
"name": "Ruppendorf",
15
"offset": 29537.54225429863,
16
"id": "_l7z9ygc3f",
17
"position": [13.599722542890463, 50.90910508578093, 377]
18
},
19
{
20
"name": "🕖",
21
"offset": 48150.0578207683,
22
"id": "_xdbst6t0c",
23
"position": [13.633563734472718, 50.77911506210913, 570]
24
},
25
{
26
"name": "Bergwertung",
27
"offset": 49975.36450848775,
28
"id": "_b31s55hd3",
29
"position": [13.623273503927214, 50.76995405256768, 743]
30
},
31
{
32
"name": "🕖",
33
"offset": 67682.86955583973,
34
"id": "_a218n2064",
35
"position": [13.69125, 50.82612, 471]
36
},
37
{
38
"name": "Bergwertung",
39
"offset": 68805.80295624779,
40
"id": "_l542jdzag",
41
"position": [13.697525647974043, 50.83382486871975, 603]
42
},
43
{
44
"name": "Finish",
45
"offset": 100314.53696696438,
46
"id": "_muwe600tp",
47
"position": [13.704065646340139, 51.0271269953974, 164]
48
}
49
],
50
"starters": [
51
{
52
"id": "60a3b67914742230ef4a5be2",
53
"importId": "UniqueImportId_3",
54
"name": "Leupold",
55
"startNumber": "03",
56
"currentDuration": 25930000,
57
"rank": 7,
58
"state": null,
59
"progress": 100314.53696696438,
60
"results": [
61
{
62
"id": "start",
63
"relativeProgress": null
64
},
65
{
66
"id": "_t9kp7roge",
67
"relativeProgress": 0
68
},
69
{
70
"id": "_l7z9ygc3f",
71
"relativeProgress": 6540601.6508934125
72
},
73
{
74
"id": "_xdbst6t0c",
75
"relativeProgress": 10662036.298138456
76
},
77
{
78
"id": "_b31s55hd3",
79
"relativeProgress": 11066220.364378672
80
},
81
{
82
"id": "_a218n2064",
83
"relativeProgress": 14987255.356010677
84
},
85
{
86
"id": "_l542jdzag",
87
"relativeProgress": 15235910.440083671
88
},
89
{
90
"id": "_muwe600tp",
91
"relativeProgress": 22213000
92
}
93
],
94
"online": false
95
},
96
{
97
"id": "60a3b679147422b72a4a5be0",
98
"importId": "UniqueImportId_2",
99
"name": "Jörg",
100
"startNumber": "02",
101
"currentDuration": 27850000,
102
"rank": 11,
103
"state": null,
104
"progress": 100310,
105
"results": [
106
{
107
"id": "start",
108
"relativeProgress": 94805000,
109
"time": 1587889205000
110
},
111
{
112
"id": "_t9kp7roge",
113
"time": 1587889205000,
114
"relativeProgress": 0
115
},
116
{
117
"id": "_l7z9ygc3f",
118
"time": 1587896387754.2253,
119
"relativeProgress": 7182754.225429863,
120
"relativeDeltaProgress": 7182754.225429863
121
},
122
{
123
"id": "_xdbst6t0c",
124
"time": 1587900643342.9702,
125
"relativeProgress": 11438342.97012805,
126
"relativeDeltaProgress": 4255588.744698187
127
},
128
{
129
"id": "_b31s55hd3",
130
"time": 1587901268841.1272,
131
"relativeProgress": 12063841.127121937,
132
"relativeDeltaProgress": 625498.1569938865
133
},
134
{
135
"id": "_a218n2064",
136
"time": 1587906033217.389,
137
"relativeProgress": 16828217.388959933,
138
"relativeDeltaProgress": 4764376.261837997
139
},
140
{
141
"id": "_l542jdzag",
142
"time": 1587906528950.739,
143
"relativeProgress": 17323950.739061948,
144
"relativeDeltaProgress": 495733.35010201484
145
},
146
{
147
"id": "_muwe600tp",
148
"time": 1587912621089.567,
149
"relativeProgress": 23416089.566789005,
150
"relativeDeltaProgress": 6092138.827727057
151
}
152
],
153
"online": false
154
},
155
{
156
"id": "60a3b679147422101b4a5be3",
157
"importId": "UniqueImportId_4",
158
"name": " KRad",
159
"startNumber": "04",
160
"currentDuration": null,
161
"rank": 16,
162
"state": null,
163
"progress": 100314.53696696438,
164
"results": [
165
{
166
"id": "start",
167
"relativeProgress": null
168
},
169
{
170
"id": "_t9kp7roge",
171
"relativeProgress": 0
172
},
173
{
174
"id": "_l7z9ygc3f",
175
"relativeProgress": 7639486.329285986
176
},
177
{
178
"id": "_xdbst6t0c",
179
"relativeProgress": 12453362.074244913
180
},
181
{
182
"id": "_b31s55hd3",
183
"relativeProgress": 12925452.993913682
184
},
185
{
186
"id": "_a218n2064",
187
"relativeProgress": 17505259.99242322
188
},
189
{
190
"id": "_l542jdzag",
191
"relativeProgress": 17795691.548551336
192
},
193
{
194
"id": "_muwe600tp",
195
"relativeProgress": 25945000
196
}
197
],
198
"online": false,
199
"manualFinishDuration": null
200
},
201
{
202
"id": "60a3b6791474227ee54a5bdf",
203
"name": "Konrad",
204
"rank": -1,
205
"state": "DNS",
206
"results": [null, null, null, null, null, null],
207
"online": false,
208
"progress": -1,
209
"startNumber": "01"
210
}
211
]
212
}
Copied!
Copy link