HouseMuslim
Referensi API

Kiblat

Arah & jarak menuju Ka'bah — bearing great-circle, kompas 16 & 8 arah, jarak km/mi/nmi, plus lokasi & zona waktu hasil resolusi offline.

GET /api/v1/prayer/qibla

Parameter kueri

ParamTypeDeskripsi
latfloatLintang, −90…90 (wajib)
lngfloatBujur, −180…180 (wajib)
GET/prayer/qiblaLangsung
GET /prayer/qibla?lat=-6.20&lng=106.85

Contoh

curl "https://api.housemuslim.org/api/v1/prayer/qibla?lat=-6.2&lng=106.8"
const res = await fetch('https://api.housemuslim.org/api/v1/prayer/qibla?lat=-6.2&lng=106.8');
const { data } = await res.json();
console.log(data.bearing_deg, data.compass_en); // 295.16 WNW
{
  "success": true,
  "data": {
    "origin": { "lat": -6.2, "lng": 106.8 },
    "kaaba": { "lat": 21.422487, "lng": 39.826206, "name": "Masjid al-Haram, Makkah" },
    "bearing_deg": 295.16,
    "final_bearing_deg": 284.85,
    "compass": "Barat barat laut",
    "compass_en": "WNW",
    "compass_id": "Barat barat laut",
    "cardinal8": "NW",
    "distance_km": 7915.16,
    "distance_km_vincenty": 7917.26,
    "distance_mi": 4919.56,
    "distance_nmi": 4274.98,
    "place": {
      "lat": -6.2, "lng": 106.8,
      "city": "Jakarta", "region": "Jakarta",
      "country": "Indonesia", "country_code": "ID",
      "nearest_city_km": 0.65
    },
    "timezone": { "id": "Asia/Jakarta", "offset_min": 420 }
  }
}
FieldArti
originKoordinat yang diminta (echo)
kaabaKoordinat & nama tujuan (Masjid al-Haram, Makkah)
bearing_degBearing great-circle awal dari Utara sejati, searah jarum jam
final_bearing_degBearing saat tiba di Ka'bah (ujung busur)
compass_en / compass_idLabel kompas 16 arah (Inggris / Indonesia)
cardinal8Label kardinal 8 arah (N…NW)
distance_kmJarak great-circle (Haversine)
distance_km_vincentyJarak geodesik pada elipsoid WGS-84
distance_mi / distance_nmiJarak Vincenty dalam mil & mil laut
placeLokasi hasil reverse-geocode offline (kota/wilayah/negara + jarak ke kota terdekat)
timezoneZona waktu IANA + offset menit (resolusi offline)

Titik referensi Ka'bah adalah 21.422487, 39.826206. place & timezone di-resolve sepenuhnya offline (dataset GeoNames + poligon zona waktu tertanam), tanpa panggilan API eksternal.

Kompas akurat (True North)

bearing_deg relatif terhadap Utara sejati. Untuk menunjuk arah di lapangan, heading magnetik perangkat harus dikoreksi dengan deklinasi magnetik (model WMM, tersedia di engine on-device). iOS sudah memberi heading True North; Android memberi heading magnetik sehingga deklinasi perlu ditambahkan.

Di halaman ini