*/distance and locations
API with real-time geolocations, distances, and bearings to a reference device; for maximum stability and minimum delay the data is processed as little as possible

Request

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

Optional query with deviceId

Response

Event object

Field
Description [unit]
Sample
name
Name of event
"Sample live | 100km Duathlon"
location
Location
"🇩🇪 Dresden"
startTime
Start time in UTC
"2022-03-09T07:00:03.201Z"
endTime
End time in UTC
"2022-03-09T14:59:38.201Z"
starters
Array for participant objects

Participant object

Field
Description [unit]
Sample
id
Unique Racemap ID of participant
"61a2122f181c0a6c4bb5376e"
importId
User-defined ID with imported participant data, Generic API (importId) or RACE|RESULT API (Id)
"UniqueImportId_2"
startNumber
Bib number
"2"
name
Name
"CLV Megware"
current
Object for real-time data
null if there is no data within the last 30 min

Current object

The current-object provides the latest data
Field
Description [unit]
Sample
time
Timestamp in UTC when device recorded latest geolocation
"2022-03-09T13:23:15.000Z"
lat
Latitude
51.04229
lng
Longitude
13.63867
gapDistance
Distance [m] between latest locations of device and reference device
679.799215351 or 0 for the reference device
bearing
Angle [°] line between latest locations of device and reference device and line from south to north
-76.372782293 or 0 for the reference device

Sample response

1
{
2
"name": "Sample repeat | 100km Duathlon ",
3
"location": "🇩🇪 Dresden",
4
"startTime": "2022-01-17T07:00:02.881Z",
5
"endTime": "2022-01-17T15:00:02.881Z",
6
"starters": [
7
{
8
"id": "61a2122f181c0a0ff7b53765",
9
"importId": "UniqueImportId_1",
10
"startNumber": "001",
11
"name": "🔥 Flaming 🔥 Sideburns 🔥",
12
"current": {
13
"time": "2022-01-17T12:13:30.000Z",
14
"lat": 51.10966,
15
"lng": 13.71298,
16
"gapDistance": 0,
17
"bearing": 0
18
}
19
},
20
{
21
"id": "61a2122f181c0a6c4bb5376e",
22
"importId": "UniqueImportId_2",
23
"startNumber": "002",
24
"name": "CLV Megware meets SG Adelsberg",
25
"current": {
26
"time": "2022-01-17T12:13:30.000Z",
27
"lat": 51.11025,
28
"lng": 13.7107,
29
"gapDistance": 172.16007216012576,
30
"bearing": 112.39911045990338
31
}
32
},
33
{
34
"id": "61a21230181c0a4ab0b53944",
35
"importId": "UniqueImportId_54",
36
"startNumber": "21",
37
"name": "Kingscupkönige",
38
"current": null
39
}
40
]
41
}
Copied!
Copy link