LogoLogo
UpdatesGPS trackersLoginFree trial
  • Welcome
  • Quick start guide
  • Provide live tracking
    • Features of visualization
    • Leaderboard
    • Monitor
    • Group and stages
    • Embed interactive content
    • Keys and passcode
    • Activity upload
    • Deep links on tracking app
    • Shadowtrack and mapping
  • Data APIs for live geodata
    • */current, location data
    • */distance and locations
    • */times, reads and raw data
    • */ranks, ranking and results
    • */starters, athlete data
    • */geo, geo elements
    • Tools to extract live data
  • Import participant data
    • Import with API, automatically
      • Generic import
      • RACE RESULT import
    • Import with CSV file
  • Tracker management
    • Add GPS trackers
    • Add RACE RESULT readers
    • Add devices to event
    • Send messages
    • Compose messages
    • User access to devices
    • Manage SIM cards
  • Hardware for live tracking
    • Configure GPS tracker
      • Remote configuration
      • Physical configuration
    • Update firmware of GPS tracker
    • Configuring trackers for increased autonomy
    • Track Box forwarding
    • Insiders GPS trackers
    • Prepare smartphone
    • Using GPS trackers On-Site
    • Debug tracking devices
  • Predictive tracking with reads from race timing
    • RACE RESULT
    • Other timing system
      • ChronoTrack forwarder
      • MyLaps forwarder
  • Integrations
    • Wiclax
  • Map settings
    • External map layer
  • Export data from RACEMAP
    • Hosted elevation service
    • Hosted loads information
    • Download leaderboard CSV
    • Download recorded GPX
Powered by GitBook
LogoLogo

Legacy

  • Contact
  • Terms of use
  • Privacy Policy
  • Imprint

About Racemap

  • Pricing
  • About Us
  • Apps
  • Events

Follow us

  • facebook
  • youtube
  • linkedin
  • github

Maps: ©Mapbox ©OpenStreetMap ©RACEMAP

On this page
  • Request
  • Response
  1. Data APIs for live geodata

*/geo, geo elements

API providing the geo elements from the tracking map

Previous*/starters, athlete dataNextTools to extract live data

Last updated 3 months ago

Request

URL https://racemap.com/api/events/:eventId/geo Method GET

Sample Corresponding map

Options

API provides only the splits of one tracking map. Sample:

API provides the shadow track and the splits of one tracking map. Sample:

Response

(*) parameters related to splits, only

(**) parameters related to POIs and splits

Geo element object

Field
Description [unit]
Sample

racemapType

Definition of geo element

"track" or "split" or "poi"

eventId

Unique id of tracking map

"61a2055b10cacc0001302283"

name

Name of geo element provided in map settings

"Track 0" or "Marathon"

shortName **

Short name of POI or split

"VP01" or "Cam2"

color

Color of geo element, hex code

"#ffffff" or "#32c4f7"

hidden

Visibility in tracking map

true or false

icon **

URL of image

"https://static-cdn.racemap.com/img/map-icons/finish-01_borderless.svg"

timekeeping *

Split in leaderboard or geofence in */time API

true or false

readerIds **

IDs of decoders, arrey of strings

[] or [ "U001", "U003" ]

newSport *

Start of a new segment, definition of type of sport

"running"

lineStringId *

Id of the track to which this split is associated.

"64514d7ec3ab09659eb29e71"

coordinateIndex

Number of the coordinate of the track to which the split is assigned.

253 or 12

creatorId

User id of the event host

"51782b0cd37706937400000d"

length

Length of the track in km

99.50403889646452

pointCount

Number of points of the track

1192

offset *

Length [m] on which the split is set on the track

19029.765609128

resetSpeed **

Velocity [km/h] used for prediction

null or 1.5 or 60

minSpeed **

Velocity [km/h] used for prediction

null or 1.5 or 60

minSpeed *

Velocity [km/h] used for prediction

null or 1.5 or 60

oldId

An old reference to the geo element

"cf31ed00-d2a1-47c3-8306-fd55b09a1bb0" or "_wi57w51ay"

createdAt

Timestamp of when the element was added to the event in RACEMAP

"2021-09-10T03:04:07.020Z" or null

updaterId

Id of the user that updated the elment latest

"c001cafe15abad1deabada55"

updatedAt

Timestamp of latest update of the element

"2023-05-02T17:50:54.304Z"

id

Unique id of geo lement

"64514d7ec3ab09659eb29e71"

Geometry object

Field
Description [unit]
Sample

type

Definition of the geo element

"LineString" or "Point"

Coordinates array

Description [unit]
Sample

Longitude, latitude, hight above sea level [m]

[ 13.704979999999978, 51.02677, 165 ]

