*/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

Live sample https://racemap.com/api/data/v1/6336f41309be310001a5894b/distance Corresponding map https://racemap.com/player/100KmDuathlon2018_API-liveSample

Optional query with deviceId

Response

Event object

FieldDescription [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

FieldDescription [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

FieldDescription [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
    }
  ]
}

Last updated