Hisabmu.org — KHGT, Kalender Hijriah Global Tunggal

Apa itu KHGT

Kalender Hijriah Global Tunggal

KHGT menetapkan satu tanggal awal bulan Hijriah yang berlaku untuk seluruh wilayah dalam satu zona kalender, berdasarkan kriteria tinggi hilal dan elongasi yang terukur secara astronomis — bukan rukyat lokal yang bisa berbeda antar wilayah.

📐

Kriteria tinggi & elongasi

Target tinggi hilal (mis. 5.0°) dan elongasi (mis. 8.0°) dihitung geosentrik sesuai titik pengamatan yang dipilih.

✅

PKG1 & PKG2

Dua garis kontingensi (Garis Perbatasan Kalender) dicek untuk setiap bulan — status "terpenuhi" atau "tidak terpenuhi" menentukan konsistensi tanggal antar wilayah.

🔁

Kontinjensi D+0/D+1

Jika kriteria PKG1/PKG2 gagal pada D+0, sistem otomatis dapat menyertakan kontur D+1 sebagai cadangan perhitungan.

API Hisabmu

Tiga API inti: KHGT, Jadwal Salat, dan Kiblat

Inti dari Hisabmu.org: data kalender KHGT, waktu salat, dan arah kiblat — semua tersedia sebagai endpoint JSON siap pakai, tanpa API key, untuk integrasi ke aplikasi apa pun.

API Kalender KHGT

Inti

Data induk KHGT per tahun dan bulan Hijriah: tanggal awal bulan, status PKG1/PKG2, dan metadata kriteria.

/api/khgt?dataset=induk&tahun=1448&bulan=1 Coba endpoint

API Jadwal Salat

Inti

Dokumentasi parameter untuk menghitung imsak, subuh, syuruq, duha, zuhur, asar, magrib, dan isya.

/api/jadwal-sholat/docs Lihat dokumentasi

API Kiblat

Inti

Azimut utara sejati, format DMS, arah praktis dari barat, jarak ke Kaabah, dan metadata koordinat rujukan.

/api/kiblat?lat=-7.2575&lon=112.7521 Buka UI Kiblat

Matahari · Bulan · Planet

Pendukung

Koordinat ekliptika/ekuatorial, jarak, elongasi, iluminasi, dan horizon topocentric benda langit — basis perhitungan KHGT.

/api/matahari · /bulan · /planet Coba endpoint

API Geo

Pendukung

Cari data GeoNames: populasi, elevasi, timezone, kode admin, dan koordinat — untuk melengkapi input lokasi.

/api/geo/search?q=Jakarta&country=ID Coba endpoint

Endpoint JSON & Health

Indeks

Indeks lengkap seluruh endpoint plus status service, versi, dan ketersediaan ephemeris DE440.

/api/endpoints · /health Coba endpoint

Tool Komputasi KHGT

Generate, hitung, dan visualisasikan KHGT

Tool interaktif untuk menjalankan komputasi kalender KHGT langsung dari browser — dari generate data mentah sampai visualisasi kontur di peta.

Generate KHGT

Interaktif

Generate data JSON kontur, maskgrid, sunset00, titik pertama, dan induk KHGT untuk rentang tahun Hijriah.

/api/khgt/generate Buka

Peta KHGT (OSM)

Interaktif

Hitung dan tampilkan kontur KHGT per bulan, tanggal, atau titik koordinat di atas peta OpenStreetMap/ESRI.

/api/khgt/map Buka

Google Map KHGT

Interaktif

Versi peta KHGT dengan layer Google Maps: roadmap, satelit, hybrid, dan terrain lengkap dengan traffic/transit.

/api/khgt/gmap Buka

Folder JSON KHGT

Data

Daftar seluruh file JSON KHGT hasil generate, lengkap dengan link JSON mentah dan preview tabel.

/api/khgt/files Buka

Dataset KHGT

Data

Daftar dataset KHGT JSON yang tersedia di server beserta metadata tahun dan skema kriteria.

/api/khgt/datasets Buka

Monitoring Job

Status

Pantau job generate/peta yang sedang berjalan di server beserta beban CPU, RAM, dan storage saat ini.

/api/khgt/jobs Buka

Jadwal Salat & Arah Kiblat

Cek waktu salat dan arah kiblat dari titik manapun

Gunakan widget jadwal sholat untuk memilih lokasi dari GPS atau peta, lalu unduh jadwal harian, mingguan, atau bulanan. Endpoint kiblat tetap tersedia untuk integrasi langsung.

🕌

Jadwal Salat

Widget harian, mingguan, dan bulanan dengan GPS browser, klik Google Map, elevasi otomatis, serta download CSV/JSON.

/api/jadwal-sholat/widget Buka widget

🧭

Arah Kiblat

Azimut DMS, simpangan ke utara/selatan dari barat, jarak ke Kaabah, GPS, dan provenance koordinat rujukan.

/arah-kiblat.html Buka UI Kiblat

Falak, Hisab & KHGT

Kenapa Kalender Hijriah Global Tunggal?

KHGT lahir dari upaya menyatukan penanggalan Hijriah lintas wilayah memakai kriteria astronomis yang konsisten, alih-alih rukyat lokal yang bisa berbeda hasil antar tempat. Gagasan ini banyak dibahas dalam forum hisab-rukyat, termasuk oleh Majelis Tarjih dan Tajdid Muhammadiyah yang telah lama menggunakan hisab hakiki sebagai dasar penetapan kalender.

📖

Hisab Hakiki Wujudul Hilal

Awal bulan Hijriah ditetapkan berdasarkan perhitungan astronomis: bulan baru dimulai jika pada saat matahari terbenam, ijtimak (konjungsi) sudah terjadi dan hilal sudah berada di atas ufuk — tanpa syarat rukyat visual.

🌐

Satu tanggal untuk satu wilayah kalender

Dengan kriteria global (tinggi hilal & elongasi minimum), satu garis tanggal Hijriah berlaku konsisten untuk kawasan luas, mengurangi perbedaan penetapan awal bulan antar daerah atau negara.

📐

PKG1 & PKG2

Dua Garis Perbatasan Kalender dicek untuk setiap bulan. Status "terpenuhi" pada keduanya menandakan tanggal tersebut konsisten dipakai lintas wilayah dalam satu zona kalender.

🔭

Basis data ephemeris JPL DE440

Seluruh posisi Matahari, Bulan, dan planet dihitung dari ephemeris JPL DE440 — data astronomis presisi tinggi yang sama dipakai lembaga antariksa dunia.

Baca tentang JPL DE440

Catatan: penjelasan di atas adalah ringkasan konsep umum hisab & falak. Untuk rujukan fikih dan kriteria resmi, silakan merujuk ke publikasi resmi Majelis Tarjih dan Tajdid Muhammadiyah.

Cara pakai

Panggil sebagai JSON API

Semua endpoint dapat dipanggil langsung tanpa API key untuk kebutuhan integrasi ringan.

# Cek arah kiblat dari koordinat Surabaya
curl "https://hisabmu.org/api/kiblat?lat=-7.2575&lon=112.7521"

# Ambil data induk KHGT tahun 1448 bulan 1
curl "https://hisabmu.org/api/khgt?dataset=induk&tahun=1448&bulan=1"

# Cari lokasi GeoNames terdekat
curl "https://hisabmu.org/api/geo/near?lat=-6.21462&lon=106.84513&radius_km=25"