Flutter Location Plugin
This plugin for Flutter handles getting location on Android and iOS. It also provides callbacks when location is changed.
Getting Started
Add this to your package's pubspec.yaml file:
dependencies:
location: ^4.0.0
Android
With Flutter 1.12, all the dependencies are automatically added to your project. If your project was created before Flutter 1.12, you may need to follow this.
To use location background mode on Android you have to use the enableBackgroundMode({bool enable}) API before trying to access location in the background and add nescessary permissions. You should place the required permissions in your applications <your-app>/android/app/src/main/AndroidManifest.xml:
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>
Remember that the user has to accept the location permission to always allow to use background location. From Android 11 option to always allow is not presented on the location permission dialog prompt. The user has to enable it manually from the app settings and this should be explained to the user on a separate UI that redirects user to app's location settings managed by the operating system. More on that topic can be found on Android developer pages.
iOS
And to use it in iOS, you have to add this permission in Info.plist :
NSLocationWhenInUseUsageDescription
NSLocationAlwaysUsageDescription
To receive location when application is in background, to Info.plist you have to add property list key :
UIBackgroundModes
with string value:
location
Web
Nothing to do, the plugin works directly out of box.
macOS
Ensure that the application is properly "sandboxed" and that the location is enabled. You can do this in Xcode with the following steps:
- In the project navigator, click on your application's target. This should bring up a view with tabs such as "General", "Capabilities", "Resource Tags", etc.
- Click on the "Capabilities" tab. This will give you a list of items such as "App Groups", "App Sandbox" and so on. Each item will have an "On/Off" button.
- Turn on the "App Sandbox" item and press the ">" button on the left to show the sandbox stuff.
- In the "App Data" section, select "Location".
Add this permission in Info.plist :
NSLocationWhenInUseUsageDescription
NSLocationAlwaysUsageDescription
Usage
Then you just have to import the package with
import 'package:location/location.dart';
In order to request location, you should always check manually Location Service status and Permission status.
Location location = new Location();
bool _serviceEnabled;
PermissionStatus _permissionGranted;
LocationData _locationData;
_serviceEnabled = await location.serviceEnabled();
if (!_serviceEnabled) {
_serviceEnabled = await location.requestService();
if (!_serviceEnabled) {
return;
}
}
_permissionGranted = await location.hasPermission();
if (_permissionGranted == PermissionStatus.denied) {
_permissionGranted = await location.requestPermission();
if (_permissionGranted != PermissionStatus.granted) {
return;
}
}
_locationData = await location.getLocation();
You can also get continuous callbacks when your position is changing:
location.onLocationChanged.listen((LocationData currentLocation) {
// Use current location
});
To receive location when application is in background you have to enable it:
location.enableBackgroundMode(enable: true)
Be sure to check the example project to get other code samples.
On Android a foreground notification is displayed with information that location service is running in the background.
On iOS while app is in the background and gets location, blue system bar notifies User about updates. Tapping on this bar moves User back to the app.
Public Methods Summary
| Return | Description |
|---|---|
| Future<PermissionStatus> | requestPermission() Request the Location permission. Return a PermissionStatus to know if the permission has been granted. |
| Future<PermissionStatus> | hasPermission() Return a PermissionStatus to know the state of the location permission. |
| Future<bool> | serviceEnabled() Return a boolean to know if the Location Service is enabled or if the user manually deactivated it. |
| Future<bool> | requestService() Show an alert dialog to request the user to activate the Location Service. On iOS, will only display an alert due to Apple Guidelines, the user having to manually go to Settings. Return a boolean to know if the Location Service has been activated (always false on iOS). |
| Future<bool> | changeSettings(LocationAccuracy accuracy = LocationAccuracy.HIGH, int interval = 1000, double distanceFilter = 0) Will change the settings of futur requests. accuracywill describe the accuracy of the request (see the LocationAccuracy object). interval will set the desired interval for active location updates, in milliseconds (only affects Android). distanceFilter set the minimum displacement between location updates in meters. |
| Future<LocationData> | getLocation() Allow to get a one time position of the user. It will try to request permission if not granted yet and will throw a PERMISSION_DENIED error code if permission still not granted. |
| Stream<LocationData> | onLocationChanged Get the stream of the user's location. It will try to request permission if not granted yet and will throw a PERMISSION_DENIED error code if permission still not granted. |
| Future<bool> | enableBackgroundMode({bool enable}) Allow or disallow to retrieve location events in the background. Return a boolean to know if background mode was successfully enabled. |
You should try to manage permission manually with requestPermission() to avoid error, but plugin will try handle some cases for you.
Objects
class LocationData {
final double latitude; // Latitude, in degrees
final double longitude; // Longitude, in degrees
final double accuracy; // Estimated horizontal accuracy of this location, radial, in meters
final double altitude; // In meters above the WGS 84 reference ellipsoid
final double speed; // In meters/second
final double speedAccuracy; // In meters/second, always 0 on iOS
final double heading; //Heading is the horizontal direction of travel of this device, in degrees
final double time; //timestamp of the LocationData
}
enum LocationAccuracy {
powerSave, // To request best accuracy possible with zero additional power consumption,
low, // To request "city" level accuracy
balanced, // To request "block" level accuracy
high, // To request the most accurate locations available
navigation // To request location for navigation usage (affect only iOS)
}
// Status of a permission request to use location services.
enum PermissionStatus {
/// The permission to use location services has been granted.
granted,
// The permission to use location services has been denied by the user. May have been denied forever on iOS.
denied,
// The permission to use location services has been denied forever by the user. No dialog will be displayed on permission request.
deniedForever
}
Note: you can convert the timestamp into a DateTime with: DateTime.fromMillisecondsSinceEpoch(locationData.time.toInt())
Feedback
Please feel free to give me any feedback helping support this plugin !
![[iOS]](https://avatars.githubusercontent.com/u/8151661?v=4)
789 Jan 3, 2023
985 Jan 5, 2023
221 Dec 27, 2022
2.1k Dec 30, 2022
1k Jan 5, 2023
222 Jan 4, 2023
20 Dec 3, 2022
183 Dec 21, 2022
258 Dec 25, 2022
2.3k Jan 8, 2023
3 Oct 10, 2022
227 Dec 31, 2022
277 Dec 28, 2022
84 Dec 6, 2022
953 Dec 22, 2022
1 Sep 26, 2022
2 Dec 16, 2022
14 Nov 30, 2022