# geolocator_apple 2.4.3 Geolocation Apple plugin for Flutter. This plugin provides the Apple implementation for the geolocator. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com flutter pub add 'geolocator_apple:2.4.3' ``` Published: 2026-10-23T07:29:59.612760Z Expected archive SHA-256: a1e177f3081089724f2095856aeb96eb8d7d1c59e425aed8dd4de7aa2c11ab66 Available in cache; verification: upstream_checksum ## Direct dependencies - flutter: map[sdk:flutter] - geolocator_platform_interface: ^4.1.0 ## Package README (untrusted upstream documentation) # geolocator_apple [![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_apple/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 iOS and macOS implementation of the [geolocator](https://pub.dev/packages/geolocator) plugin by [Baseflow](https://baseflow.com). ## Usage Since version 7.5.0 of the [geolocator](https://pub.dev/packages/geolocator) plugin this is the endorsed iOS and macOS implementation. This means it will automatically be added to your dependencies when you depend on `geolocator: ^7.5.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. ### Maritime positioning For location streams used on boats, including while anchored, select `ActivityType.maritime`: ```dart final settings = AppleSettings(activityType: ActivityType.maritime); final positions = GeolocatorApple().getPositionStream(locationSettings: settings); ``` This uses Core Location's [maritime activity type](https://developer.apple.com/documentation/corelocation/clactivitytype/maritime) when built with the iOS 27 or macOS 27 SDK (Xcode 27 or later) and running on that OS version or later. On older SDKs or operating systems, it falls back to `ActivityType.otherNavigation`. Existing activity types and the default activity type are unchanged. ## 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 . ## 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 ## 2.4.3 * Fixes `getCurrentPosition` never completing when it is called again before an earlier call has completed. The new request replaced the handlers of the pending one, which was left waiting forever. Requests made while another one is pending now share its location updates, and all of them complete with the same position or error, using the most accurate of the requested accuracies. Each new request restarts the `kCLErrorLocationUnknown` grace period for every pending request. ## 2.4.2 * Reads the location permission status off the main thread in `checkPermission`, `requestPermission`, `getCurrentPosition` and `getLastKnownPosition`. The status read waits for a synchronous reply from `locationd`, which froze the app for seconds when `locationd` was slow to answer. ## 2.4.1 * Fixes `getCurrentPosition` never completing when Core Location cannot determine a position, for example on a Mac with Wi-Fi turned off. Core Location reports `kCLErrorLocationUnknown` and keeps trying; a single position request now fails with a `PositionUpdateException` when no position arrives within 6 minutes of that error — longer than the 5-minute interval at which macOS rescans Wi-Fi networks for a position, so requests that would still succeed are not cut short. Position streams keep waiting, as before. ## 2.4.0 * Adds `ActivityType.maritime` for vessels on water, including while anchored, on iOS 27 and macOS 27. Falls back to `ActivityType.otherNavigation` when built with an older SDK or running on an older OS. ## 2.3.15 * Adds support for the `BYPASS_PERMISSION_LOCATION_ALWAYS` flag when using Swift Package Manager (SPM). Set the `BYPASS_PERMISSION_LOCATION_ALWAYS=1` environment variable when building to bypass the request for permission to update location in the background, matching the existing CocoaPods behavior. ## 2.3.14 * Updates `flutter_lints` to version 6.0.0. ## 2.3.13 * Adds Swift Package Manager compatibility. ## 2.3.12 * Removed deprecated `-[UIApplication openURL:]` dead code. ## 2.3.11 * Adds privacy manifest for macOS to the podspec. ## 2.3.10 * Updated dart sdk to sdk: `^3.5.0` * Fixed example project warnings ## 2.3.9 * Adds privacy manifest for macOS. ## 2.3.8+1 * HOT FIX: Adds back implementation of the `stopListening` method in the `GeolocationHandler.m` file. ## 2.3.8 * Uses different `CLLocationManager` instances, for one time request location and persistent request location. * Fixes a bug where iOS location settings, e.g. `accuracy` and `distanceFilter` are overridden by different calls. * Updates minimum deployment target to `iOS 11` as lower is not supported anymore by Xcode. ## 2.3.7 * Adds privacy manifest. ## 2.3.6 * Adds option to bypass the request for permission to update location in the background (which can attract scrutiny from Apple upon app submission). To bypass, set the preprocessor macro `BYPASS_PERMISSION_LOCATION_ALWAYS` to 1 in XCode. ## 2.3.5 * Previously the plugin filtered out negative values for heading and/or heading accuracy. Now the plugin is returning the heading and/or the heading accuracy even if the they have a negative value (invalid), so that the developer can use it and decide what to do with it. ## 2.3.4 * Allows the ARM64 architecture as a valid IPhone simulator architecture. ## 2.3.3 * Ensures the `[CLLocationManager locationServicesEnabled]` message is called on a background thread when listening for service updates. ## 2.3.2 * Fixes build error and warnings regarding unused variables and unavailable APIs on macOS. ## 2.3.1 * Fixes a bug where invalid speed and speed accuracy readings where returned instead of ignored. ## 2.3.0 * Includes `altitudeAccuracy` and `headingAccuracy` in `Position`. ## 2.2.7 * Fixes the propagation of the activity type setting. ## 2.2.6 * Ensures the `isLocationServicesEnabled` method is executed in a background thread. ## 2.2.5 * Fixes a bug where iOS location manager background geolocation settings are overridden by calls to the `getCurrentPosition` method. ## 2.2.4 * Fix plugin registration in `dart_plugin_registrant.dart` ## 2.2.3 * Implement allowBackgroundLocationUpdates iOS setting ## 2.2.2 * Fix requesting location while listening to location stream stops the stream ## 2.2.1 * Migrates to Dart SDK 2.15.0 and Flutter 2.8.0. ## 2.2.0 * Raises minimum Dart version to 2.17 and Flutter version to 3.0.0. * Updates `isMocked` flag on iOS 15 and higher. * Updates the example application to request permissions when start listening to the position stream. ## 2.1.4 * Fix background location indicator not showing on first time using the service. ## 2.1.3 * Fixes repository URL of the package. ## 2.1.2 * Switches to a package-internal implementation of the platform interface. ## 2.1.1+1 * Resolves issue with symbolic links in 2.1.1 version. ## 2.1.1 * Added additional option to Apple settings to allow the user to configure the background location indicator of CLocationManager. ## 2.1.0 * Ensures that the `getCurrentPosition` takes the supplied accuracy into account. * Improves the speed of acquiring the current position. * Adds a native test bed. ## 2.0.1 * Updated to the latest version of the `geolocator_platform_interface': `4.0.0`. ## 2.0.0+2 * Removes the Android specific `timeInterval` parameter from `AppleSettings`. ## 2.0.0+1 * Adds missing `timeLimit` to the `AppleSettings` class. ## 2.0.0 * iOS: Keep `PositionStream` alive when the `Location Services` has been turned off and on again in the settings. * Removed implicit request for permissions when getting a position. * Added the [ActivityType] enum needed for the `pauseLocationUpdatesAutomatically` property. * Added the `pauseLocationUpdatesAutomatically` and `activityType` property to the iOS options class. ## 1.2.2 * Fixed iOS cancelation of positionStream. ## 1.2.1 * Use `requestAlwaysAuthorization` instead of `requestWhenInUseAuthorization` on macOS as both result in the same behaviour but the former has better support on Catelina. ## 1.2.0 * Make sure the `getCurrentPosition` method returns the current position and not a cached location which might be wrong (see issue [#629](https://github.com/Baseflow/flutter-geolocator/issues/629)). ## 1.1.0 * Added support for macOS Desktop. ## 1.0.0 * Initial open source release.