geolocator_android

The official Android implementation of the geolocator plugin by Baseflow.

Usage

Since version 7.4.0 of the geolocator plugin this is the endorsed Android implementation. This means it will automatically be added to your dependencies when you depend on geolocator: ^7.4.0 in your applications pubspec.yaml.

More detailed instructions on using the API can be found in the README.md of the geolocator package.

Issues

Please file any issues, bugs or feature requests as an issue on our GitHub page. Commercial support is available, you can contact us at hello@baseflow.com.

Want to contribute

If you would like to contribute to the plugin (e.g. by improving the documentation, solving a bug or adding a cool new feature), please carefully review our contribution guide and send us your pull request.

Author

This Geolocator plugin for Flutter is developed by Baseflow.

5.0.3

• Updates flutter_lints to version 6.0.0.
• Updates Android build tools to version 9.0.1.

5.0.2

• Fixes PlatformException in example app for Android 14 (API level 34) versions and newer by updating manifest permissions.
• Prevented crash by checking isSuccessful before calling getResult() in location settings check.

5.0.1+1

• Bump androidx.core:core to version 1.16.0

5.0.1

• Bump flutter_lints to version 5.0.0

5.0.0

• BREAKING CHANGE: for Flutter 3.27.0 and below. Make sure you'll upgrade Flutter to 3.29.0 or above before using this version.

• Fixes deprecation warnings

4.6.2

• Updates compileSDKVersion to 35
• Updates Fixed warnings in Android package and Android example project
• Updates gradle version
• Updates com.android.application version to 8.7.0

4.6.1

• Fixes a bug where the plugin throws an exception while requesting locations updates with coarse location permission only.

4.6.0

• Adds support to read NMEA messages from other satellites constellations.
• Read the MSL altitude directly from the Android location starting with API 34.
• Always listen to NMEA message to get GPS position fix data.
• Updates com.google.android.gms:play-services-location to version 21.2.0.
• Updates androidx.core:core to version 1.13.0.

4.5.5

• Fixes a bug where location stream is not automatically started when enabling the location services.

4.5.4

• Fixes a bug where the getPositionStream was not informed of the location service resolution result. This resulted in a stream that was kept open indefinitely.

4.5.3+1

• Reverts androidx.core:core to version 1.9.0.

4.5.3

• Adds the notificationChannelName field to the ForegroundNotificationConfig class, allowing to override the channel name.
• Reverts com.google.android.gms:play-services-location to version 21.0.1. Version 21.1.0 forces users to update AGP to version 8.0.0 and Kotlin to 1.9.0 which is not inline with stable Flutter version.

4.5.2

• Fixes a bug where the Android activity is leaked when the activiy is detached from the Flutter application.

4.5.1

• Fixes a bug where the Position class properties were not set correctly.

4.5.0

• Creates AndroidPosition, a child class of Position with Android specific properties.
• Adds the satelliteCount and satellitesUsedInFix to AndroidPosition.

4.4.1

• Fixes a bug where getPositionStream caused an java.lang.IllegalStateException: passive location requests must have an explicit minimum update interval because minUpdateIntervalMillis property in location request was set to -1 by default

4.4.0

• Adds color to ForegroundNotificationConfig to set the color of the notification icon.

4.3.3

• Removes deprecated support for Android V1 embedding from the JAVA code base. Note that the geolocator's Flutter version restrictions already don't support V1 embedding anymore.
• Registers location services state change broadcast receiver with required exported flags

4.3.2

• Updates the following dependencies:
  • uuid package from ^3.0.7 to ^4.1.0
  • flutter_lints from ^2.0.0 to ^3.0.0

4.3.1

• Suppresses a deprecation warning for LocationListenerCompat.onStatusChanged when building for Android.

4.3.0

• Includes altitudeAccuracy and headingAccuracy in Position.

4.2.4

• Fixes a bug where location readings were very inaccurate when using forceLocationManager: true.

4.2.3

• Fixes a bug where the position stream was unnecessarily filtered when using forceLocationManager: true.

4.2.2

• Adds back the applicationId property of the AndroidManifest.xml file to keep backwardscompatibility with older applications that still rely on Gradle version <7.0.

4.2.1

• Fixes a bug where the stopForeground method was called with the wrong constant, resulting in a build time error.
• Fixes deprecation warnings on Android API 33.

4.2.0

