Chargement du Playground
curl -X POST https://api.occultapi.com/api/astro/eclipse/visibility-path/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-01-01T00:00:00+00:00","timezone_as_float":0,"eclipse_type":"total","direction":"after","samples":24}'Les lieux où une éclipse de Soleil est totale, sous forme de ligne de coordonnées à tracer sur une carte. Trouve la prochaine éclipse de Soleil à partir du moment indiqué, échantillonne le point où l’axe de l’ombre de la Lune rencontre la Terre, puis renvoie des paires latitude/longitude ordonnées. Pour l’éclipse totale du 2026-08-12, cette trajectoire part de l’Arctique sibérien, passe au-dessus du pôle, descend sur l’Islande et sort dans l’Atlantique au large de la péninsule Ibérique — c’est elle qui détermine si un lieu voit une éclipse totale ou partielle. La plage échantillonnée est la totalité (ou l’annularité), et non l’éclipse entière. En dehors, l’axe de l’ombre manque complètement la Terre et il n’y a pas de ligne de centralité : une éclipse purement partielle renvoie donc une trajectoire vide, avec path_traced_over à "none", plutôt qu’une ligne qui n’existe pas. Les points où l’axe manque la Terre sont écartés : sample_count peut donc être inférieur au nombre d’échantillons demandé. Renvoie aussi le point de plus grande éclipse avec sa magnitude, son obscuration, sa série de Saros et son numéro de membre — l’identifiant qui sert d’index aux catalogues d’éclipses. Les heures de la trajectoire sont en UTC, avec le suffixe Z. Une trajectoire traverse le globe : le décalage qu’utilisent les autres endpoints d’éclipse serait trompeur pour un point situé à l’autre bout du monde. Les limites de l’ombre et de la pénombre ne sont pas renvoyées : ce calcul ne détermine que la ligne de centralité, et renvoyer les emplacements vides reviendrait à publier 0N 0E comme limite.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| date_time | string (date-time) | obligatoire | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. |
| centrality | string | facultatif | Centrale signifie que l’axe de l’ombre de la Lune touche réellement la Terre. N’a de sens que lorsque eclipse_type n’est pas 'any'. anycentralnon-central |
| direction | string | facultatif | Rechercher vers l’avant à partir de date_time, ou vers l’arrière. afterbefore |
| eclipse_type | string | facultatif | Limiter la recherche à un seul type d’éclipse de Soleil. anytotalannularpartialhybrid |
| elevation | number (double) | facultatif | |
| keys | array | facultatif | Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. |
| latitude | number (double) | facultatif | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. |
| longitude | number (double) | facultatif | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. |
| samples | integer | facultatif | Nombre de points à tracer le long de la trajectoire. Plus il est élevé, plus le tracé est lisse ; 120 au maximum. min 2 · max 120 |
| timezone_as_float | number (double) | facultatif | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14 |