Lyokone/flutterlocation

📍 Flutter Location

The easiest way to get a device's location in real-time — on every platform Flutter runs.

One simple API for GPS coordinates, live location streams and background tracking on Android, iOS, macOS, Web, Windows and Linux.

pub version pub likes pub points codecov license

📖 Documentation  ·  🌐 Live web demo  ·  📦 pub.dev  ·  💬 Feedback

---

✨ Why Location?

• 🌍 Truly cross-platform — the same code runs on all six Flutter targets, no per-platform branching.
• ⚡ One-line to a fix — await location.getLocation() and you're done.
• 🔴 Real-time streams — subscribe to onLocationChanged for continuous updates.
• 🌙 Background tracking — keep receiving locations while your app is backgrounded on Android & iOS.
• 🎛️ Tunable — pick accuracy, update interval and distance filter to balance precision vs. battery.
• 🔔 Customizable notification — full control over the Android foreground-service notification.
• 📊 Rich data — latitude, longitude, altitude, speed, heading, accuracy, mock detection and more.
• 🛡️ Battle-tested — one of the most-used location plugins in the Flutter ecosystem, maintained since 2017.

📱 Platform support

Feature	Android	iOS	macOS	Web	Windows	Linux
One-time location	✅	✅	✅	✅	✅	✅
Location stream	✅	✅	✅	✅	✅	✅
Background updates	✅	✅	—	—	—	—
Permission handling	✅	✅	✅	✅	✅	✅

Windows uses Windows.Devices.Geolocation; Linux talks to GeoClue2 over D-Bus. Both require the system location service to be enabled.

Watch the demo on YouTube

🚀 Quick start

Add the package:

dependencies:
  location: ^10.0.0

Get a location:

import 'package:location/location.dart';

final location = Location();

// Make sure the service is on and permission is granted.
if (!await location.serviceEnabled() && !await location.requestService()) return;
if (await location.requestPermission() != PermissionStatus.granted) return;

// One-time fix…
final current = await location.getLocation();
print('${current.latitude}, ${current.longitude}');

// …or a live stream.
location.onLocationChanged.listen((loc) {
  print('Moved to ${loc.latitude}, ${loc.longitude}');
});

That's it. Platform setup (permissions, background mode, sandbox entitlements) and the full API are covered in the package README and the documentation website.

📦 Packages in this repository

Package	Description	pub.dev
location	The plugin you use in your app.	pub
location_platform_interface	Shared platform interface.	pub
location_web	Web implementation.	pub

🤝 Contributing

Issues and pull requests are very welcome — this plugin is community-maintained and we're always looking for help. Browse the open issues to get started, or open a new one to report a bug or request a feature.

👥 Maintainers

• Guillaume Bernos (original creator)
• Bartek Pacia

📄 License

Released under the MIT License. © 2017 Guillaume Bernos.