Locus Android

An Awesome Kotlin Location library to retrieve location merely in 3 lines of code
Alternatives To Locus Android
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
2a month ago67November 01, 20215mitSwift
Universal API for request permission and get its statuses.
React Native Geolocation Service1,44371274 months ago22June 25, 202292mitJava
React native geolocation service for iOS and android
Flutter Geolocator1,095145372 days ago116July 12, 2022153mitDart
Android and iOS Geolocation plugin for Flutter
Flutterlocation985186332 months ago63June 24, 2022120mitJava
A Flutter plugin to easily handle realtime location in iOS and Android. Provides settings for optimizing performance or battery.
20 days ago6March 15, 202236apache-2.0Kotlin
:earth_africa: Map location picker component for Android. Based on Google Maps. An alternative to Google Place Picker.
132 years ago25August 06, 20201Java
Simplify getting user's location for Android
43 years ago22October 22, 2018mitSwift
Request the Location Services via a 3D 360° flyover MKMapView 🗺
Arcore Location368
3 years ago39mitJava
Allows items to be placed within the AR world with real-world GPS coordinates using ARCore.
React Native System Setting34966a year ago38February 16, 202254mitJava
A library to access system setting, and change it easily. eg: volume, brightness, wifi
Locus Android306
20 days ago1January 11, 202210apache-2.0Kotlin
An Awesome Kotlin Location library to retrieve location merely in 3 lines of code
Alternatives To Locus Android
Select To Compare

Alternative Project Comparisons



License language Platform API Release

Locus is a tiny kotlin library for android which makes it super very easy to retrieve location with just few lines of code. Everything including permission model and Location settings resolution is handled internally which removes a lot of boilerplate code any developer have to write every time.

Looking for Maintainers

Its been a long time since I moved away from native Android development so I am finding it hard to keep up with the latest changes with the location permissions in newever Android versions and fix issues reported here. I'd love someone to actively maintain this library and look into the issues. If you are interested and up to the task, drop a mail at [email protected] or comment on this issue. Thanks!


See Wiki for more information and configuration!

Read blog here:

The Legendary Task of Retrieving Location in Just 3 lines of code.


  • Android R support (Please report if any issue is found)
  • Completely written in Kotlin
  • Easy Initialization
  • Handles Permission Model
  • No Boilerplate
  • Built on Kotlin DSL
  • Manifest Permission Check
  • Life-Cycle Aware Location Updates
  • Location Settings Check
  • Location Settings Request
  • Custom Location Options Configuration
  • Custom Rationale Dialog configuration
  • Custom Permission Blocked Dialog configuration


Breaking Changes from v4.0.0

Text Customizations using Locus.configure{} block which were deprecated in v3.2.0 have been now removed completely. This means rationaleText, rationaleTitle, blockedTitle, blockedText, resolutionTitle, and resolutionText no longer exist on Locus.configure{}. Migration would be to customize/override them from strings.xml.


Locus.configure {
    rationaleTitle = "Rationale Title"
    rationaleTitle = "This is a rationale message."
    blockedTitle = "Permission Blocked Title"
    blockedText = "This is a permission blocked message."
    resolutionTitle = "Permission Resolution Title"
    resolutionText = "This is a permission resolution message."



<string name="locus_rationale_title">Rationale Title</string>
<string name="locus_rationale_message">This is a rationale message.</string>
<string name="locus_permission_blocked_title">Permission Blocked Title</string>
<string name="locus_permission_blocked_message">This is a permission blocked message.</string>
<string name="locus_location_resolution_title">Permission Resolution Title</string>
<string name="locus_location_resolution_message">This is a permission resolution message.</string>
<string name="grant">Grant</string>
<string name="deny">Deny</string>

checkout strings.xml.

How to disable background location permission if you don't use it.

It has been brought to my attention recently that this library includes background location permission in its AndroidManifest.xml file. This could cause a problem when publishing app on Google Play Store in a case where your does not actually request or use background location. If that happens then this is what you need to do.

Just add this line in your app's AndroidManifest.xml file and you should be good to go.

<uses-permission tools:node="remove" android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

Feel free to re-open #53 issue or file a new one if this does not work for you.

Gradle Dependency

  1. Add the JitPack repository.

For Classic Android Project:

Add this in your project's build.gradle file.

allprojects {
    repositories {
        maven { url '' } // add this line only

For Compose Android Project:

Add this in your project's settings.gradle file.

dependencyResolutionManagement {
    repositories {
        maven { url '' } // add this line only
  1. Add the dependency in your app's build.gradle file


dependencies {
    implementation 'com.github.BirjuVachhani:locus-android:latest-version'
    implementation ''


See Wiki on how to get started with Locus.

Background Location Permission Removal

This package adds background location permission to the manifest file regardless whether you are using it or not. If you are not requesting background location permission and you are not planning to use it in future, consider adding this line into your manifest file. This is only required when you publish your app to Google Playstore because they might reject your app because of this. See realted issue #53.

<uses-permission tools:node="remove" android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

Pull Request

To generate a pull request, please consider following Pull Request Template.


To submit an issue, please check the Issue Template.

Code of Conduct

Code of Conduct


You are most welcome to contribute to this project!

Please have a look at Contributing Guidelines, before contributing and proposing a change.

Buy Me A Coffee


   Copyright © 2019 BirjuVachhani

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   See the License for the specific language governing permissions and
   limitations under the License.
Popular Location Projects
Popular Permission Projects
Popular Libraries Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Android Studio
Kotlin Android
Kotlin Dsl
Kotlin Extensions