qibla 1.1.0 
qibla: ^1.1.0 copied to clipboard
ariccamarata.comQibla direction, great-circle path, and haversine distance for Dart and Flutter. Pure math, zero dependencies. Computes bearing to the Ka'bah from any point on Earth.
qibla #
Qibla direction, great-circle path, and haversine distance for Dart and Flutter. Pure math, zero dependencies.
Installation #
dependencies:
qibla: ^1.0.0
Quick Start #
import 'package:qibla/qibla.dart';
// Bearing from New York to the Ka'bah
final bearing = qiblaAngle(40.7128, -74.006);
print(bearing); // ~58.48
print(compassDir(bearing)); // NE
// Distance in kilometers
final km = distanceKm(40.7128, -74.006, kaabaLat, kaabaLng);
print(km); // ~9634
API #
| Function | Returns | Description |
|---|---|---|
qiblaAngle(lat, lng) |
double |
Bearing to Ka'bah, degrees clockwise from north |
compassDir(bearing) |
String |
Eight-point abbreviation: N, NE, E, SE, S, SW, W, NW |
compassName(bearing) |
String |
Full name: North, Northeast, ... |
qiblaGreatCircle(lat, lng, [steps]) |
List<List<double>> |
Great-circle waypoints to the Ka'bah |
distanceKm(lat1, lng1, lat2, lng2) |
double |
Haversine distance in km |
Constants: kaabaLat (21.422511), kaabaLng (39.82615), earthRadiusKm (6371).
Full reference: API Reference.
Architecture #
All calculations use the forward azimuth formula from spherical trigonometry. Great-circle paths use Slerp. Distance uses the haversine formula. Ka'bah coordinates are fixed constants verified against published GPS surveys.
Compatibility #
Dart 3.7+. Works with Flutter and standalone Dart.
Related #
- qibla (npm) - The TypeScript version of this package.
- pray-calc-dart - Islamic prayer times calculator for Dart.
License #
Metadata
Documentation
Publisher
Weekly Downloads
Metadata
Qibla direction, great-circle path, and haversine distance for Dart and Flutter. Pure math, zero dependencies. Computes bearing to the Ka'bah from any point on Earth.
Repository (GitHub)
View/report issues
Topics
#qibla #islamic #compass #geodesic #geolocation
License
MIT (license)