Open data
The tables behind this site's pages are available as CSV and JSON. Same figures, same source: they come out of the calculators' Besselian engine, never from manual entry. Every town carries its coordinates — enough to build a map without geocoding anything.
The files
The CSV carries five header lines prefixed with “#”: source, licence and method. Spreadsheets and the usual libraries skip them.
Licence
CC BY 4.0. You may reuse, transform and republish this data, commercially included, on the single condition that you credit the source with a link. The credit already travels in the files' header. CC BY 4.0
The credit to reuse
Place it under your map or table.
<a href="https://solunareclipse.com/en/calculateur-2027">Data: Solunareclipse</a> — CC BY 4.0What the columns hold
- lat, lon — coordinates of the exact point computed, in decimal degrees.
- phase — total, annular or partial: what the town sees. A “partial” row lies outside the central band.
- c1, c2, c3, c4 — the four contacts. c1 and c4 bracket the partial phase, c2 and c3 the central phase. max gives the time of maximum for towns outside the band.
- duration_s — duration of the central phase, in seconds.
- obscuration_pct — share of the solar disc covered at maximum, for towns outside the band.
- sun_alt_deg — Sun altitude at mid central phase, in degrees. Below 10°, a hill or a building is enough to ruin it.
Preview
| name | lat | lon | c2 | c3 | duration_s |
|---|---|---|---|---|---|
| Ceuta | 35.8894 | -5.3213 | 10:45:18 | 10:50:06 | 288 |
| Tarifa | 36.0016 | -5.6094 | 10:45:04 | 10:49:44 | 280 |
| Melilla | 35.2923 | -2.9381 | 10:48:11 | 10:52:44 | 273 |
| Algeciras | 36.1275 | -5.4536 | 10:45:23 | 10:49:51 | 268 |
| Gibraltar | 36.1408 | -5.3536 | 10:45:31 | 10:49:58 | 267 |
| Zahara de los Atunes | 36.1361 | -5.8483 | 10:44:58 | 10:49:22 | 264 |
id, name, lat, lon, phase, c1, c2, c3, c4, max, duration_s, obscuration_pct, sun_alt_deg
Method and sources
Ephemerides
The calculator first queries the IMCCE's OPALE API (Paris Observatory), INPOP19A ephemerides, accurate to about a second. If it does not answer, it falls back on the polynomial Besselian elements published by NASA/GSFC (Fred Espenak) for that eclipse.
Geometric criterion
A point lies inside the path if the minimum over time of « distance to the shadow axis minus shadow radius » turns negative. The same criterion drives a city's readout, the drawn path limits and the animated shadow: the three cannot contradict one another.
Measured precision
The Besselian fallback was cross-checked against INPOP19A for twelve cities across the three eclipses: contact times differ by 1 to 10 seconds, and path membership agrees everywhere except for one city sitting exactly on the limit. The tables above come from that same engine.