Sunshine Atlas

Ranked answer to "where is it sunny (and warm) in <month>?" — destinations sorted by that month's 0–100 Sunshine Score (long-term climate normals). Filter by continent or country, minimum daytime temperature, population, swimmable sea (≥21°C), or a ceiling on the midday UV index. Every result carries that month's temperatures, rain, midday UV (WHO scale) and sea temperature, plus a citable destinationsmap.com URL.

{
  "type": "object",
  "properties": {
    "month": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "Month name (\"November\", \"nov\") or number 1–12"
    },
    "where": {
      "description": "Optional continent (\"Europe\", \"Asia\", \"North America\", …) or country (name or ISO-2 code) to search within. \"Europe\" uses the traveler definition and includes the Canary Islands.",
      "type": "string"
    },
    "min_day_high_c": {
      "description": "Only places at least this warm by day that month, °C",
      "type": "number"
    },
    "require_swimmable_sea": {
      "description": "Only coastal places with sea ≥21°C that month",
      "type": "boolean"
    },
    "max_midday_uv": {
      "description": "Only places whose typical midday UV index that month is at or below this (WHO scale: ≤2 low, ≤5 moderate, ≤7 high). For sun-sensitive travellers — \"sunny but not fierce\".",
      "type": "number"
    },
    "min_population": {
      "description": "Only places with at least this population (default 0 = include small islands and outposts)",
      "type": "number"
    },
    "limit": {
      "description": "How many results (default 10, max 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "month"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full climate card for one destination: 0–100 Sunshine Score, day/night °C, rainfall, midday UV index (WHO scale) and sea temperature for all 12 months, plus its sunniest month ("best time to visit" for sunshine), annual sunshine hours and peak midday UV. Accepts a city name ("Faro"), "city, country" ("Nice, France") or IATA airport code ("FAO").

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "City name, \"city, country\", or 3-letter IATA airport code"
    }
  },
  "required": [
    "destination"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Side-by-side sunshine/climate comparison of 2–5 destinations — overall or for one month ("Algarve or Crete in October?"). Returns each place's Sunshine Score, temperatures, rain, midday UV index and sea temperature, plus a one-line verdict of which is sunnier.

{
  "type": "object",
  "properties": {
    "destinations": {
      "minItems": 2,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2–5 destinations (city, \"city, country\", or IATA code)"
    },
    "month": {
      "description": "Optional month to compare in; omit for year-round comparison",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    }
  },
  "required": [
    "destinations"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}