# world.treeline.waypoint.record

> Published by [treeline.world](https://lexicon.garden/identity/did:plc:sjejpugpajgvxweilujzjcmq)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:sjejpugpajgvxweilujzjcmq/world.treeline.waypoint.record)
- [Documentation](https://lexicon.garden/lexicon/did:plc:sjejpugpajgvxweilujzjcmq/world.treeline.waypoint.record/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:sjejpugpajgvxweilujzjcmq/world.treeline.waypoint.record/examples)

## Definitions

### `world.treeline.waypoint.record`

**Type**: `record`

A backcountry point of interest, water source, campsite, summit, or hazard.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `activity` | `ref` → `com.atproto.repo.strongRef` | No | Optional reference to the activity record where this waypoint was logged. |
| `category` | `string` | Yes | Classification category for the waypoint. |
| `createdAt` | `string` (datetime) | Yes | Creation timestamp. |
| `description` | `string` | No | Detailed notes, condition report, flow rate, or access directions. |
| `images` | `array` | No | Photos of the waypoint or feature. |
| `location` | `ref` → `#pointLocation` | Yes | Geographical location coordinates for the waypoint. |
| `route` | `ref` → `com.atproto.repo.strongRef` | No | Optional reference to the route record associated with this waypoint. |
| `status` | `string` | No | Current or known condition status (e.g., reliable water, washed out bridge). |
| `title` | `string` | Yes | Name or title of the waypoint (e.g. Upper Creek Spring, High Pass Bivy). |

### `world.treeline.waypoint.record#pointLocation`

**Type**: `object`

Point coordinates and optional elevation.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `elevationMeters` | `integer` | No | Elevation above sea level in meters. |
| `latitude` | `unknown` | Yes | Latitude in decimal degrees (-90 to 90). |
| `longitude` | `unknown` | Yes | Longitude in decimal degrees (-180 to 180). |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A backcountry point of interest, water source, campsite, summit, or hazard.",
      "key": "tid",
      "record": {
        "properties": {
          "activity": {
            "description": "Optional reference to the activity record where this waypoint was logged.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "category": {
            "description": "Classification category for the waypoint.",
            "knownValues": [
              "water_source",
              "campsite",
              "hazard",
              "summit",
              "viewpoint",
              "shelter",
              "trailhead",
              "junction",
              "resupply",
              "parking",
              "bridge",
              "gate",
              "aid_station",
              "toilet",
              "other"
            ],
            "type": "string"
          },
          "createdAt": {
            "description": "Creation timestamp.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Detailed notes, condition report, flow rate, or access directions.",
            "maxGraphemes": 2000,
            "maxLength": 20000,
            "type": "string"
          },
          "images": {
            "description": "Photos of the waypoint or feature.",
            "items": {
              "accept": [
                "image/png",
                "image/jpeg",
                "image/webp"
              ],
              "maxSize": 5000000,
              "type": "blob"
            },
            "maxLength": 4,
            "type": "array"
          },
          "location": {
            "description": "Geographical location coordinates for the waypoint.",
            "ref": "#pointLocation",
            "type": "ref"
          },
          "route": {
            "description": "Optional reference to the route record associated with this waypoint.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "status": {
            "description": "Current or known condition status (e.g., reliable water, washed out bridge).",
            "knownValues": [
              "reliable",
              "seasonal",
              "dry",
              "flowing",
              "open",
              "closed",
              "caution",
              "impassable",
              "verified"
            ],
            "type": "string"
          },
          "title": {
            "description": "Name or title of the waypoint (e.g. Upper Creek Spring, High Pass Bivy).",
            "maxGraphemes": 200,
            "maxLength": 2000,
            "type": "string"
          }
        },
        "required": [
          "title",
          "category",
          "location",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "pointLocation": {
      "description": "Point coordinates and optional elevation.",
      "properties": {
        "elevationMeters": {
          "description": "Elevation above sea level in meters.",
          "type": "integer"
        },
        "latitude": {
          "description": "Latitude in decimal degrees (-90 to 90).",
          "type": "unknown"
        },
        "longitude": {
          "description": "Longitude in decimal degrees (-180 to 180).",
          "type": "unknown"
        }
      },
      "required": [
        "latitude",
        "longitude"
      ],
      "type": "object"
    }
  },
  "id": "world.treeline.waypoint.record",
  "lexicon": 1
}
```