Skip to content
al-falak
Search limited to v1.0.0. Switch to the latest version for up-to-date results.

Qibla Direction

This content is for v1.0.0. Switch to the latest version for up-to-date documentation.

Qibla Direction

Section titled “Qibla Direction”

The Qibla is the direction to the Kaaba in Makkah, used during Islamic prayer.

Basic usage

Section titled “Basic usage”
from alfalak import Qibla


direction = Qibla((35.7750, -78.6336)).direction
print(f"Qibla: {direction:.1f}° clockwise from north")

Using a Coordinates object

Section titled “Using a Coordinates object”
from alfalak import Qibla, Coordinates


coords = Coordinates(latitude=35.7750, longitude=-78.6336)
direction = Qibla(coords).direction

Multiple cities

Section titled “Multiple cities”
from alfalak import Qibla


cities = [
    ("Raleigh, US", (35.7750, -78.6336)),
    ("London, UK", (51.5074, -0.1278)),
    ("Jakarta, ID", (-6.2088, 106.8456)),
    ("Sydney, AU", (-33.8688, 151.2093)),
]


for name, coords in cities:
    print(f"{name}: {Qibla(coords).direction:.1f}°")

How it works

Section titled “How it works”

The Qibla direction is calculated using spherical trigonometry:

direction = atan2(
    sin(Δlongitude),
    cos(latitude) × tan(Makkah_latitude) - sin(latitude) × cos(Δlongitude)
)

Where Makkah’s coordinates are 21.4225°N, 39.8262°E.

See also

Section titled “See also”