*/current, location data
API with real-time geolocation data every 1 sec
syntax https://racemap.com/api/data-1/eventId/current Test the API with your application. Use the sample with two active devices https://racemap.com/api/data-1/5e3bff6409cd1c000185464e/current Contact [email protected] if the location data is not refreshed.
  • data is recalculated with each query
  • current object provides the latest data of the last two hours
  • if there is no data from the last two hours then current array shows null
parameter
description
type
parameters of event
object
starters
parameters of participants
array
current
real-time data of participant
object
event object
participant object
current object
parameter
description [unit]
type
name
name of event
string
location
location
string
startTime
start time in UTC
string
endTime
end time in UTC
string
image
URL of the logo
string
geoJSON
URL of the shadowtrack
string
parameter
description [unit]
type
id
unique Racemap ID of participant
string
startNumber
bib number
string
name
name
string
parameter
description [unit]
type
time
timestamp in UTC of geolocation
string
lng
current longitude of participant
string
lat
latitude
string
elv
total elevation gain on shadowtrack [m]
string
fromStart *
distance from first geolocation of shadowtrack along shadowtrack [m]
string
toFinish *
distance to last geolocation of shadowtrack along shadowtrack [m]
string
eta *
estimated time of arrival [s], time to reach last geolocation of shadowtrack, prediction with speed
string
speed
average speed of the last 100s [m/s]
string
distanceToShadowTrack *
distance from shadowtrack [m] if more than 100m
string
gap *
duration [s] to reach current fromStart value of the leader, prediction with speed value of leader, if speed < 1 km/h then prediction with default speed value of the event, leader: participant with smallest toFinish value
string
(*) calculated only for events with a shadowtrack
1
{
2
"name":"Sample | Current Data Export",
3
"location":"Dresden",
4
"startTime":"2021-08-01T10:00:00.000Z",
5
"endTime":"2021-12-31T14:00:00.000Z",
6
"image":"https://static-cdn.racemap.com/uploads/logos/967c1fdb6ebf0ba6d1f8755df8ec320d14a3c2c0b6a770e71033583444c1ef6e-large.png",
7
"geoJSON":"https://static-cdn.racemap.com/eventgeos/geojson/e628acb3f5a26240c326689219751d402f9bd173ebc179aa0e7160d7b616a35d.geojson",
8
"starters": [
9
{
10
"id":"61824a40dafa49fb74691ff6",
11
"startNumber":"135",
12
"name":"KRad",
13
"current": {
14
"time":"2021-11-03T09:01:33.329Z",
15
"lng":13.756710078,
16
"lat":51.069866657999995,
17
"elv":142,
18
"fromStart":12500,
19
"toFinish":1400,
20
"eta":400,
21
"speed":3.5,
22
"distanceToShadowTrack":5,
23
"gap":null
24
}
25
},
26
{
27
"id":"61824a76575cac647f1fa0ea",
28
"name":"A008C0",
29
"current": {
30
"time":"2021-11-03T09:01:33.329Z",
31
"lng":13.756626736,
32
"lat":51.069906658,
33
"elv":94,
34
"fromStart":10900,
35
"toFinish":3000,
36
"eta":789,
37
"speed":3.8,
38
"distanceToShadowTrack":8,
39
"gap":421
40
}
41
},
42
{
43
"id":"61824aa9b8496ebc28d60512",
44
"name":"A008DD",
45
"current": {
46
"time":"2021-11-03T09:01:33.329Z",
47
"lng":13.756656749,
48
"lat":51.069886645000004,
49
"elv":102,
50
"fromStart":11750,
51
"toFinish":2150,
52
"eta":741,
53
"speed":2.9,
54
"distanceToShadowTrack":9,
55
"gap":259
56
}
57
}
58
]
59
}
Copied!

Subsequent calculations

to adapt parameters for 3rd party applications:
gap distance between two participants: fromStart (participant 1) - fromStart (participant 2)
gap duration between two participants:
  • option 1: eta (participant 2) - eta (participant 1)
  • option 2: gap (participant 2) - gap (participant 1)
identify the leader: the smallest value of toFinish
Last modified 21d ago
Copy link