{
  "type": "FeatureCollection",
  "features": [
    {
      "properties": {
        "racemapType": "track",
        "eventId": "61a2055b10cacc0001302283",
        "name": "Track 0",
        "color": "#32c4f7",
        "hidden": false,
        "creatorId": "51782b0cd37706937400000d",
        "length": 99.50403889646452,
        "pointCount": 1192,
        "oldId": "cf31ed00-d2a1-47c3-8306-fd55b09a1bb0",
        "createdAt": "2023-05-02T17:50:54.228Z",
        "updaterId": "c001cafe15abad1deabada55",
        "updatedAt": "2023-05-02T17:50:54.304Z"
      },
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [13.704979999999978, 51.02677, 165],
          [13.705195019584863, 51.026764818805184, 164],
          [13.705694405424758, 51.02675278541145, 163],
          [13.705086448148332, 51.02636026141142, 173],
          [13.705079999999953, 51.02636, 173]
        ]
      },
      "id": "64514d7ec3ab09659eb29e71"
    },
    {
      "properties": {
        "racemapType": "split",
        "hidden": true,
        "eventId": "61a2055b10cacc0001302283",
        "name": "START",
        "shortName": "",
        "color": "#36739a",
        "icon": null,
        "resetSpeed": null,
        "minSpeed": 1.5,
        "maxSpeed": 60,
        "timekeeping": false,
        "readerIds": [ "Start01", "Start03" ],
        "newSport": "running",
        "lineStringId": "64514d7ec3ab09659eb29e71",
        "coordinateIndex": 0,
        "creatorId": "51782b0cd37706937400000d",
        "updaterId": "51782b0cd37706937400000d",
        "createdAt": "2023-05-02T17:50:54.446Z",
        "updatedAt": "2025-01-27T12:20:36.771Z",
        "offset": 0,
        "oldId": "_wi57w51ay"
      },
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [13.704979999999978, 51.02677, 165]
      },
      "id": "64514d7ec3ab09659eb29e78"
    },
    {
      "properties": {
        "racemapType": "split",
        "hidden": true,
        "eventId": "61a2055b10cacc0001302283",
        "name": "ZIEL",
        "shortName": "",
        "color": "#ffffff",
        "icon": "https://static-cdn.racemap.com/img/map-icons/finish-01_borderless.svg",
        "timekeeping": false,
        "readerIds": [],
        "newSport": "",
        "lineStringId": "64514d7ec3ab09659eb29e71",
        "coordinateIndex": 1191,
        "creatorId": "51782b0cd37706937400000d",
        "updaterId": "c001cafe15abad1deabada55",
        "createdAt": "2023-05-02T17:50:54.551Z",
        "updatedAt": "2023-05-02T17:50:57.512Z",
        "offset": 99504.03889646452,
        "oldId": "_9q5ec0nno",
        "resetSpeed": null,
        "minSpeed": 1.5,
        "maxSpeed": 60
      },
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [13.705079999999953, 51.02636, 173]
      },
      "id": "64514d7ec3ab09659eb29e93"
    },
    {
      "properties": {
        "racemapType": "split",
        "hidden": false,
        "eventId": "61a2055b10cacc0001302283",
        "name": "VP1",
        "shortName": "",
        "color": "#ffffff",
        "icon": "https://static-cdn.racemap.com/img/map-icons/refreshment-food_borderless.svg",
        "timekeeping": true,
        "newSport": "",
        "lineStringId": "64514d7ec3ab09659eb29e71",
        "coordinateIndex": 292,
        "creatorId": "51782b0cd37706937400000d",
        "oldId": "_okhk7667m",
        "readerIds": [],
        "updaterId": "c001cafe15abad1deabada55",
        "createdAt": "2023-05-02T17:50:56.269Z",
        "updatedAt": "2023-05-02T17:50:56.269Z",
        "offset": 19029.765609128855,
        "resetSpeed": null,
        "minSpeed": 1.5,
        "maxSpeed": 60
      },
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [13.806170000000066, 50.93263999999999, 342]
      },
      "id": "64514d8010e583b28d736c7d"
    },
    {
      "properties": {
        "minSpeed": 0.1,
        "maxSpeed": 360,
        "racemapType": "poi",
        "hidden": false,
        "eventId": "61a2055b10cacc0001302283",
        "name": "Danger",
        "shortName": "",
        "color": "#36739a",
        "description": "",
        "icon": "https://static-cdn.racemap.com/img/map-icons/black-spot_borderless.svg",
        "creatorId": "51782b0cd37706937400000d",
        "oldId": "Danger",
        "readerIds": [],
        "updaterId": "c001cafe15abad1deabada55",
        "createdAt": "2023-05-02T17:50:57.589Z",
        "updatedAt": "2023-05-02T17:50:57.589Z"
      },
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [13.605496742105894, 51.094757189936146, 106]
      },
      "id": "64514d811186e2e551ee4c69"
    }
  ]
}
https://racemap.com/api/events/61a2055b10cacc0001302283/geo
https://racemap.com/player/100KmDuathlon2018
https://racemap.com/api/events/61a2055b10cacc0001302283/geo/splits
https://racemap.com/api/events/61a2055b10cacc0001302283/geo/shadow.json