world.treeline.route.record

A curated trail guide, course, or route record published on Treeline.

Repository @treeline.world did:plc:sjejpugpajgvxweilujzjcmq namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityroute.treeline.world
Indexed

Record

record · key tid

Properties

Optional reference to the activity or route this record was saved from (Save as Route). The AppView checks the source's reuse rules and hides this route when they are not met.

Ordered physical trails comprising this route guide.

itemsref
Reference

Downloadable GPX/FIT course file with turn-by-turn cue sheets.

  • maxSize: 52428800
  • accept: application/gpx+xml, application/vnd.ant.fit, application/vnd.garmin.tcx+xml, application/octet-stream, application/xml, text/xml

createdAt

requiredstring · datetime

Creation timestamp.

Turn-by-turn navigational cues along the course.

itemsref
Reference

Detailed guide, route directions, access notes, seasonal conditions, and water availability.

  • maxLength: 50000
  • maxGraphemes: 5000

Technical and physical difficulty assessment.

  • knownValues: easy | moderate | hard | expert | extreme

External open mapping identifiers (OSM, COTREX, USFS, OpenTrails, Wikidata).

Reference

Simplified GeoJSON LineString geometry of the route path.

Reference

Gradient profile and climb categorization for climbs or descents.

Reference

labels

union

Optional self-label values the author applies to this record, effectively content warnings (e.g. graphic-media for an injury photo).

langs

array

Optional. The human languages of this record's text (the title, description and cue or point-of-interest text), as BCP-47 tags, so consumers can filter or translate.

  • maxLength: 3
itemsstring · language

location

string

Geographical region or park name (e.g. White Mountains, NH).

  • maxLength: 2000
  • maxGraphemes: 200

StrongRef (uri and cid) to the parent world.treeline.route.record when this route is a section or loop of another route record. Only for real records: a parent from an open-data source (OSM, COTREX, ...) is not a record and goes in externalIds instead.

Generic strongRefs to any location-based pins, check-ins, summits, water sources, or hazard records across the ATmosphere.

itemsref

privacy

string

Privacy visibility setting for this route or segment.

  • default: "public"
  • knownValues: public | unlisted | followers | private

High-resolution GPX/FIT course file blob.

  • maxSize: 52428800
  • accept: application/gpx+xml, application/vnd.ant.fit, application/vnd.garmin.tcx+xml, application/octet-stream, application/xml, text/xml

Generic strongRefs to related network content (e.g. Bluesky trip report posts, photo records, gear lists).

itemsref

routeType

string

Topological structure of the route.

  • knownValues: loop | out_and_back | point_to_point

[Deprecated in v0.10: Competitive segments use world.treeline.segment.record. Retained for backward compatibility.] Functional classification of the route or segment.

  • knownValues: trail | loop | climb | descent | sprint | traverse

Ordered sub-segments or constituent trails that make up this composite route or loop.

itemsref
Reference

source

string

Data provenance source.

  • default: "user"
  • knownValues: user | osm | cotrex | usfs | opentrails | community

StrongRef to the activity record from which this segment was extracted or initiated.

sport

array

Applicable sports or disciplines for this route (e.g., hike, trail_run, gravel_ride).

itemsstring

Route distance and elevation profile metrics.

Reference

surface

array

Surface composition types (e.g. singletrack, dirt_road, paved, rock_scramble, snow).

itemsstring

title

requiredstring

Title or route name (e.g., Mount Rainier Wonderland Trail).

  • maxLength: 3000
  • maxGraphemes: 300

updatedAt

string · datetime

Last updated timestamp.

References to waypoint records along this route.

itemsref

#externalIds

object

Cross-references to public open mapping registries.

Properties

cotrexId

string

Colorado Trail Explorer (COTREX) feature ID.

OpenTrails standard dataset feature identifier.

OpenStreetMap Relation ID.

osmWayId

string

OpenStreetMap Way ID.

US Forest Service official trail designation number (e.g., '514' for Hermosa Creek).

Wikidata entity identifier.

#gradeStats

object

Gradient statistics for climbs, descents, or trail segments.

Properties

Average slope gradient percentage (e.g. '7.5' for 7.5% climb, '-6.2' for descent).

[Deprecated in v0.10: Use world.treeline.segment.record for competitive climb categorization.] Standard cycling/running climb category.

  • knownValues: HC | 1 | 2 | 3 | 4 | uncategorized

Maximum slope gradient percentage.

#routeCuePoint

object

Properties

Optional coordinate tuple [lon, lat, ele?] of the cue point.

itemsstring

distanceMeters

requiredinteger

Chainage offset along the route in meters.

instruction

requiredstring

Navigation instruction (e.g. Turn left at junction onto Colorado Trail).

#routeGeometry

object

GeoJSON LineString representing the route path.

Properties

coordinates

requiredarray

Simplified coordinate tuples array.

  • maxLength: 500
itemsarray
itemsstring

type

requiredstring

GeoJSON geometry type.

  • const: "LineString"

#routeSegmentItem

object

A constituent sub-segment or trail section in a composite route.

Properties

endKm

string

Ending kilometer offset on the referenced route.

name

string

Name or title of the constituent segment.

  • maxGraphemes: 300

order

requiredinteger

1-based sequence order in the route traversal.

  • minimum: 1

True if the constituent segment is traversed in reverse direction.

StrongRef to the route record representing this segment.

startKm

string

Starting kilometer offset on the referenced route.

#routeStats

object

Distance and elevation stats for the route.

Properties

Total route distance in meters.

  • minimum: 0

Total cumulative ascent in meters.

  • minimum: 0

Total cumulative descent in meters.

  • minimum: 0

Estimated moving duration in seconds for an average pace.

  • minimum: 0

Maximum elevation on the route in meters.

Minimum elevation on the route in meters.

#routeTrailSegment

object

Properties

Whether the trail is traversed in reverse direction.

  • default: false

1-based order in traversal sequence.

trailId

requiredstring

Identifier of underlying physical trail.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.