new_geolocation 1.0.0

  • Readme
  • Changelog
  • Example
  • Installing
  • 86

new_geolocation #

pub package

Flutter new_geolocation plugin for Android API 16+ and iOS 9+.


  • Manual and automatic location permission management
  • Current one-shot location
  • Continuous location updates with foreground and background options

The plugin is under active development and the following features are planned soon:

  • Geocode
  • Geofences
  • Place suggestions
  • Activity recognition
  • Exposition of iOS/Android specific APIs (like significant location updates on iOS)

Installation #

Add geolocation to your pubspec.yaml:


Import #

Package is called new_geolocation, with Geolocation being the base class.

import 'package:new_geolocation/geolocation.dart';

Note: There is a known issue for integrating swift written plugin into Flutter project created with Objective-C template. See issue Flutter#16049 for help on integration.

AndroidX Requirement #

You may need to updated your '/android/' to include use of AndroidX.


Permission #

Android and iOS require to declare the location permission in a configuration file.

For iOS

There are two kinds of location permission available in iOS: "when in use" and "always".

If you don't know what permission to choose for your usage, see:

You need to declare the description for the desired permission in ios/Runner/Info.plist:

  <!-- for iOS 11 + -->
  <string>Reason why app needs location</string>
  <string>Reason why app needs location</string>
  <!-- additionally for iOS 9/10, if you need always permission -->
  <string>Reason why app needs location</string>

For Android

There are two kinds of location permission in Android: "coarse" and "fine". Coarse location will allow to get approximate location based on sensors like the Wifi, while fine location returns the most accurate location using GPS (in addition to coarse).

You need to declare one of the two permissions in android/app/src/main/AndroidManifest.xml:

<manifest xmlns:android="">
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <!-- or -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />



For more complete documentation on all usage, check the API documentation:

You can also check the example project that showcase a comprehensive usage of Geolocation plugin.

Check if location service is operational #

API documentation:

