# Hike

A hike with its facts and its spot and place links.

Group: Objects.

## Fields

- `hikeId` (string, required): The hike's id.
- `name` (string or null, required): The hike's name.
- `difficulty` (string or null, required): easy, moderate, hard or expert; null when unset. One of `easy`, `moderate`, `hard`, `expert`.
- `grade` (string or null, required): The grade as written (T3, K2, Class 3); null when unset.
- `durationMin` (number or null, required): Walking time in minutes.
- `gainM` (number or null, required): Elevation gain in meters.
- `descentM` (number or null, required): Descent in meters.
- `distanceKm` (number or null, required): Distance in kilometers.
- `start` (string or null, required): The trailhead in words.
- `startMapsUrl` (string or null, required): Map link to the trailhead.
- `transit` (array of TransitNote, required): Transit notes per mode.
  Fields of TransitNote: https://developers.sceniq.earth/fields/transit-note.md
- `description` (string or null, required): The hike in the creator's words.
- `equipment` (array of strings or null, required): Gear; [] means explicitly none, null means unknown.
- `sources` (array of strings, required): Where the facts come from.
- `track` (HikeTrack or null, required): The hike's line.
  Fields of HikeTrack: https://developers.sceniq.earth/fields/hike-track.md
- `createdAt` (number, required): When the row was created (Unix time in milliseconds).
- `updatedAt` (number, required): When the row last changed (Unix time in milliseconds).
- `spots` (array of objects, required): The spots the hike goes to, in order.
  - `spotKey` (string, required): The spot's key.
  - `order` (number, required): Position on the hike.
- `facilities` (array of objects, required): The places the hike uses, in order.
  - `facilityId` (string, required): The place's id: its helper pin's spot id (a place written before helpers keeps answering to its old id).
  - `order` (number, required): Position on the hike.

## Used by

- [list_hikes](https://developers.sceniq.earth/reference/list_hikes.md)
- [create_hike](https://developers.sceniq.earth/reference/create_hike.md)