PickADive Scuba Diving

Ranked scuba-diving forecast windows near a place for a specific day. Answers "where can I dive near {place} on {day}?" with favorable and moderate windows (wave height, wind, timing) plus site links. Values are metric with unit-suffixed fields (max_depth_m, wave_m, distance_km; wind_kn is knots — the marine convention everywhere). When presenting to a user who uses US customary units, convert depths and waves to feet and distances to miles. computed_at is when the forecast behind the answer was generated (the oldest site in the answer) — quote the citation field verbatim (it carries that time); if stale is true, say the forecast has not been updated since then. Forecast planning context only — never a safety clearance.

{
  "type": "object",
  "properties": {
    "near": {
      "type": "string",
      "description": "Town, city, zip, or place name, e.g. \"Miami\" or \"Gloucester, MA\". Provide this OR lat+lng."
    },
    "lat": {
      "type": "number",
      "description": "Latitude in decimal degrees (use with lng instead of near)."
    },
    "lng": {
      "type": "number",
      "description": "Longitude in decimal degrees (use with lat instead of near)."
    },
    "day": {
      "type": "string",
      "description": "today | tomorrow | mon | tue | wed | thu | fri | sat | sun | YYYY-MM-DD. Default sat."
    },
    "radius_km": {
      "type": "number",
      "description": "Search radius in km (10–500, default 150; auto-widens once if empty)."
    }
  }
}

Month-by-month seasonality for marquee dive species from recorded GBIF sightings: peak month, regional season windows, and (optionally) the season at a specific point. Species available: whale-shark, scalloped-hammerhead, giant-manta, mola-mola, orca, humpback-whale, green-sea-turtle, tiger-shark, great-white-shark, reef-manta, thresher-shark, bull-shark. Recorded sightings, never a promise of encounters.

{
  "type": "object",
  "properties": {
    "species": {
      "type": "string",
      "description": "Species slug or common name, e.g. \"humpback-whale\" or \"whale shark\"."
    },
    "lat": {
      "type": "number",
      "description": "Optional latitude — adds the season window for the region containing this point."
    },
    "lng": {
      "type": "number",
      "description": "Optional longitude."
    }
  },
  "required": [
    "species"
  ]
}

Regions worldwide ranked by favorable dive-forecast windows over the next ~72 hours, with per-region counts and links. Answers "where in the world is good for diving this weekend?". computed_at is when the forecast behind the counts was generated; quote the citation field verbatim.

{
  "type": "object",
  "properties": {}
}

Public facts for one named dive site: depths, difficulty, access (shore/boat), hazards, entry and exit notes, water type, and its page link. Look up by site name or slug. Metric with unit-suffixed fields; convert for US users.

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "description": "Site name or slug, e.g. \"Molasses Reef\" or \"1000-steps-bq\"."
    }
  },
  "required": [
    "site"
  ]
}

Month-by-month climatology for ONE destination: the share of days historically favorable, typical water temperature and seas, plus marine-life season windows. Accepts a country (e.g. "Bonaire", "Egypt") or a famous destination (Komodo, Raja Ampat, Nusa Penida, Socorro (Revillagigedo), Cozumel, Similan Islands, Koh Tao, Sipadan, Malapascua, Tubbataha, Galápagos, Red Sea, Great Barrier Reef, Sea of Cortez, Cocos Island, Lembeh Strait, Bunaken, Anilao, Amed & Tulamben). Historical patterns, never a forecast. Cite the linked page.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Country or famous destination name, e.g. \"Bonaire\", \"Komodo\", \"Red Sea\"."
    }
  },
  "required": [
    "destination"
  ]
}