# geolocator_android 5.2.1

Geolocation plugin for Flutter. This plugin provides the Android implementation for the geolocator.




## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com
flutter pub add 'geolocator_android:5.2.1'
```
Published: 2026-10-19T14:23:42.529793Z
Expected archive SHA-256: e67583809a1fab5f4a2255902978e2bc095ace9451fde0d9624e54facd0a5c22

Available in cache; verification: upstream_checksum
## Direct dependencies
- flutter: map[sdk:flutter]
- geolocator_platform_interface: ^4.4.0
- meta: ^1.10.0
- uuid: >=4.0.0 <6.0.0

## Package README (untrusted upstream documentation)
# geolocator_android

[![pub package](https://img.shields.io/pub/v/geolocator.svg)](https://pub.dartlang.org/packages/geolocator) ![Build status](https://github.com/Baseflow/flutter-geolocator/workflows/geolocator_android/badge.svg?branch=master) [![style: effective dart](https://img.shields.io/badge/style-effective_dart-40c4ff.svg)](https://github.com/tenhobi/effective_dart)

The official Android implementation of the [geolocator](https://pub.dev/packages/geolocator) plugin by [Baseflow](https://baseflow.com).

## Usage

Since version 7.4.0 of the [geolocator](https://pub.dev/packages/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](../geolocator/README.md) of the [geolocator](https://pub.dev/packages/geolocator) package.

## Issues

Please file any issues, bugs or feature requests as an issue on our [GitHub](https://github.com/Baseflow/flutter-geolocator/issues) 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](../CONTRIBUTING.md) and send us your [pull request](https://github.com/Baseflow/flutter-geolocator/pulls).

## Author

This Geolocator plugin for Flutter is developed by [Baseflow](https://baseflow.com).
## Changelog
## 5.2.1

- Fixes the position updates `EventChannel` being unregistered when the plugin is detached from
  its Activity while a position stream without a foreground notification is active. On an engine
  that outlives the Activity, every later `listen` and `cancel` failed with a
  `MissingPluginException` until the process was restarted.
- Fixes an ANR caused by `NmeaClient` registering the NMEA listener and the
  GNSS status callback (synchronous Binder calls) on the main thread for every
  position request. The listener is now only registered when `useMSLAltitude`
  is requested, and `stop()` skips the Binder calls when nothing was
  registered ([#1795](https://github.com/Baseflow/flutter-geolocator/issues/1795)).

## 5.2.0

- Adds `maxUpdateAge` to `AndroidSettings`, allowing position streams using the Android Fused Location Provider to accept an initial historical location independently of the update interval.

## 5.1.1+1

- Rollsback the declaration of the `FOREGROUND_SERVICE_LOCATION` in the 
  plugin's own manifest. Adding the permission by default results in automatic
  rejections by Google when publishing an application that doesn't need nor 
  support accessing the location services in the background.

## 5.1.1

- Declares `FOREGROUND_SERVICE_LOCATION` in the plugin's own manifest so it is
  merged intothe host app automatically, instead of requiring app developers to
  add it by hand.

## 5.1.0

- Forwards optional `verticalSpeed` (m/s) and `verticalSpeedAccuracy` (m/s) from 
  location extras when a location provider supplies them. This package does not 
  calculate vertical speed or guarantee that the extras are present or GNSS 
  Doppler-derived.
- Forwards `hasVerticalSpeed`, `hasVerticalSpeedAccuracy`, and presence flags in `AndroidPosition`.
- Adds unit tests for float/double extras parsing and presence flags preservation.

## 5.0.4

- Updates Android Gradle plugin wrapper to 9.3.1.

## 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](https://github.com/Baseflow/flutter-geolocator/issues/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](https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-chartcenter) 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.