qibla-dart/.github/wiki/guides/quickstart.md

Quickstart

Install

Add to pubspec.yaml:

dependencies:
  qibla: ^1.0.1

Run dart pub get.

Qibla Bearing

import 'package:qibla/qibla.dart';

void main() {
  // New York
  final bearing = qiblaAngle(40.7128, -74.0060);
  print('Bearing to Ka''bah: ${bearing.toStringAsFixed(2)}°');
  print('Compass direction:  ${compassDir(bearing)}');
  print('Full direction:     ${compassPoint(bearing)}');

  // Distance to Ka'bah
  final km = distanceKm(40.7128, -74.0060, kaabaLat, kaabaLng);
  print('Distance:          ${km.toStringAsFixed(0)} km');
}

Compass Directions

compassDir returns an 8-point abbreviation (N, NE, E, SE, S, SW, W, NW). compassPoint returns the full name (North, Northeast, East, etc.).

final bearing = qiblaAngle(lat, lng);
final short = compassDir(bearing);   // "NE"
final full = compassPoint(bearing);  // "Northeast"

Ka'bah Coordinates

The Ka'bah coordinates are exported as constants:

print(kaabaLat);  // 21.4225
print(kaabaLng);  // 39.8262