aric/qibla-dart
1
0
Fork 0
mirror of https://github.com/acamarata/qibla-dart.git synced 2026-07-01 03:14:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
qibla-dart/.github/wiki/examples/basic-usage.md
Aric Camarata cc3c227d2d
feat: surface-area parity audit vs qibla-js (v1.0.1) (#1) 
* chore: surface-area parity audit vs qibla-js, bump to v1.0.1

Full gap analysis: qibla-dart already matches @acamarata/qibla on all five
public functions (qiblaAngle, compassDir, compassName, qiblaGreatCircle,
distanceKm) and three constants (kaabaLat, kaabaLng, earthRadiusKm).
No runtime gaps found; 48/48 tests pass unchanged.

Patch bump documents the audit and closes T-E10-01 (Mega Phase 1).

* docs: add CHANGELOG.md for v1.0.1 release

* chore: polish pubspec, add wiki docs
2026-05-29 06:49:15 -04:00

1.1 KiB
Raw Blame History

Basic Usage Examples

Qibla for Multiple Cities

import 'package:qibla/qibla.dart';

void main() {
  final cities = [
    ('New York',  40.7128,  -74.0060),
    ('London',    51.5074,   -0.1278),
    ('Istanbul',  41.0082,   28.9784),
    ('Jakarta',   -6.2088,  106.8456),
    ('Cape Town', -33.9249,  18.4241),
  ];

  print('City              Bearing  Direction  Distance');
  print('${'─' * 54}');

  for (final (city, lat, lng) in cities) {
    final bearing = qiblaAngle(lat, lng);
    final dir = compassDir(bearing);
    final km = distanceKm(lat, lng, kaabaLat, kaabaLng);

    print('${city.padRight(18)}${bearing.toStringAsFixed(1).padLeft(6)}°  ${dir.padRight(9)}  ${km.toStringAsFixed(0)} km');
  }
}

Great-Circle Path Waypoints

import 'package:qibla/qibla.dart';

void main() {
  // 8 waypoints from London to Makkah
  final path = greatCirclePath(51.5074, -0.1278, kaabaLat, kaabaLng, 8);

  print('Waypoints from London to Makkah:');
  for (int i = 0; i < path.length; i++) {
    final p = path[i];
    print('  ${i + 1}. ${p.latitude.toStringAsFixed(4)}°, ${p.longitude.toStringAsFixed(4)}°');
  }
}