# Spot

A spot as list_spots returns it.

Group: Objects.

## Fields

- `spotId` (string, required): The spot's id.
- `spotKey` (string, required): The spot's stable key within the guide; chapters and routes reference spots by it.
- `productId` (string, required): The guide the spot belongs to.
- `title` (string, required): The place name.
- `kicker` (string or null, required): The short line above the title (region or type).
- `lat` (number or null, required): Latitude in decimal degrees, or null when the pin is not set yet.
- `lon` (number or null, required): Longitude in decimal degrees, or null when the pin is not set yet.
- `mapsUrl` (string or null, required): The creator's own map link.
- `shortDescription` (string or null, required): One or two sentences for the card.
- `longDescription` (string or null, required): The full write-up.
- `color` (string or null, required): Pin color as a hex value, or null for the default.
- `cardOrientation` (string, required): Photo framing in the viewer. One of `portrait`, `landscape`.
- `customValues` (map of values, required): Custom property values keyed by property key; option values are option ids.
- `tripFacts` (TripFacts or null, required): The planning stats bar.
  Fields of TripFacts: https://developers.sceniq.earth/fields/trip-facts.md
- `arrival` (Arrival or null, required): How to get there.
  Fields of Arrival: https://developers.sceniq.earth/fields/arrival.md
- `mapLinks` (array of MapLink, required): Extra map links, drawn as map pills.
  Fields of MapLink: https://developers.sceniq.earth/fields/map-link.md
- `imagesEnabled` (boolean, required): false hides the photo section from buyers.
- `customPropsEnabled` (boolean, required): false hides the custom properties from buyers.
- `archived` (boolean, required): true when the spot is hidden from buyers but kept.
- `ref` (string or null, required): Your own stable key for upsert_spots.
- `accessMode` (string or null, required): How visitors reach the spot, shown as Accessibility. One of `drive_up`, `short_walk`, `hike`, `multi_day`, `boat`, `cable_car`, `train`, `flight`, `tour_only`, `aerial_only`.
- `pinLabel` (string or null, required): What the main pin marks, for a spot that is an area or a line.
- `pins` (array of SpotPin, required): Extra points: viewpoints, entrances, trailheads, parking.
  Fields of SpotPin: https://developers.sceniq.earth/fields/spot-pin.md
- `links` (array of GuideLink, required): Links with a purpose.
  Fields of GuideLink: https://developers.sceniq.earth/fields/guide-link.md
- `status` (StatusNotice or null, required): A closure or works notice.
  Fields of StatusNotice: https://developers.sceniq.earth/fields/status-notice.md
- `fees` (array of Fee, required): Fees and tickets.
  Fields of Fee: https://developers.sceniq.earth/fields/fee.md
- `schedule` (Schedule or null, required): Structured opening hours.
  Fields of Schedule: https://developers.sceniq.earth/fields/schedule.md
- `features` (array of SpotFeature, required): Parts of the site with their own rules.
  Fields of SpotFeature: https://developers.sceniq.earth/fields/spot-feature.md
- `restrictions` (array of Restriction, required): Rules on site.
  Fields of Restriction: https://developers.sceniq.earth/fields/restriction.md
- `events` (array of SpotEvent, required): Events worth timing a visit for.
  Fields of SpotEvent: https://developers.sceniq.earth/fields/spot-event.md
- `food` (FoodNote or null, required): Why the spot lists no food places.
  Fields of FoodNote: https://developers.sceniq.earth/fields/food-note.md
- `areaId` (string or null, required): The area (park, island, region) the spot sits in.
- `timeZone` (string or null, required): IANA time zone, derived from the pin unless set by hand.
- `timeZoneManual` (boolean, required): true when the time zone was set by hand rather than from the pin.
- `customNotes` (map of strings, required): One short note per custom property value, keyed by property key.
- `sources` (array of SourceRef, required): Research evidence for the review, never shown to buyers.
  Fields of SourceRef: https://developers.sceniq.earth/fields/source-ref.md
- `reviewNotes` (string or null, required): Notes for the creator's review, never shown to buyers.
- `factsCheckedOn` (string or null, required): The day the facts were last checked (YYYY-MM-DD).
- `reviewBy` (string or null, required): The day the facts need a new check (YYYY-MM-DD).
- `siteChange` (SiteChange or null, required): The day something at the spot changed.
  Fields of SiteChange: https://developers.sceniq.earth/fields/site-change.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).

## Used by

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