world.treeline.activity.record
A sports activity or outdoor adventure record logged on Treeline.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | activity.treeline.world |
| Commit rev | 3n2ow67fftk2v |
| Indexed |
Showing version bafyreidqle7nvtqy4bhh4texry7r7zzkmugvbbcbo5zkcsjymvqa64l6ie. Show the latest
Record
record · key tidProperties
clonedFrom
refOptional reference to the activity this record was saved from (Save as My Activity). The AppView checks the source's reuse rules at index time and hides this record's geometry and co-athlete link when they are not met.
coAthletes
arrayDIDs of athletes who participated in this activity together.
maxLength: 50
Record creation timestamp on client/PDS (ISO 8601 UTC format).
description
stringDetailed notes, trip report, weather observations, or gear notes.
maxLength: 100000maxGraphemes: 10000
deviceInfo
refRecording hardware or sensor device metadata.
distance
stringOptional exact total distance in meters as a decimal string (e.g. '914.4' for 1000 yd), complementing integer stats.distanceMeters.
maxLength: 64
endedAt
string · datetimeTimestamp when the activity finished (ISO 8601 UTC format).
gearRef
refOptional reference to a world.treeline.gear.item used in this activity.
geometry
refSimplified GeoJSON LineString path (recommended <= 250 points) for lightweight relay and feed distribution.
hideHealthStats
booleanWhen true, AppViews must not show heart rate, power, cadence or energy stats to anyone but the owner. Presentation only: the record stats and the telemetry blob still contain them. Treeline no longer sets this on new activities (#1174); it leaves health data out of the record and the blob instead, unless the athlete chooses to include it.
default: false
hideStartEndMeters
integerDistance trimmed from each end of the public preview only. The original telemetry blob remains untrimmed and publicly retrievable.
minimum: 0maximum: 100000
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 photo alt text), as BCP-47 tags, so consumers can filter or translate.
maxLength: 3
photos
arrayPhotos taken during the activity, in display order. Each item is field-compatible with app.bsky.embed.images#image (image, alt, aspectRatio), so clients can embed them in a Bluesky post without re-uploading. Clients must strip all EXIF metadata from the image blob before upload.
maxLength: 8
poolLength
stringOptional pool length in meters as a decimal string (e.g. '25' or '22.86' for 25 yd) so yard pools stay exact.
maxLength: 64
poolLengthUnit
stringDisplay unit for poolLength ('m' or 'yd').
maxLength: 8knownValues: m | yd
privacy
stringAppView visibility, not confidentiality of the public repository or original blob. New clients publish public or unlisted; unsupported restricted values must fail closed.
default: "public"knownValues: public | unlisted | followers | private | permissioned
rawBlob
blobFull-resolution original raw telemetry file (.fit, .gpx, .tcx) stored directly as an ATProto blob on the athlete's PDS.
maxSize: 52428800accept: application/gpx+xml, application/vnd.ant.fit, application/vnd.garmin.tcx+xml, application/octet-stream, application/xml, text/xml
route
refOptional reference to a world.treeline.route.record course or trail guide followed.
routeRef
refOptional reference to a world.treeline.route.record followed.
Sport or activity type category.
knownValues: run | trail_run | track_run | walk | hike | ride | mountain_bike | gravel_ride | e_bike | e_mtb | road_bike | track_cycling | handcycle | ski | telemark_ski | snowboard | splitboard | backcountry_ski | nordic_ski | nordic_classic | nordic_skate | nordic_off_track | roller_ski | snowshoe | swim | open_water_swim | kayak | canoe | rowing | paddleboard | surf | kitesurf | windsurf | sail | climb | boulder | mountaineering | wheelchair | workout | yoga | crossfit | weight_training | pilates | hiit | wellness | other
Timestamp when the activity started (ISO 8601 UTC format).
tags
arrayCategorization tags (e.g. race, commute, intervals, summits).
maxLength: 20
maxLength: 64
timezone
stringIANA time zone name (e.g. 'America/Denver', 'Europe/Paris').
maxLength: 64
Display title of the activity (e.g., Morning Trail Run, Grand Canyon R2R2R).
maxLength: 3000maxGraphemes: 300
utcOffsetMinutes
integerLocal time zone offset from UTC in minutes (-840 to +840).
minimum: -840maximum: 840
#aspectRatio
objectWidth and height of the image in any unit; only the ratio matters. Same shape as app.bsky.embed.defs#aspectRatio.
#deviceMetadata
objectMetadata about the recording hardware or sensor device.
Properties
manufacturer
stringManufacturer name (e.g. Garmin, Wahoo, COROS, Apple).
maxLength: 100
model
stringDevice model name (e.g. Forerunner 965, ELEMNT BOLT, Apple Watch Ultra).
maxLength: 100
#geometry
objectSimplified GeoJSON LineString geometry representing the activity path.
Properties
RDP-simplified array of coordinate tuples [lon, lat, ele?].
maxLength: 500
GeoJSON geometry type specifier.
const: "LineString"
#photo
objectA photo attached to an activity. image, alt and aspectRatio match app.bsky.embed.images#image field for field; caption, takenAt and position are Treeline additions that other AppViews may ignore.
Properties
Alt text for screen readers and Bluesky embeds. May be empty, as on app.bsky.embed.images#image.
maxLength: 10000maxGraphemes: 1000
aspectRatio
refcaption
stringOptional visible caption shown with the photo.
maxLength: 3000maxGraphemes: 300
The photo, re-encoded by the client with all EXIF metadata removed. Same size limit as app.bsky.embed.images#image.
maxSize: 2000000accept: image/jpeg, image/png, image/webp
position
arrayWhere the photo sits on the route, as decimal-string [longitude, latitude]. Clients omit it for photos inside hideStartEndMeters or hiddenAreas, and AppViews must not show it publicly there.
minLength: 2maxLength: 2
maxLength: 32
takenAt
string · datetimeWhen the photo was taken (ISO 8601 UTC), used to order photos along the activity timeline.
#stats
objectSummary telemetry metrics calculated from the raw activity dataset.
Properties
averageCadenceRpm
integer[Deprecated: use avgCadence] Average cadence in rpm or spm.
minimum: 0
averageHeartRateBpm
integer[Deprecated: use avgHeartRateBpm] Average heart rate in beats per minute.
minimum: 0maximum: 300
averagePowerWatts
integer[Deprecated: use avgPowerWatts] Average power output in watts.
minimum: 0
averageSpeedMps
string[Deprecated: use avgSpeedMps] Average moving speed in meters per second.
avgCadence
integerMean cadence (rpm or spm).
minimum: 0
avgCadenceRpm
integerMean cadence in revolutions or steps per minute.
minimum: 0
avgHeartRateBpm
integerMean heart rate in beats per minute.
minimum: 0maximum: 300
avgPowerWatts
integerMean power output in watts from a recorded sensor.
minimum: 0
avgSpeedMps
stringCalculated mean moving speed in meters per second.
calories
integerEstimated energy expenditure in kilocalories.
minimum: 0
distanceMeters
integerTotal distance traveled in meters.
minimum: 0
durationSeconds
integer[Deprecated: use elapsedDurationSeconds] Total elapsed time in seconds.
minimum: 0
elapsedDurationSeconds
integerTotal elapsed time including pauses in seconds.
minimum: 0
elevationGainMeters
integerCumulative elevation gain in meters.
minimum: 0
elevationLossMeters
integerCumulative elevation loss in meters.
minimum: 0
energyKilojoules
integerTotal mechanical work in kilojoules (session.total_work or avgPowerWatts * movingDurationSeconds / 1000).
minimum: 0
maxHeartRateBpm
integerMaximum recorded heart rate in beats per minute.
minimum: 0maximum: 300
maxPowerWatts
integerMaximum power output in watts.
minimum: 0
maxSpeedMps
stringMaximum recorded speed in meters per second.
movingDurationSeconds
integerActive moving duration excluding pauses in seconds.
minimum: 0
movingTimeSeconds
integer[Deprecated: use movingDurationSeconds] Total moving time excluding pauses in seconds.
minimum: 0
temperatureCelsius
integerAverage ambient temperature in degrees Celsius.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
app.kimbia.activity
recordPROVISIONAL: activities are generic enough that they belong in a community-driven lexicon rather than an app namespace. When a community schema stabilizes, Kimbia will migrate to it and deprecate this one in its favor.
-
rehab.syndrome.trailactivity
recordOne private GPS activity. Distance, duration, and elevation are derived by the app from the uploaded route file.
-
app.thedistance.activity
recordA recorded physical activity such as a bike ride.
-
social.pace.feed.activity
recordA recording of an activity. Like running, walking, lifting weights, etc. Helpful to create the rkey tid from the start time and clock id 23 so you can upsert easily.
-
app.attrails.route
recordA cycling, running, hiking, walking, etc. route shared by a user. The associated track file is stored as a blob.