HouseMuslim
API Reference

Qibla

Direction and distance to the Ka'bah — great-circle bearing, 16-point compass, and Haversine + Vincenty distance.

GET /api/v1/prayer/qibla

Query parameters

ParamTypeDescription
latfloatLatitude, −90…90 (required)
lngfloatLongitude, −180…180 (required)
GET/prayer/qiblaLive
GET /prayer/qibla?lat=-6.20&lng=106.85

Example

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": {
    "bearing_deg": 295.16,
    "compass": "Barat barat laut",
    "compass_en": "WNW",
    "compass_id": "Barat barat laut",
    "distance_km": 7915.16,
    "distance_km_vincenty": 7917.26
  }
}
FieldMeaning
bearing_degInitial great-circle bearing from North, clockwise
compass_en / compass_id16-point compass label (English / Indonesian)
distance_kmGreat-circle distance (Haversine)
distance_km_vincentyGeodesic distance on the WGS-84 ellipsoid

The Ka'bah reference is 21.422487, 39.826206.

On this page