*/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
URL
https://racemap.com/api/data/v1/:eventId/distance
Method GETLive sample https://racemap.com/api/data/v1/6336f41309be310001a5894b/distance
Corresponding map https://racemap.com/player/100KmDuathlon2018_API-liveSample
- The
deviceId
of a chosen reference device to calculategapDistance
andbearing
to the other devices. - If API is called without a
deviceId
thengapDistance
andbearing
is calculated for the first device in the list.
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 | |
Field | Description [unit] | Sample |
---|---|---|
id | Unique Racemap ID of participant | "61a2122f181c0a6c4bb5376e" |
importId | "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 |
The
current
-object provides the latest dataField | 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 |

{
"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
}
]
}
Last modified 7mo ago