🌙 Calculateur de Nakshatra Précis

Étape 1: Inscription (Gratuite)

1. Allez sur astronomyapi.com/auth/register
2. Créez un compte gratuit (email + mot de passe)
3. Confirmez votre email

Étape 2: Créer une Application

1. Connectez-vous au dashboard
2. Cliquez sur "Create Application"
3. Nom: "Nakshatra Calculator"
4. Description: "Calcul de Nakshatras védiques"
5. Notez votre Application ID et Application Secret

Étape 3: Configuration du Code

// Dans le fichier PHP, remplacez ces lignes (ligne ~25-26) :
private const ASTRONOMY_API_ID = 'YOUR_ASTRONOMY_API_ID';
private const ASTRONOMY_API_SECRET = 'YOUR_ASTRONOMY_API_SECRET';

// Par vos vraies clés :
private const ASTRONOMY_API_ID = 'votre_application_id_ici';
private const ASTRONOMY_API_SECRET = 'votre_application_secret_ici';

Étape 4: Test

Une fois configuré, le système utilisera automatiquement AstronomyAPI pour des calculs de haute précision. En cas d'erreur ou de quota dépassé, il basculera automatiquement sur VSOP87.

Pour utiliser les APIs externes, modifiez ces parties du code:

1. Swiss Ephemeris (Recommandé)

// Installation: composer require kylekatarnls/php-swiss-ephemeris
use SwissEphemeris\SwissEphemeris;

private function getMoonPositionSwissEph($date, $lat, $lon) {
    $swe = new SwissEphemeris();
    $jd = $this->dateToJulianDay($date);
    
    $result = $swe->calc_ut($jd, SwissEphemeris::SE_MOON, SwissEphemeris::SEFLG_SWIEPH);
    
    return [
        'longitude' => $result[0], // Longitude géocentrique
        'latitude' => $result[1],  // Latitude géocentrique
        'distance' => $result[2],  // Distance en UA
        'source' => 'Swiss Ephemeris'
    ];
}

2. AstronomyAPI

private function getMoonPositionAstronomyAPI($date, $lat, $lon) {
    $apiKey = 'VOTRE_CLE_API'; // Obtenir sur astronomyapi.com
    $url = 'https://api.astronomyapi.com/api/v2/positions/moon';
    
    $headers = [
        'Authorization: Basic ' . base64_encode($apiKey . ':'),
        'Content-Type: application/json'
    ];
    
    $data = [
        'format' => 'json',
        'style' => 'default',
        'observer' => [
            'latitude' => $lat,
            'longitude' => $lon,
            'date' => $date->format('Y-m-d')
        ],
        'view' => [
            'type' => 'constellation'
        ]
    ];
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    $result = json_decode($response, true);
    
    return [
        'longitude' => $result['data']['position']['horizontal']['azimuth'],
        'source' => 'AstronomyAPI'
    ];
}

3. Configuration Complète

// Ajoutez ces constantes en haut de la classe
private const ASTRONOMY_API_KEY = 'votre_cle_astronomyapi';
private const IPGEOLOCATION_API_KEY = 'votre_cle_ipgeolocation';

// Méthode principale avec fallbacks
public function getMoonPositionFromAPI($date, $latitude = 0, $longitude = 0) {
    // 1. Essayer Swiss Ephemeris (le plus précis)
    if (class_exists('SwissEphemeris\SwissEphemeris')) {
        return $this->getMoonPositionSwissEph($date, $latitude, $longitude);
    }
    
    // 2. Essayer AstronomyAPI
    if (!empty(self::ASTRONOMY_API_KEY)) {
        $result = $this->getMoonPositionAstronomyAPI($date, $latitude, $longitude);
        if ($result) return $result;
    }
    
    // 3. Essayer IPGeolocation
    if (!empty(self::IPGEOLOCATION_API_KEY)) {
        $result = $this->getMoonPositionIPGeo($date, $latitude, $longitude);
        if ($result) return $result;
    }
    
    // 4. Fallback vers calcul VSOP87
    return $this->getMoonPositionVSOP87($date);
}

💡 Conseils d'Implémentation

1. Pour la production: Utilisez Swiss Ephemeris pour une précision maximale
2. Pour les tests: L'implémentation VSOP87 actuelle est suffisante
3. Cache: Mettez en cache les résultats pour éviter les appels API répétés
4. Fallbacks: Implémentez plusieurs sources pour la fiabilité
5. Géolocalisation: OpenStreetMap Nominatim est gratuit et fiable

⚠️ Notes Importantes

• Les calculs de Nakshatra nécessitent le système Nirayana (sidéral)
• L'Ayanamsa de Lahiri est le standard en astrologie védique (≈24.12° en 2024)
• Pour une précision optimale, utilisez les coordonnées exactes du lieu de naissance
• Les APIs gratuites ont des limites de taux - implémentez la mise en cache