EclipseMission

Every place EclipseMission has measured for the total solar eclipse of 2 August 2027, in the order of the site's ranking: the places every reader can go to, ranked by lodging price per person, cheapest first, then Mecca, priced but unranked (entry restricted to Muslims). For each: totality duration (our validated oracle), lodging for two adults over four nights, 31 July to 4 August 2027 (mean of the ten cheapest rooms, dated), the Eclipse Premium (that price over the same search a week later), cloud as a range of two reanalyses, heat, public-transport access, the nearest airport and our one-word verdict. Filters narrow the list; they never reorder it.

{
  "type": "object",
  "properties": {
    "max_price_per_person_eur": {
      "type": "number",
      "minimum": 0,
      "description": "Keep places whose four-night stay costs at most this per person, in EUR (the price for two, halved)."
    },
    "min_totality_seconds": {
      "type": "number",
      "minimum": 0,
      "description": "Keep places with at least this much totality, in seconds (the longest on our list is about 381)."
    },
    "country": {
      "type": "string",
      "description": "Keep one country, by English name or ISO code, whatever the case: Egypt, Gibraltar, Morocco, Saudi Arabia, Spain, Tunisia."
    },
    "open_to_all_visitors": {
      "type": "boolean",
      "description": "true leaves out places whose entry is restricted (Mecca, closed to non-Muslims)."
    }
  },
  "additionalProperties": false
}

Everything EclipseMission holds on one place, each figure with its source and reading day: the eclipse (duration, and contact times where our oracle has them), lodging (eclipse week, week after, the two eclipse nights, solo traveller and hostels where measured, with the ten prices behind each mean), sky, heat, entry regime by passport, the cost of the observation itself, access and the airfares read to its airport.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "enum": [
        "mecca",
        "chefchaouen",
        "tangier",
        "jeddah",
        "djerba",
        "tetouan",
        "marsa-alam",
        "siwa-oasis",
        "luxor",
        "cadiz",
        "gibraltar"
      ],
      "description": "The destination key, as list_destinations returns it."
    },
    "passport": {
      "type": "string",
      "enum": [
        "FR",
        "GB",
        "US",
        "CA",
        "SA",
        "AE",
        "MA"
      ],
      "description": "ISO code of the traveller's passport: returns that passport's entry regime in full. Without it, one short line per passport we cover."
    }
  },
  "required": [
    "destination"
  ],
  "additionalProperties": false
}

The figures a choice between places turns on, for two to four destinations at once, in the order of the site's ranking whatever the order asked: totality and its times, lodging (eclipse-week mean, per person, Eclipse Premium, reading day), both ends of the cloud range, heat, access, airport, the cost of the observation, and the entry regime of one passport or of each passport we cover. get_destination has the rest.

{
  "type": "object",
  "properties": {
    "destinations": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "mecca",
          "chefchaouen",
          "tangier",
          "jeddah",
          "djerba",
          "tetouan",
          "marsa-alam",
          "siwa-oasis",
          "luxor",
          "cadiz",
          "gibraltar"
        ]
      },
      "minItems": 2,
      "maxItems": 4,
      "uniqueItems": true,
      "description": "Two to four destination keys, as list_destinations returns them."
    },
    "passport": {
      "type": "string",
      "enum": [
        "FR",
        "GB",
        "US",
        "CA",
        "SA",
        "AE",
        "MA"
      ],
      "description": "ISO code of the traveller's passport. Without it, one short line per passport we cover."
    }
  },
  "required": [
    "destinations"
  ],
  "additionalProperties": false
}

The destinations that fit one traveller, in the order of the site's ranking, each with its lodging figure, totality and sky, the entry regime of their passport, and the fares we have read from their airport to it. The fares and the stay are given side by side, never summed: they are different searches, read on different days. A place with no fare read from that airport is kept, with a note: that is a gap in our readings, not a claim that no flight exists.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "IATA code of the departure airport, e.g. MAD."
    },
    "passport": {
      "type": "string",
      "enum": [
        "FR",
        "GB",
        "US",
        "CA",
        "SA",
        "AE",
        "MA"
      ],
      "description": "ISO code of the traveller's passport: each place then carries that passport's entry regime."
    },
    "max_price_per_person_eur": {
      "type": "number",
      "minimum": 0,
      "description": "Keep places whose four-night stay costs at most this per person, in EUR."
    },
    "min_totality_seconds": {
      "type": "number",
      "minimum": 0,
      "description": "Keep places with at least this much totality, in seconds."
    },
    "country": {
      "type": "string",
      "description": "Keep one country, by English name or ISO code, whatever the case: Egypt, Gibraltar, Morocco, Saudi Arabia, Spain, Tunisia."
    },
    "open_to_all_visitors": {
      "type": "boolean",
      "description": "true leaves out places whose entry is restricted (Mecca, closed to non-Muslims)."
    }
  },
  "additionalProperties": false
}

The airfares EclipseMission has read, each dated and sourced. Two families that must never be added together: Google Flights searches (return trip, two adults, as the search displayed it) and easyJet fares read at the airline (one seat, one way). Filter by departure airport, destination, or both. A route we have not read is absent, which is not a claim that no flight exists.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "IATA code of the departure airport, e.g. CDG."
    },
    "destination": {
      "type": "string",
      "enum": [
        "mecca",
        "chefchaouen",
        "tangier",
        "jeddah",
        "djerba",
        "tetouan",
        "marsa-alam",
        "siwa-oasis",
        "luxor",
        "cadiz",
        "gibraltar"
      ],
      "description": "The destination key, as list_destinations returns it."
    }
  },
  "additionalProperties": false
}

Points along the path of the 2 August 2027 eclipse for which our oracle computed totality once — towns, capes, peaks, monuments — with the cloud range of two reanalyses at each. Points, not destinations: nothing was priced there and no entry or access was read. Points outside the path carry no totality. No coordinates are taken: the list is fixed, and a place absent from it has not been computed.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Keep one country, by ISO code or English name, whatever the case, e.g. ES or Spain."
    },
    "min_totality_seconds": {
      "type": "number",
      "minimum": 0,
      "description": "Keep points with at least this much totality, in seconds."
    },
    "max_cloud_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Keep points whose cloud range stays at or under this percentage at its high end."
    },
    "in_path": {
      "type": "boolean",
      "description": "true keeps points inside the path of totality, false those outside."
    },
    "sort": {
      "type": "string",
      "enum": [
        "name",
        "totality"
      ],
      "description": "name (default) is the order of the file; totality puts the longest first."
    }
  },
  "additionalProperties": false
}