Links

*/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" or "null" if no importId exists
startNumber
Bib number
"2"
name
Name
"CLV Megware"
current
Object for real-time data
null
if no locations within startTime and endTime

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

{
"name": "Sample repeat | 100km Duathlon ",
"location": "🇩🇪 Dresden",
"startTime": "2022-01-17T07:00:02.881Z",
"endTime": "2022-01-17T15:00:02.881Z",
"starters": [
{
"id": "61a2122f181c0a0ff7b53765",
"importId": "UniqueImportId_1",
"startNumber": "001",
"name": "🔥 Flaming 🔥 Sideburns 🔥",
"current": {
"time": "2022-01-17T12:13:30.000Z",
"lat": 51.10966,
"lng": 13.71298,
"gapDistance": 0,
"bearing": 0
}
},
{
"id": "61a2122f181c0a6c4bb5376e",
"importId": "UniqueImportId_2",
"startNumber": "002",
"name": "CLV Megware meets SG Adelsberg",
"current": {
"time": "2022-01-17T12:13:30.000Z",
"lat": 51.11025,
"lng": 13.7107,
"gapDistance": 172.16007216012576,
"bearing": 112.39911045990338
}
},
{
"id": "61a21230181c0a4ab0b53944",
"importId": "UniqueImportId_54",
"startNumber": "21",
"name": "Kingscupkönige",
"current": null
}
]
}