curl -X POST https://api.occultapi.com/api/astro/astrocartography/lines/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"node":"true","projection":"mundo"}'Toutes les lignes d’astrocartographie d’un moment de naissance, sous forme de coordonnées prêtes à tracer sur une carte. L’astrologie de relocalisation pose une question de géographie plutôt que de thème : non pas où se trouvait une planète dans le ciel, mais en quels lieux de la Terre elle se levait, se couchait, culminait ou passait au nadir au moment de la naissance. Ces quatre courbes par planète, tracées sur une carte du monde, forment la carte ACG. Vous obtenez quatre lignes pour chacun des douze corps. Les lignes MC et IC sont des méridiens : chacune se résume donc à une longitude. Les lignes AC et DC sont des courbes, renvoyées sous forme de liste de points latitude/longitude à passer directement à une polyligne — un point tous les cinq degrés de latitude par défaut, réglable avec latitude_step. Les courbes s’arrêtent là où le corps devient circumpolaire, et ce n’est pas une donnée manquante : au-delà d’une certaine latitude, le corps ne franchit plus du tout l’horizon, et il n’y a donc pas de ligne de lever à tracer. Cette limite varie d’une planète à l’autre, car elle dépend de la déclinaison. latitude et longitude ne sont facultatives que sur cet endpoint. Une ligne ACG ne dépend que du MOMENT de naissance — les formules n’utilisent que l’ascension droite, la déclinaison et le temps sidéral — et exiger un lieu de naissance laisserait croire qu’il change la réponse, ce qui n’est pas le cas. Utilisez /api/astro/astrocartography/relocate/ pour obtenir les lignes proches d’un lieu donné.
| 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. |
| timezone_as_float | number (double) | obligatoire | 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 |
| bodies | array | facultatif | Par défaut : les douze. Réduisez la liste pour alléger les réponses. |
| close_curves | boolean | facultatif | Ajouter des points qui prolongent chaque courbe AC/DC jusqu’à son extrémité : la latitude où le corps cesse de se lever et de se coucher, là où les courbes AC et DC rejoignent sa ligne MC ou IC. À activer pour le tracé ; désactivé (par défaut), seuls les échantillons régulièrement espacés sont renvoyés. |
| 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. |
| latitude_step | number (double) | facultatif | Degrés de latitude entre les points des courbes AC/DC. min 1 · max 15 |
| 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. |
| node | string | facultatif | Le nœud lunaire que représente `north_node` : true (par défaut) ou mean. truemean |
| projection | string | facultatif | mundo (par défaut) : positions vraies, latitude comprise. zodiac : positions projetées sur l’écliptique, qui correspondent 1:1 à un thème relocalisé. mundozodiac |