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/qiblaParameter kueri
| Param | Type | Deskripsi |
|---|---|---|
lat | float | Lintang, −90…90 (wajib) |
lng | float | Bujur, −180…180 (wajib) |
GET
/prayer/qiblaLangsungGET /prayer/qibla?lat=-6.20&lng=106.85Contoh
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 }
}
}| Field | Arti |
|---|---|
origin | Koordinat yang diminta (echo) |
kaaba | Koordinat & nama tujuan (Masjid al-Haram, Makkah) |
bearing_deg | Bearing great-circle awal dari Utara sejati, searah jarum jam |
final_bearing_deg | Bearing saat tiba di Ka'bah (ujung busur) |
compass_en / compass_id | Label kompas 16 arah (Inggris / Indonesia) |
cardinal8 | Label kardinal 8 arah (N…NW) |
distance_km | Jarak great-circle (Haversine) |
distance_km_vincenty | Jarak geodesik pada elipsoid WGS-84 |
distance_mi / distance_nmi | Jarak Vincenty dalam mil & mil laut |
place | Lokasi hasil reverse-geocode offline (kota/wilayah/negara + jarak ke kota terdekat) |
timezone | Zona 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.