world.treeline.route.record
A curated trail guide, course, or route record published on Treeline.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | route.treeline.world |
| Indexed |
Record
record · key tidProperties
clonedFrom
refOptional 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.
constituentTrails
arrayOrdered physical trails comprising this route guide.
courseBlob
blobDownloadable GPX/FIT course file with turn-by-turn cue sheets.
maxSize: 52428800accept: application/gpx+xml, application/vnd.ant.fit, application/vnd.garmin.tcx+xml, application/octet-stream, application/xml, text/xml
Creation timestamp.
cuePoints
arrayTurn-by-turn navigational cues along the course.
description
stringDetailed guide, route directions, access notes, seasonal conditions, and water availability.
maxLength: 50000maxGraphemes: 5000
difficulty
stringTechnical and physical difficulty assessment.
knownValues: easy | moderate | hard | expert | extreme
externalIds
refExternal open mapping identifiers (OSM, COTREX, USFS, OpenTrails, Wikidata).
geometry
refSimplified GeoJSON LineString geometry of the route path.
gradeStats
refGradient profile and climb categorization for climbs or descents.
labels
unionOptional self-label values the author applies to this record, effectively content warnings (e.g. graphic-media for an injury photo).
langs
arrayOptional. 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
location
stringGeographical region or park name (e.g. White Mountains, NH).
maxLength: 2000maxGraphemes: 200
parentRoute
refStrongRef (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.
pointsOfInterest
arrayGeneric strongRefs to any location-based pins, check-ins, summits, water sources, or hazard records across the ATmosphere.
privacy
stringPrivacy visibility setting for this route or segment.
default: "public"knownValues: public | unlisted | followers | private
rawBlob
blobHigh-resolution GPX/FIT course file blob.
maxSize: 52428800accept: application/gpx+xml, application/vnd.ant.fit, application/vnd.garmin.tcx+xml, application/octet-stream, application/xml, text/xml
routeType
stringTopological structure of the route.
knownValues: loop | out_and_back | point_to_point
segmentType
string[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
segments
arrayOrdered sub-segments or constituent trails that make up this composite route or loop.
source
stringData 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
arrayApplicable sports or disciplines for this route (e.g., hike, trail_run, gravel_ride).
stats
refRoute distance and elevation profile metrics.
surface
arraySurface composition types (e.g. singletrack, dirt_road, paved, rock_scramble, snow).
Title or route name (e.g., Mount Rainier Wonderland Trail).
maxLength: 3000maxGraphemes: 300
updatedAt
string · datetimeLast updated timestamp.
waypoints
arrayReferences to waypoint records along this route.
#externalIds
objectCross-references to public open mapping registries.
Properties
cotrexId
stringColorado Trail Explorer (COTREX) feature ID.
openTrailsId
stringOpenTrails standard dataset feature identifier.
osmRelationId
stringOpenStreetMap Relation ID.
osmWayId
stringOpenStreetMap Way ID.
usfsTrailNumber
stringUS Forest Service official trail designation number (e.g., '514' for Hermosa Creek).
wikidataId
stringWikidata entity identifier.
#gradeStats
objectGradient statistics for climbs, descents, or trail segments.
Properties
averageGradePct
stringAverage slope gradient percentage (e.g. '7.5' for 7.5% climb, '-6.2' for descent).
climbCategory
string[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
maxGradePct
stringMaximum slope gradient percentage.
#routeCuePoint
objectProperties
coordinate
arrayOptional coordinate tuple [lon, lat, ele?] of the cue point.
Chainage offset along the route in meters.
Navigation instruction (e.g. Turn left at junction onto Colorado Trail).
#routeGeometry
objectGeoJSON LineString representing the route path.
Properties
Simplified coordinate tuples array.
maxLength: 500
GeoJSON geometry type.
const: "LineString"
#routeSegmentItem
objectA constituent sub-segment or trail section in a composite route.
Properties
endKm
stringEnding kilometer offset on the referenced route.
name
stringName or title of the constituent segment.
maxGraphemes: 300
1-based sequence order in the route traversal.
minimum: 1
reverseDirection
booleanTrue if the constituent segment is traversed in reverse direction.
route
refStrongRef to the route record representing this segment.
startKm
stringStarting kilometer offset on the referenced route.
#routeStats
objectDistance and elevation stats for the route.
Properties
distanceMeters
integerTotal route distance in meters.
minimum: 0
elevationGainMeters
integerTotal cumulative ascent in meters.
minimum: 0
elevationLossMeters
integerTotal cumulative descent in meters.
minimum: 0
estimatedDurationSeconds
integerEstimated moving duration in seconds for an average pace.
minimum: 0
highestPointMeters
integerMaximum elevation on the route in meters.
lowestPointMeters
integerMinimum elevation on the route in meters.
#routeTrailSegment
objectProperties
reverseDirection
booleanWhether the trail is traversed in reverse direction.
default: false
sequenceOrder
integer1-based order in traversal sequence.
Identifier of underlying physical trail.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
A competitive trail timing segment with defined start/finish gates.
-
app.attrails.route
recordA cycling, running, hiking, walking, etc. route shared by a user. The associated track file is stored as a blob.
-
A coordinate tuple [longitude, latitude, elevation?] encoded as decimal strings (the ATProto data model has no floats).
-
A backcountry point of interest, water source, campsite, summit, or hazard.
-
at.mapped.trail
recordA trail