roque-nights.netlify.app

{
  "type": "object",
  "properties": {
    "from_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First evening of the range, YYYY-MM-DD (inclusive)."
    },
    "to_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last evening of the range, YYYY-MM-DD (inclusive). At most 62 nights from from_date."
    },
    "site": {
      "type": "object",
      "description": "Observing site to compute for. Omit to use the site currently shown in the app. Otherwise name a dark-sky catalog site with id (preferred) or name, OR pass BOTH latitude and longitude, plus time_zone (IANA, e.g. \"Pacific/Honolulu\") if you want local times; without a zone only UTC is returned. An object that does neither comes back as invalid_site with a hint. Answering for a site here does NOT move the app: to change the site the page itself shows, call the tool set_observing_site (the page also carries a declarative form named set_observing_site_form, and both go through the same validation).",
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 40,
          "description": "Dark-sky catalog id such as roque, mauna-kea, paranal; preferred over coordinates because it brings the exact elevation and IANA zone."
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Decimal degrees, north positive."
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Decimal degrees, EAST positive (Mauna Kea is -155.47)."
        },
        "elevation_m": {
          "type": "number",
          "minimum": -430,
          "maximum": 9000
        },
        "time_zone": {
          "type": "string",
          "description": "IANA time zone name."
        },
        "name": {
          "type": "string",
          "maxLength": 80,
          "description": "Catalog site name (\"Mauna Kea\", matched loosely) when you pass no coordinates, or the label for the coordinates when you do."
        }
      },
      "additionalProperties": false
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 62,
      "default": 10,
      "description": "How many of the best nights to return in full detail."
    }
  },
  "required": [
    "from_date",
    "to_date"
  ],
  "additionalProperties": false
}