mirror of
https://github.com/acamarata/qibla-dart.git
synced 2026-06-30 19:04:27 +00:00
Qibla direction, great-circle path, and haversine distance for Dart/Flutter. Pure math, zero dependencies.
| .github | ||
| lib | ||
| test | ||
| .editorconfig | ||
| .gitignore | ||
| analysis_options.yaml | ||
| CHANGELOG.md | ||
| LICENSE | ||
| pubspec.yaml | ||
| README.md | ||
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.