Thèmes Natals

Calculez des thèmes natals complets avec les positions planétaires, les cuspides de maisons et les aspects.

Calcul de Base

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Paramètres

Paramètre	Type	Requis	Description
datetime	string	Oui	Date/heure ISO 8601
latitude	number	Oui	Latitude (-90 à 90)
longitude	number	Oui	Longitude (-180 à 180)
timezone	string	Oui	Identifiant de fuseau horaire IANA
houseSystem	string	Non	Système de maisons (défaut : "placidus")

Systèmes de Maisons

• placidus - Placidus (défaut)
• koch - Koch
• equal - Maison Égale
• whole - Signe Entier
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyre

Réponse

{
  "data": {
    "type": "natal-chart",
    "attributes": {
      "planets": {
        "sun": { "longitude": 84.5, "latitude": 0, "sign": "gemini", "house": 10 },
        "moon": { "longitude": 245.2, "latitude": -3.1, "sign": "sagittarius", "house": 4 }
      },
      "houses": {
        "1": { "cusp": 180.5, "sign": "libra" },
        "2": { "cusp": 210.3, "sign": "scorpio" }
      },
      "aspects": [
        { "planet1": "sun", "planet2": "moon", "aspect": "opposition", "orb": 0.7 }
      ]
    }
  }
}

Corps Célestes Inclus

Par défaut, les corps célestes suivants sont inclus :

• Soleil, Lune
• Mercure, Vénus, Mars, Jupiter, Saturne, Uranus, Neptune, Pluton
• Nœud Nord, Nœud Sud
• Chiron, Lilith (Lune Noire)
• Part de Fortune

Lune & Soleil

Calculez la phase lunaire, l'illumination, les heures de lever/coucher et les données de position du soleil.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Paramètres

Paramètre	Type	Requis	Description
dateTime	string	Oui	Date/heure au format YYYY-MM-DDTHH:mm
location.latitude	number	Oui	Latitude (-90 à 90)
location.longitude	number	Oui	Longitude (-180 à 180)
location.timezone	string	Oui	Identifiant de fuseau horaire IANA

Module Requis

Cet endpoint nécessite le module module:moon.

Réponse

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Précision des Calculs

AstroAPI utilise l'Éphéméride Suisse pour des calculs de haute précision. Toutes les positions sont calculées avec une précision à la seconde d'arc.

Bêta : Moteur de Calcul Alternatif

Fonctionnalité Expérimentale

Cette fonctionnalité est en bêta et peut présenter des problèmes de précision. À utiliser avec prudence dans les environnements de production.

AstroAPI propose un moteur de calcul alternatif (calc2) qui utilise une implémentation personnalisée pour lire et évaluer directement les fichiers de données SE1 de l'Éphéméride Suisse, au lieu d'utiliser la bibliothèque officielle de l'Éphéméride Suisse. Ce moteur est optimisé pour la vitesse et peut fournir des temps de réponse plus rapides.

Pour utiliser le moteur alternatif, incluez l'en-tête X-Use-Calc2 dans votre requête :

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "X-Use-Calc2: true" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Différences Clés

Aspect	Moteur Standard	Moteur Calc2 (Bêta)
Implémentation	Éphéméride Suisse	Implémentation personnalisée
Source de Données	Fichiers éphémérides SE1	Fichiers éphémérides SE1 (mêmes données)
Vitesse	Standard	Potentiellement plus rapide
Précision	Précision à la seconde d'arc (référence)	Peut présenter de légères déviations
Statut	Prêt pour la production	Bêta

Quand Utiliser Calc2

• Recommandé pour : Les applications à volume élevé où la vitesse est prioritaire sur la précision absolue
• Déconseillé pour : Les applications nécessitant une précision astronomique maximale

Limitations Connues

• L'implémentation personnalisée peut produire des résultats légèrement différents par rapport à la bibliothèque officielle de l'Éphéméride Suisse
• Encore en développement actif et en test
• Les résultats doivent être validés par rapport au moteur standard pour les applications critiques