• Introduces the setOngoing flag in ForegroundNotificationConfig to make notification persistent.

4.1.9

• Resolves an issue where the location service failed to stop properly upon timeout of the location stream.

4.1.8

• Adds compatibility with Android Gradle Plugin 8.0.

4.1.7

• Fixes an issue where checking location service availability hangs indefinately.

4.1.6

• Updates Play Services Location library

4.1.5

• Mark geolocator_android as implementation of geolocator

4.1.4

• Fix a bug where the location service would not stop correctly when the location stream is cancelled.

4.1.3

• Export AndroidResource class at geolocator_android.at.

4.1.2

• Fix a bug where the location service would stop if we have multiple flutter engines connected and one disconnects

4.1.1

• Moves the Android complile arguments to the example build.gradle so that is not forces the arguments on consumers of the package.

4.1.0

• Adds the ability to report altitude as MSL obtained from NMEA messages when available.

4.0.2

• Fix nullpointer in MethodCallHandlerImpl.getLocationAccuracy

4.0.1

• Migrates to Dart SDK 2.15.0 and Flutter 2.8.0.

4.0.0

IMPORTANT: when updating to version 4.0.0 make sure to also set the compileSdkVersion in the android/app/build.gradle file to 33.

• Set android compileSdkVersion to 33 (Android 13);
• Fixed the deprecation warnings/errors which caused the compilation to fail when using compileSdkVersion 33.
• Make sure the example app compiles against Android SDK 33.

3.2.1

• Use java.security.SecureRandom instead of java.util.Random to ensure the ActivityRequest identifier is generated in a cryptographically strong fasion.

3.2.0

• Raises minimum Dart version to 2.17 and Flutter version to 3.0.0.
• Removes deprecated android.enableR8 property from gradle properties.
• Updates the example application to request permissions when start listening to the position stream.

3.1.8

• Ensures that when Google mobile services are globally excluded as a dependency to automatically fallback to the Android LocationManager.

3.1.7

• Fixes repository URL of the package.

3.1.6

• Switches to a package-internal implementation of the platform interface.

3.1.5

• Fixes potential cast exceptions when connecting to the location service.

3.1.4

• Fixes support for retrieving the position stream in the absence of an Android activity.

3.1.3

• Fixes a bug introduced in 3.1.2 where unregistering the status location receiver throws an IllegalArgumentException.

3.1.2

• Fixes an issue with the location status service not unregistering the status receiver.

3.1.1

• Fixes an issue with the foreground service connection not getting unbound correctly.

3.1.0

• Adds support to make a foreground service and continue processing location updates when the application is moved into the background.

3.0.4

• Fixes Android embedding v2 warning when compiling the example App.

3.0.3

• Added a default intervalDuration value of 5000ms to prevent the getCurrentPosition method to return a cached Location.

3.0.2

• Updated to the latest version of the geolocator_platform_interface': 4.0.0`.

3.0.1

• Replace usage of unofficial GMS library

3.0.0+4

• Resolve merge conflict.

3.0.0+3

• Fixes cast exception when converting Integer to Long.

3.0.0+2

• Fixes NPE when accessing the position stream.

3.0.0+1

• Adds intervalDuration to the AndroidSettings class.

3.0.0

• Removed implicit request for permissions when getting a position.
• Added the [AndroidOptions] class to the lib directory.
• Added the forceLocationManager property to the [AndroidOptions] instance.

2.1.0

• Added Approximate Location support for Android 12;
• Added support to request the location accuracy on Android through the Geolocator.getLocationAccuracy() method;
• Make sure the getServiceStatusStream method returns an event when initially the Service Status is enabled on Android Devices (see issue#812.

2.0.0

IMPORTANT: when updating to version 2.0.0 make sure to also set the compileSdkVersion in the app/build.gradle file to 31.

• Set Android compileSdkVersion to 31 (Android 12);
• Fixed the deprecation warnings/errors which caused the flutter build appbundle to fail when using compileSdkVersion 31.

1.0.2

• Fixed didChangeAppLifecycleState goes into a loop after location request (see issue: https://github.com/Baseflow/flutter-geolocator/issues/816).

1.0.1

• Migrate to mavenCentral as jFrog has sunset jCenter ( see official announcement for more details);
• Upgrade to Gradle 4.1.0 to stay in sync with current stable version of Flutter.

1.0.0

• Initial open source release.