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 |
Checks
Validunlimited-stringdefs.geometry.properties.coordinates.items.itemsNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.geometry.properties.typeNo maxLength, maxGraphemes or format limits this string.large-stringdefs.main.record.properties.descriptionmaxLength is over 20 KB. Use a blob for content that large.unlimited-stringdefs.main.record.properties.privacyNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.record.properties.sportNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.stats.properties.averageSpeedMpsNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.stats.properties.avgSpeedMpsNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.stats.properties.maxSpeedMpsNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"aspectRatio": {
"description": "Width and height of the image in any unit; only the ratio matters. Same shape as app.bsky.embed.defs#aspectRatio.",
"properties": {
"height": {
"minimum": 1,
"type": "integer"
},
"width": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"width",
"height"
],
"type": "object"
},
"deviceMetadata": {
"description": "Metadata about the recording hardware or sensor device.",
"properties": {
"manufacturer": {
"description": "Manufacturer name (e.g. Garmin, Wahoo, COROS, Apple).",
"maxLength": 100,
"type": "string"
},
"model": {
"description": "Device model name (e.g. Forerunner 965, ELEMNT BOLT, Apple Watch Ultra).",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
},
"geometry": {
"description": "Simplified GeoJSON LineString geometry representing the activity path.",
"properties": {
"coordinates": {
"description": "RDP-simplified array of coordinate tuples [lon, lat, ele?].",
"items": {
"items": {
"type": "string"
},
"type": "array"
},
"maxLength": 500,
"type": "array"
},
"type": {
"const": "LineString",
"description": "GeoJSON geometry type specifier.",
"type": "string"
}
},
"required": [
"type",
"coordinates"
],
"type": "object"
},
"hiddenArea": {
"description": "A displaced circular privacy zone used to trim public preview geometry.",
"properties": {
"center": {
"description": "Displaced disc centre as decimal-string [longitude, latitude].",
"items": {
"maxLength": 32,
"type": "string"
},
"maxLength": 2,
"minLength": 2,
"type": "array"
},
"radiusMeters": {
"description": "Disc radius R = r + D in meters.",
"maximum": 200000,
"minimum": 1,
"type": "integer"
}
},
"required": [
"center",
"radiusMeters"
],
"type": "object"
},
"main": {
"description": "A sports activity or outdoor adventure record logged on Treeline.",
"key": "tid",
"record": {
"properties": {
"clonedFrom": {
"description": "Optional 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.",
"ref": "com.atproto.repo.strongRef",
"type": "ref"
},
"coAthletes": {
"description": "DIDs of athletes who participated in this activity together.",
"items": {
"format": "did",
"type": "string"
},
"maxLength": 50,
"type": "array"
},
"createdAt": {
"description": "Record creation timestamp on client/PDS (ISO 8601 UTC format).",
"format": "datetime",
"type": "string"
},
"description": {
"description": "Detailed notes, trip report, weather observations, or gear notes.",
"maxGraphemes": 10000,
"maxLength": 100000,
"type": "string"
},
"deviceInfo": {
"description": "Recording hardware or sensor device metadata.",
"ref": "#deviceMetadata",
"type": "ref"
},
"distance": {
"description": "Optional exact total distance in meters as a decimal string (e.g. '914.4' for 1000 yd), complementing integer stats.distanceMeters.",
"maxLength": 64,
"type": "string"
},
"endedAt": {
"description": "Timestamp when the activity finished (ISO 8601 UTC format).",
"format": "datetime",
"type": "string"
},
"gearRef": {
"description": "Optional reference to a world.treeline.gear.item used in this activity.",
"ref": "com.atproto.repo.strongRef",
"type": "ref"
},
"geometry": {
"description": "Simplified GeoJSON LineString path (recommended <= 250 points) for lightweight relay and feed distribution.",
"ref": "#geometry",
"type": "ref"
},
"hiddenAreas": {
"description": "Displaced privacy discs (at most 2: start and end, or 1 shared disc on a loop) used to trim the public preview geometry and prevent start/end triangulation. The original telemetry blob remains untrimmed.",
"items": {
"ref": "#hiddenArea",
"type": "ref"
},
"maxLength": 2,
"type": "array"
},
"hideHealthStats": {
"default": false,
"description": "When 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.",
"type": "boolean"
},
"hideStartEndMeters": {
"description": "Distance trimmed from each end of the public preview only. The original telemetry blob remains untrimmed and publicly retrievable.",
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"labels": {
"description": "Optional self-label values the author applies to this record, effectively content warnings (e.g. graphic-media for an injury photo).",
"refs": [
"com.atproto.label.defs#selfLabels"
],
"type": "union"
},
"langs": {
"description": "Optional. 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.",
"items": {
"format": "language",
"type": "string"
},
"maxLength": 3,
"type": "array"
},
"photos": {
"description": "Photos 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.",
"items": {
"ref": "#photo",
"type": "ref"
},
"maxLength": 8,
"type": "array"
},
"poolLength": {
"description": "Optional pool length in meters as a decimal string (e.g. '25' or '22.86' for 25 yd) so yard pools stay exact.",
"maxLength": 64,
"type": "string"
},
"poolLengthUnit": {
"description": "Display unit for poolLength ('m' or 'yd').",
"knownValues": [
"m",
"yd"
],
"maxLength": 8,
"type": "string"
},
"privacy": {
"default": "public",
"description": "AppView visibility, not confidentiality of the public repository or original blob. New clients publish public or unlisted; unsupported restricted values must fail closed.",
"knownValues": [
"public",
"unlisted",
"followers",
"private",
"permissioned"
],
"type": "string"
},
"rawBlob": {
"accept": [
"application/gpx+xml",
"application/vnd.ant.fit",
"application/vnd.garmin.tcx+xml",
"application/octet-stream",
"application/xml",
"text/xml"
],
"description": "Full-resolution original raw telemetry file (.fit, .gpx, .tcx) stored directly as an ATProto blob on the athlete's PDS.",
"maxSize": 52428800,
"type": "blob"
},
"route": {
"description": "Optional reference to a world.treeline.route.record course or trail guide followed.",
"ref": "com.atproto.repo.strongRef",
"type": "ref"
},
"routeRef": {
"description": "Optional reference to a world.treeline.route.record followed.",
"ref": "com.atproto.repo.strongRef",
"type": "ref"
},
"sport": {
"description": "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"
],
"type": "string"
},
"startedAt": {
"description": "Timestamp when the activity started (ISO 8601 UTC format).",
"format": "datetime",
"type": "string"
},
"stats": {
"description": "Summary metrics and telemetry statistics for the activity.",
"ref": "#stats",
"type": "ref"
},
"tags": {
"description": "Categorization tags (e.g. race, commute, intervals, summits).",
"items": {
"maxLength": 64,
"type": "string"
},
"maxLength": 20,
"type": "array"
},
"timezone": {
"description": "IANA time zone name (e.g. 'America/Denver', 'Europe/Paris').",
"maxLength": 64,
"type": "string"
},
"title": {
"description": "Display title of the activity (e.g., Morning Trail Run, Grand Canyon R2R2R).",
"maxGraphemes": 300,
"maxLength": 3000,
"type": "string"
},
"utcOffsetMinutes": {
"description": "Local time zone offset from UTC in minutes (-840 to +840).",
"maximum": 840,
"minimum": -840,
"type": "integer"
}
},
"required": [
"title",
"sport",
"startedAt",
"createdAt"
],
"type": "object"
},
"type": "record"
},
"photo": {
"description": "A 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": {
"description": "Alt text for screen readers and Bluesky embeds. May be empty, as on app.bsky.embed.images#image.",
"maxGraphemes": 1000,
"maxLength": 10000,
"type": "string"
},
"aspectRatio": {
"ref": "#aspectRatio",
"type": "ref"
},
"caption": {
"description": "Optional visible caption shown with the photo.",
"maxGraphemes": 300,
"maxLength": 3000,
"type": "string"
},
"image": {
"accept": [
"image/jpeg",
"image/png",
"image/webp"
],
"description": "The photo, re-encoded by the client with all EXIF metadata removed. Same size limit as app.bsky.embed.images#image.",
"maxSize": 2000000,
"type": "blob"
},
"position": {
"description": "Where 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.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxLength": 2,
"minLength": 2,
"type": "array"
},
"takenAt": {
"description": "When the photo was taken (ISO 8601 UTC), used to order photos along the activity timeline.",
"format": "datetime",
"type": "string"
}
},
"required": [
"image",
"alt"
],
"type": "object"
},
"stats": {
"description": "Summary telemetry metrics calculated from the raw activity dataset.",
"properties": {
"averageCadenceRpm": {
"description": "[Deprecated: use avgCadence] Average cadence in rpm or spm.",
"minimum": 0,
"type": "integer"
},
"averageHeartRateBpm": {
"description": "[Deprecated: use avgHeartRateBpm] Average heart rate in beats per minute.",
"maximum": 300,
"minimum": 0,
"type": "integer"
},
"averagePowerWatts": {
"description": "[Deprecated: use avgPowerWatts] Average power output in watts.",
"minimum": 0,
"type": "integer"
},
"averageSpeedMps": {
"description": "[Deprecated: use avgSpeedMps] Average moving speed in meters per second.",
"type": "string"
},
"avgCadence": {
"description": "Mean cadence (rpm or spm).",
"minimum": 0,
"type": "integer"
},
"avgCadenceRpm": {
"description": "Mean cadence in revolutions or steps per minute.",
"minimum": 0,
"type": "integer"
},
"avgHeartRateBpm": {
"description": "Mean heart rate in beats per minute.",
"maximum": 300,
"minimum": 0,
"type": "integer"
},
"avgPowerWatts": {
"description": "Mean power output in watts from a recorded sensor.",
"minimum": 0,
"type": "integer"
},
"avgSpeedMps": {
"description": "Calculated mean moving speed in meters per second.",
"type": "string"
},
"calories": {
"description": "Estimated energy expenditure in kilocalories.",
"minimum": 0,
"type": "integer"
},
"distanceMeters": {
"description": "Total distance traveled in meters.",
"minimum": 0,
"type": "integer"
},
"durationSeconds": {
"description": "[Deprecated: use elapsedDurationSeconds] Total elapsed time in seconds.",
"minimum": 0,
"type": "integer"
},
"elapsedDurationSeconds": {
"description": "Total elapsed time including pauses in seconds.",
"minimum": 0,
"type": "integer"
},
"elevationGainMeters": {
"description": "Cumulative elevation gain in meters.",
"minimum": 0,
"type": "integer"
},
"elevationLossMeters": {
"description": "Cumulative elevation loss in meters.",
"minimum": 0,
"type": "integer"
},
"energyKilojoules": {
"description": "Total mechanical work in kilojoules (session.total_work or avgPowerWatts * movingDurationSeconds / 1000).",
"minimum": 0,
"type": "integer"
},
"maxHeartRateBpm": {
"description": "Maximum recorded heart rate in beats per minute.",
"maximum": 300,
"minimum": 0,
"type": "integer"
},
"maxPowerWatts": {
"description": "Maximum power output in watts.",
"minimum": 0,
"type": "integer"
},
"maxSpeedMps": {
"description": "Maximum recorded speed in meters per second.",
"type": "string"
},
"movingDurationSeconds": {
"description": "Active moving duration excluding pauses in seconds.",
"minimum": 0,
"type": "integer"
},
"movingTimeSeconds": {
"description": "[Deprecated: use movingDurationSeconds] Total moving time excluding pauses in seconds.",
"minimum": 0,
"type": "integer"
},
"temperatureCelsius": {
"description": "Average ambient temperature in degrees Celsius.",
"type": "integer"
}
},
"type": "object"
}
},
"id": "world.treeline.activity.record",
"lexicon": 1
}