API Astronomi: Fase Bulan & Prediksi Gerhana untuk Aplikasi Muslim & Astronomi

Aplikasi muslim dan astronomi kerap butuh fase bulan: untuk mengonfirmasi awal bulan Hijriah, menandai malam purnama, atau menjadwalkan sesi observasi. API Astronomi menyediakannya tanpa dataset eksternal.

Fase bulan hari ini

GET /api/v1/astronomi/moon mengembalikan penerangan, nama fase (Indonesia & Inggris), usia siklus, dan perkiraan jarak bulan.

curl "https://use.apiindonesia.id/api/v1/astronomi/moon?tanggal=2026-02-12" \
  -H "x-api-key: aip_live_xxx"

{
  "data": {
    "illumination": 0.98,
    "phaseName": "Bulan Purnama",
    "phaseNameEn": "Full Moon",
    "age": 14.7,
    "visiblePercent": 98,
    "trend": "waxing"
  }
}

Fase besar berikutnya

GET /api/v1/astronomi/moon/next mencantumkan fase besar berikutnya — baru, kuartil awal, purnama, kuartil akhir — lengkap dengan jumlah hari ke depan.

curl "https://use.apiindonesia.id/api/v1/astronomi/moon/next?tanggal=2026-01-01&count=4" \
  -H "x-api-key: aip_live_xxx"

{
  "data": [
    { "phase": "first_quarter", "name": "Kuartil Awal", "date": "2026-01-05", "daysUntil": 4 },
    { "phase": "full", "name": "Bulan Purnama", "date": "2026-01-13", "daysUntil": 12 }
  ]
}

Prediksi gerhana

GET /api/v1/astronomi/gerhana memprediksi gerhana matahari & bulan yang akan datang berdasarkan aproksimasi siklus saros/draconic. Tanggal dan jenis bersifat indikatif — cocok untuk daftar peristiwa mendatang di aplikasi, bukan penelitian presisi.

curl "https://use.apiindonesia.id/api/v1/astronomi/gerhana?tanggal=2026-01-01&days=730" \
  -H "x-api-key: aip_live_xxx"

Pasangan untuk Hijriah & Sholat

API Astronomi melengkapi Jadwal Sholat (terbit/terbenam dipakai untuk Subuh/Maghrib) dan Kalender Hijriah (fase bulan sebagai konteks visual purnama/awal bulan). Semuanya dihitung dari rumus publik NOAA/USNO — lisensi MIT, aman komersial, tanpa dependensi sumber data hulu.

Lihat dokumentasi lengkap di /produk/astronomi.