world.treeline.segment.record

treeline.world

Documentation

A competitive trail timing segment with defined start/finish gates.

main record

A competitive trail timing segment with defined start/finish gates.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

Segment creation timestamp.

description string Optional

Optional notes or description of the segment terrain.

maxLength: 20000 bytesmaxGraphemes: 2000 graphemes
directionality string Required

Directionality of timing traversal.

Known values: forward, reverse, out_and_back
Default: forward
endGate ref #timingGate Required

End timing gate coordinate and tolerance radius.

gradeStats ref #gradeStats Optional

Gradient statistics and climb category.

physicalTrailRef ref #externalTrailIds Optional

Public authoritative trail registry cross-references (OSM, COTREX, USFS).

segmentType string Required

Type or profile category of the segment.

Known values: climb, descent, sprint, trail, traverse
sourceActivityRef ref com.atproto.repo.strongRef Optional

Optional reference to the source activity from which the segment was extracted.

sport string Required

Primary sport class for this segment (e.g. mountain_bike, trail_run).

startGate ref #timingGate Required

Start timing gate coordinate and tolerance radius.

title string Required

Title or display name of the segment.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
View raw schema 
{
  "description": "A competitive trail timing segment with defined start/finish gates.",
  "key": "tid",
  "record": {
    "properties": {
      "createdAt": {
        "description": "Segment creation timestamp.",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "Optional notes or description of the segment terrain.",
        "maxGraphemes": 2000,
        "maxLength": 20000,
        "type": "string"
      },
      "directionality": {
        "default": "forward",
        "description": "Directionality of timing traversal.",
        "knownValues": [
          "forward",
          "reverse",
          "out_and_back"
        ],
        "type": "string"
      },
      "endGate": {
        "description": "End timing gate coordinate and tolerance radius.",
        "ref": "#timingGate",
        "type": "ref"
      },
      "geometry": {
        "description": "Canonical polyline geometry for map matching.",
        "ref": "#simplifiedLineString",
        "type": "ref"
      },
      "gradeStats": {
        "description": "Gradient statistics and climb category.",
        "ref": "#gradeStats",
        "type": "ref"
      },
      "physicalTrailRef": {
        "description": "Public authoritative trail registry cross-references (OSM, COTREX, USFS).",
        "ref": "#externalTrailIds",
        "type": "ref"
      },
      "segmentType": {
        "description": "Type or profile category of the segment.",
        "knownValues": [
          "climb",
          "descent",
          "sprint",
          "trail",
          "traverse"
        ],
        "type": "string"
      },
      "sourceActivityRef": {
        "description": "Optional reference to the source activity from which the segment was extracted.",
        "ref": "com.atproto.repo.strongRef",
        "type": "ref"
      },
      "sport": {
        "description": "Primary sport class for this segment (e.g. mountain_bike, trail_run).",
        "type": "string"
      },
      "startGate": {
        "description": "Start timing gate coordinate and tolerance radius.",
        "ref": "#timingGate",
        "type": "ref"
      },
      "title": {
        "description": "Title or display name of the segment.",
        "maxGraphemes": 300,
        "maxLength": 3000,
        "type": "string"
      }
    },
    "required": [
      "title",
      "segmentType",
      "sport",
      "startGate",
      "endGate",
      "directionality",
      "geometry",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
externalTrailIds object

No description available.

Properties

cotrexId string Optional

COTREX trail feature identifier.

osmRelationId string Optional

OpenStreetMap relation identifier.

osmWayId string Optional

OpenStreetMap way identifier.

usfsTrailNumber string Optional

United States Forest Service trail identifier.

View raw schema 
{
  "properties": {
    "cotrexId": {
      "description": "COTREX trail feature identifier.",
      "type": "string"
    },
    "osmRelationId": {
      "description": "OpenStreetMap relation identifier.",
      "type": "string"
    },
    "osmWayId": {
      "description": "OpenStreetMap way identifier.",
      "type": "string"
    },
    "usfsTrailNumber": {
      "description": "United States Forest Service trail identifier.",
      "type": "string"
    }
  },
  "type": "object"
}
gradeStats object

No description available.

Properties

avgGradePct string Optional

Mean gradient percentage (as a decimal string, e.g. '12.5').

climbCategory string Optional

Standard climb category rating.

Known values: HC, 1, 2, 3, 4, uncategorized
maxGradePct string Optional

Peak gradient percentage (as a decimal string, e.g. '18.2').

View raw schema 
{
  "properties": {
    "avgGradePct": {
      "description": "Mean gradient percentage (as a decimal string, e.g. '12.5').",
      "type": "string"
    },
    "climbCategory": {
      "description": "Standard climb category rating.",
      "knownValues": [
        "HC",
        "1",
        "2",
        "3",
        "4",
        "uncategorized"
      ],
      "type": "string"
    },
    "maxGradePct": {
      "description": "Peak gradient percentage (as a decimal string, e.g. '18.2').",
      "type": "string"
    }
  },
  "type": "object"
}
simplifiedLineString object

No description available.

Properties

coordinates array of unknown Required

Polyline coordinate tuples array.

maxLength: 500 items
type string Required

GeoJSON LineString type.

View raw schema 
{
  "properties": {
    "coordinates": {
      "description": "Polyline coordinate tuples array.",
      "items": {
        "type": "unknown"
      },
      "maxLength": 500,
      "type": "array"
    },
    "type": {
      "const": "LineString",
      "description": "GeoJSON LineString type.",
      "type": "string"
    }
  },
  "required": [
    "type",
    "coordinates"
  ],
  "type": "object"
}
timingGate object

No description available.

Properties

coordinate unknown Required

Timing gate coordinate tuple [lon, lat, ele?].

radiusMeters integer Optional

Snapping radius in meters around the gate coordinate.

minimum: 5maximum: 200
View raw schema 
{
  "properties": {
    "coordinate": {
      "description": "Timing gate coordinate tuple [lon, lat, ele?].",
      "type": "unknown"
    },
    "radiusMeters": {
      "default": 25,
      "description": "Snapping radius in meters around the gate coordinate.",
      "maximum": 200,
      "minimum": 5,
      "type": "integer"
    }
  },
  "required": [
    "coordinate"
  ],
  "type": "object"
}

Lexicon Garden

@