final GeolocationResult result = await Geolocation.isLocationOperational();
if(result.isSuccessful) {
  // location service is enabled, and location permission is granted
} else {
  // location service is not enabled, restricted, or location permission is denied

Request location permission #

On Android (api 23+) and iOS, geolocation needs to request permission at runtime.

Note: You are not required to request permission manually. Geolocation plugin will request permission automatically if it's needed, when you make a location request.

API documentation:

final GeolocationResult result = await Geolocation.requestLocationPermission(const LocationPermission(
  android: LocationPermissionAndroid.fine,
  ios: LocationPermissionIOS.always,

if(result.isSuccessful) {
  // location permission is granted (or was already granted before making the request)
} else {
  // location permission is not granted
  // user might have denied, but it's also possible that location service is not enabled, restricted, and user never saw the permission request dialog 

Get the current one-shot location #

Geolocation offers three methods:

// best option for most cases
StreamSubscription<LocationResult> subscription = Geolocation.currentLocation(accuracy: {
  if(result.isSuccessful) {
    Double latitude = result.location.latitude;
    // todo with result

// force a single location update
StreamSubscription<LocationResult> subscription = Geolocation.currentLocation(accuracy: {
  // todo with result

// get last known location, which is a future rather than a stream
LocationResult result = await Geolocation.lastKnownLocation();

Continuous location updates #

API documentation:

StreamSubscription<LocationResult> subscription = Geolocation.locationUpdates(
    displacementFilter: 10.0, // in meters
    inBackground: true, // by default, location updates will pause when app is inactive (in background). Set to `true` to continue updates in background. 
  .listen((result) {
    if(result.isSuccessful) {
      // todo with result

// cancelling subscription will also stop the ongoing location request

Handle location result #

Location request return either a LocationResult future or a stream of LocationResult.

API documentation:

LocationResult result = await Geolocation.lastKnownLocation();

if (result.isSuccessful) {
  // location request successful, location is guaranteed to not be null 
  double lat = result.location.latitude;
  double lng = result.location.longitude;
} else {
  switch (result.error.type) {
    case GeolocationResultErrorType.runtime:
      // runtime error, check result.error.message
    case GeolocationResultErrorType.locationNotFound:
      // location request did not return any result
    case GeolocationResultErrorType.serviceDisabled:
      // location services disabled on device
      // might be that GPS is turned off, or parental control (android) 
    case GeolocationResultErrorType.permissionDenied:
      // user denied location permission request
      // rejection is final on iOS, and can be on Android
      // user will need to manually allow the app from the settings
    case GeolocationResultErrorType.playServicesUnavailable:
      // android only
      // result.error.additionalInfo contains more details on the play services error
      switch(result.error.additionalInfo as GeolocationAndroidPlayServices) {
        // do something, like showing a dialog inviting the user to install/update play services
        case GeolocationAndroidPlayServices.missing:
        case GeolocationAndroidPlayServices.updating:
        case GeolocationAndroidPlayServices.versionUpdateRequired:
        case GeolocationAndroidPlayServices.disabled:
        case GeolocationAndroidPlayServices.invalid:

Authors #

Geolocation plugin is developed by Loup, a mobile development studio based in Montreal and Paris.
You can contact us at

Contributers #

  • lukaspili
  • mit-mit
  • shehabic-work
  • Abgaryan
  • shehabic
  • alfanhui

License #

Apache License 2.0

[1.0.0] #

  • Updated Kotlin to 1.3.41
  • Updated Kotlin experimental coroutines to Kotlinx
  • Updated Android packages to Androidx (hence major release increment)

[0.2.3] #

  • Added updated pubspec description
  • Flutter format on number of files

[0.2.2] #

  • Better encoding of 'options' on LocationUpdatesRequest [hoggetaylor]
  • Fix argument of type string can not be assigned to DiagnosticsNode [osamagamal65]
  • Adding support for new method to request enabling location services [shehabic]
  • Updated Readme [shehabic]
  • Various fixes for XCode 10, and Cocoa Pods 1.5.3 [shehabic]
  • Updated Google Play Services Version [shehabic]
  • Fixed serialization from dart to native platforms [shehabic]
  • Updated kotlin version [shehabic]

[0.2.1] #

  • Replace requestPermission(permission) named parameter by positional

[0.2.0] #

  • Refactor single one-shot location
  • Refactor permission management
  • Add continuous location updates support
  • Add in background support for location updates
  • Add request location permission manually
  • Add pause/resume location updates automatically when app goes to background/foreground
  • Add Stream API
  • Fix: Match play-services version to Flutter's firebase plugins
  • Fix: Dart 1.x compatibility

[0.1.1] #

  • Pubspec and documentation fixes

[0.1.0] - Initial release #

  • New feature: Last known location
  • New feature: Current location
  • New feature: Location updates


//  Copyright (c) 2018 Loup Inc.
//  Licensed under Apache License v2.0

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:new_geolocation/geolocation.dart';
import 'tab_location.dart';
import 'tab_track.dart';
import 'tab_settings.dart';

void main() => runApp(new MyApp());

class MyApp extends StatefulWidget {
  MyApp() {
    Geolocation.loggingEnabled = true;

  _MyAppState createState() => new _MyAppState();

class _MyAppState extends State<MyApp> {
  Widget build(BuildContext context) {
    return new MaterialApp(
      home: new CupertinoTabScaffold(
        tabBar: new CupertinoTabBar(
          items: <BottomNavigationBarItem>[
            new BottomNavigationBarItem(
              title: new Text('Current'),
              icon: new Icon(Icons.location_on),
            new BottomNavigationBarItem(
              title: new Text('Track'),
              icon: new Icon(Icons.location_searching),
            new BottomNavigationBarItem(
              title: new Text('Services'),
              icon: new Icon(Icons.location_off),
            new BottomNavigationBarItem(
              title: new Text('Settings'),
              icon: new Icon(Icons.settings_input_antenna),
        tabBuilder: (BuildContext context, int index) {
          return new CupertinoTabView(
            builder: (BuildContext context) {
              switch (index) {
                case 0:
                  return new TabLocation();
                case 1:
                  return new TabTrack();
                case 3:
                  return new TabSettings();
                  return new Container(
                    color: Colors.white,
                    child: new Center(
                      child: new FlatButton(
                        child: Text(
                          "Enable location services",
                          style: TextStyle(color: Colors.white),
                        onPressed: enableLocationServices,

  enableLocationServices() async {
    Geolocation.enableLocationServices().then((result) {
      // Request location
    }).catchError((e) {
      // Location Services Enablind Cancelled

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  new_geolocation: ^1.0.0

2. Install it

You can install packages from the command line:

with Flutter:

$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:new_geolocation/channel/codec.dart';
import 'package:new_geolocation/channel/helper.dart';
import 'package:new_geolocation/channel/location_channel.dart';
import 'package:new_geolocation/channel/param.dart';
import 'package:new_geolocation/data/location.dart';
import 'package:new_geolocation/data/location_result.dart';
import 'package:new_geolocation/data/permission.dart';
import 'package:new_geolocation/data/result.dart';
import 'package:new_geolocation/facet_android/location.dart';
import 'package:new_geolocation/facet_android/permission.dart';
import 'package:new_geolocation/facet_android/result.dart';
import 'package:new_geolocation/facet_ios/location.dart';
import 'package:new_geolocation/facet_ios/permission.dart';
import 'package:new_geolocation/geolocation.dart';
Describes how popular the package is relative to other packages. [more]
Code health derived from static analysis. [more]
Reflects how tidy and up-to-date the package is. [more]
Weighted score of the above. [more]
Learn more about scoring.

We analyzed this package on Mar 31, 2020, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.7.1
  • pana: 0.13.6
  • Flutter: 1.12.13+hotfix.8

Maintenance issues and suggestions

Support latest dependencies. (-10 points)

The version constraint in pubspec.yaml does not support the latest published versions for 1 dependency (streams_channel).


Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.19.0 <3.0.0
flutter 0.0.0
streams_channel ^0.2.1 0.2.3 0.3.0
Transitive dependencies
collection 1.14.11 1.14.12
meta 1.1.8
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8