*/times, reads and raw data
API with passings or detections (raw data timestamps) at virtual checkpoints respectively geofences, similar to a reader
The */times API generates a detection from a received location if it fulfills three conditions. The API can provide multiple detections for a split.
The device id belongs to the event.
The location is around the detection radius of a geofence.
The timestamp of the location is between the event start- and end time.
Effortless detections with virtual timekeeping points (geofence) and with geolocations of participants. No timing hardware, no transponders.
Passings are recorded in a radius around the geofence. Set the radius in the setting of the data API of your event.
Flexibly adjust settings in between: add timekeeping points or change their locations of a running event or even of a past event, recalculate detections with new parameters.
Request
URL https://racemap.com/api/data/v1/:eventId/times
Method GET
Live sample https://racemap.com/api/data/v1/61a21210e5d45d000199f7d9/times Past sample https://racemap.com/api/data/v1/60a3b443f096f800018add7c/times
Optional query with id
of a checkpoint
id
of a checkpointThe
id
of a virtual timekeeping point to get all reads of this geofence in chronological order.Live sample split "Split 3" https://racemap.com/api/data/v1/61a21210e5d45d000199f7d9/times/6450e60747adaed475b484b4
Past sample split "Finish" https://racemap.com/api/data/v1/60a3b443f096f800018add7c/times/64513872c3ab09659eb09683
Response
Event object
Field | Description [unit] | Sample |
---|---|---|
| Name of event |
|
| Location |
|
| Start time in UTC |
|
| End time in UTC |
|
| Array for checkpoint objects | |
| Array for participant objects |
Checkpoint object
Field | Description | Sample |
---|---|---|
| Name of virtual timekeeping point |
|
| Distance [m] along the shadowtrack |
|
| Unique Racemap ID of timekeeping point |
|
| Array with longitude, latitude, hight [m] |
|
Participant object
Field | Description [unit] | Sample |
---|---|---|
| Unique Racemap ID of participant |
|
| User-defined ID with imported participant data, Generic API ( |
|
| Bib number |
|
| Name |
|
| Object for checkpoint arrays |
|
Checkpoint array
Description | Sample |
---|---|
Unique Racemap ID of timekeeping point, array for detection objects |
|
Detection object
Field | Description [unit] | Sample |
---|---|---|
| Timestamp of detection in UTC |
|
| Distance [m] of detection from timekeeping point |
|
Sample response
Sample response with id
of checkpoint
id
of checkpointCheckpoint "Bergwertung" https://racemap.com/api/data/v1/60a3b443f096f800018add7c/times/6451387410e583b28d7167e6
Times array with detection objects
Field | Description [unit] | Sample |
---|---|---|
| Unique Racemap ID of participant |
|
| User-defined ID with imported participant data, Generic API ( |
|
| Bib number |
|
| Name |
|
| Timestamp of detection in UTC |
|
| Distance [m] of detection from timekeeping point |
|
Export to RACE|RESULT
RACE|RESULT event settings: Main Window, Simple API
Type: Custom
Details: rawdata/addmanual
Settings create an API key to push external data to RACE|RESULT. The duration of the key is limited. Sample: https://api.raceresult.com/180472/G5XQYZKPIPU5J1RSCVIZ48QKVU5JIIJP
Data from Racemap */times API need be transferred to RACE|RESULT API format, e.g. with a python script:
syntax: https://api.raceresult.com/
eventId
/apiKey
?&bib
=bibNumber&time
=timeOfDetections&TimingPoint
=splitNametimeOfDetections in seconds
Using this format virtual detections are imported in RACE|RESULT one by one.
Last updated