Need help with Leku?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

AdevintaSpain
614 Stars 155 Forks Apache License 2.0 390 Commits 22 Opened issues

Description

:earth_africa: Map location picker component for Android. Based on Google Maps. An alternative to Google Place Picker.

Services available

!
?

Need anything else?

Contributors list

# 61,984
kotlin-...
kotlin-...
geoloca...
google-...
182 commits
# 136,269
Xamarin
C#
WPF
Kotlin
32 commits
# 25,917
Java
Kotlin
materia...
geoloca...
23 commits
# 129,951
Kotlin
HTML
geoloca...
google-...
10 commits
# 239,277
Kotlin
Java
geoloca...
google-...
9 commits
# 299,843
Java
Kotlin
geoloca...
google-...
3 commits
# 372,658
Kotlin
Java
geoloca...
google-...
2 commits
# 336,789
Java
Kotlin
geoloca...
google-...
2 commits
# 30,253
Java
Kotlin
materia...
google-...
1 commit
# 32,872
kotlin-...
codepen
Three.j...
generat...
1 commit
# 231,442
GraphQL
geoloca...
google-...
Google
1 commit
# 5,414
snippet...
Java
Kotlin
geoloca...
1 commit
# 66,330
android...
Java
Kotlin
geoloca...
1 commit
# 436,574
Kotlin
Java
geoloca...
google-...
1 commit
# 31,023
steam
Kotlin
Symfony
vlc
1 commit

* The location Picker for Android *

Build Status Bintray

Component library for Android that uses Google Maps and returns a latitude, longitude and an address based on the location picked with the Activity provided.


Features | Download | Permissions | Usage | Localization | Customization | Tracking | Extra | Who Made This | Apps using Leku | Contribute | Bugs and Feedback | License


Features

  • Search by voice
  • Search by text
  • Geo Location by GPS, network
  • Google Places (optional)
  • Google Time Zone API (optional)
  • Pick locations using "touch" gestures on the map
  • Customization (Theme and layout)
  • Events Tracking
  • Multi-language support (English, Spanish and Vietnamese supported by default)
  • RTL (Right-To-Left) layout support


Prerequisites

minSdkVersion >= 21
Google Play Services = 17.0.0
AndroidX

Download

Include the jcenter repository in your top

build.gradle
:

Enabled by default on AndroidStudio projects

groovy
allprojects {
    jcenter()
}

Include the dependency in your app

build.gradle
:
dependencies {
    implementation 'com.schibstedspain.android:leku:8.0.0'
}

Alternatively, if you are using a different version of Google Play Services and AndroidX use this instead:

implementation ('com.schibstedspain.android:leku:8.0.0') {
    exclude group: 'com.google.android.gms'
    exclude group: 'androidx.appcompat'
}

For the legacy versions of Leku that does not use AndroidX and want to use the latest Places SDK, you could use it in this way:

implementation ("com.google.android.libraries.places:places-compat:2.2.0")
implementation ("com.schibstedspain.android:leku:5.0.0") {
    exclude group: 'com.google.android.gms'
    exclude module: "play-services-places"
}
Troubleshoot

If you find this issue:

Execution failed for task ':app:transformClassesWithMultidexlistForDebug'. com.android.build.api.transform.TransformException: Error while generating the main dex list: Error while merging dex archives: Program type already present: com.google.common.util.concurrent.ListenableFuture Learn how to resolve the issue at https://developer.android.com/studio/build/dependencies#duplicate_classes.

The workaround for this is:

// Add this to your app build.gradle file
configurations.all {
    // this is a workaround for the issue:
    // https://stackoverflow.com/questions/52521302/how-to-solve-program-type-already-present-com-google-common-util-concurrent-lis
    exclude group: 'com.google.guava', module: 'listenablefuture'
}

Permissions

You must add the following permissions in order to use the Google Maps Android API:

  • android.permission.INTERNET Used by the API to download map tiles from Google Maps servers.

  • android.permission.ACCESSNETWORKSTATE Allows the API to check the connection status in order to determine whether data can be downloaded.

The following permissions are not required to use Google Maps Android API v2, but are recommended.

  • android.permission.ACCESSCOARSELOCATION Allows the API to use WiFi or mobile cell data (or both) to determine the device's location. The API returns the location with an accuracy approximately equivalent to a city block.

  • android.permission.ACCESSFINELOCATION Allows the API to determine as precise a location as possible from the available location providers, including the Global Positioning System (GPS) as well as WiFi and mobile cell data.

  • android.permission.WRITEEXTERNALSTORAGE Allows the API to cache map tile data in the device's external storage area.




You must also explicitly declare that your app uses the android.hardware.location.network or android.hardware.location.gps hardware features if your app targets Android 5.0 (API level 21) or higher and uses the ACCESSCOARSELOCATION or ACCESSFINELOCATION permission in order to receive location updates from the network or a GPS, respectively.

Note: It supports runtime permissions for Android 6 (Marshmallow). You don't need to do anything, it will ask for permissions if needed.

Usage

To use the LocationPickerActivity first you need to add these lines to your AndroidManifest file:

    
        
    
    
    

Then you have setup the call to start this activity wherever you like, always as startActivityForResult. You can set a default location, search zone and other customizable parameters to load when you start the activity. You only need to use the Builder setters like:

val locationPickerIntent = LocationPickerActivity.Builder()
    .withLocation(41.4036299, 2.1743558)
    .withGeolocApiKey("")
    .withSearchZone("es_ES")
    .withSearchZone(SearchZoneRect(LatLng(26.525467, -18.910366), LatLng(43.906271, 5.394197)))
    .withDefaultLocaleSearchZone()
    .shouldReturnOkOnBackPressed()
    .withStreetHidden()
    .withCityHidden()
    .withZipCodeHidden()
    .withSatelliteViewHidden()
    .withGooglePlacesEnabled()
    .withGoogleTimeZoneEnabled()
    .withVoiceSearchHidden()
    .withUnnamedRoadHidden()
    .build(applicationContext)

startActivityForResult(locationPickerIntent, MAP_BUTTON_REQUEST_CODE)

And add the response code from that activity:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    if (resultCode == Activity.RESULT_OK && data != null) {
        Log.d("RESULT****", "OK")
        if (requestCode == 1) {
            val latitude = data.getDoubleExtra(LATITUDE, 0.0)
            Log.d("LATITUDE****", latitude.toString())
            val longitude = data.getDoubleExtra(LONGITUDE, 0.0)
            Log.d("LONGITUDE****", longitude.toString())
            val address = data.getStringExtra(LOCATION_ADDRESS)
            Log.d("ADDRESS****", address.toString())
            val postalcode = data.getStringExtra(ZIPCODE)
            Log.d("POSTALCODE****", postalcode.toString())
            val bundle = data.getBundleExtra(TRANSITION_BUNDLE)
            Log.d("BUNDLE TEXT****", bundle.getString("test"))
            val fullAddress = data.getParcelableExtra
(ADDRESS) if (fullAddress != null) { Log.d("FULL ADDRESS****", fullAddress.toString()) } val timeZoneId = data.getStringExtra(TIME_ZONE_ID) Log.d("TIME ZONE ID****", timeZoneId) val timeZoneDisplayName = data.getStringExtra(TIME_ZONE_DISPLAY_NAME) Log.d("TIME ZONE NAME****", timeZoneDisplayName) } else if (requestCode == 2) { val latitude = data.getDoubleExtra(LATITUDE, 0.0) Log.d("LATITUDE****", latitude.toString()) val longitude = data.getDoubleExtra(LONGITUDE, 0.0) Log.d("LONGITUDE****", longitude.toString()) val address = data.getStringExtra(LOCATION_ADDRESS) Log.d("ADDRESS****", address.toString()) val lekuPoi = data.getParcelableExtra(LEKU_POI) Log.d("LekuPoi****", lekuPoi.toString()) } } if (resultCode == Activity.RESULT_CANCELED) { Log.d("RESULT****", "CANCELLED") } }

That's all folks!

Google Places

Leku now supports Google Places queries using the search box. If you want to enable it these are the steps you need to follow:

  1. Enable Google Places API for Android on your google developer console.

  2. Add the key to the location picker builder

val locationPickerIntent = LocationPickerActivity.Builder()
      .withGooglePlacesApiKey("")

And you are good to go. :)

Localization

If you would like to add more language translations the only thing you have to do is:

  1. Crate a new strings resource folder and file for your language like "/values-ru".
  2. Add all text translations for those strings:
Location Picker
Something went wrong. Please try again.
There are no results for your search
unknown location
Search by voice…
en-EN
Voice
Search

Note that you have the voicesearchextra_language that is used for the language of the voice recognition. Replace it with the allowed voice recognition locale for your language.

I encourage you to add these languages to this component, please fork this project and submit new languages with a PR. Thanks!

Transition Bundle

If you need to send and receive a param through the LocationPickerActivity you can do it. You only need to add an "Extra" param to the intent like:

val locationPickerIntent = LocationPickerActivity.Builder().build(applicationContext)
locationPickerIntent.putExtra("test", "this is a test")
startActivityForResult(locationPickerIntent, MAP_BUTTON_REQUEST_CODE)

And parse it on onActivityResult callback:

val bundle = data.getBundleExtra(LocationPickerActivity.TRANSITION_BUNDLE)
val test = bundle.getString("test")

Customization

Theming

This library uses material components, so should use Theme.MaterialComponents or descendant in manifest.

#E91E63
#C51162
#FBC02D
#E91E63

colorControlActivated
is used to colorize Street title, if not set, it uses colorAccent by default

To customize map, use:

.withMapStyle(R.raw.map_style_retro)

Theme creator here: https://mapstyle.withgoogle.com/

Layout

It's possible to hide or show some of the information shown after selecting a location. Using tha bundle parameter LocationPickerActivity.LAYOUTSTOHIDE you can change the visibility of the street, city or the zipcode.

intent.putExtra(LocationPickerActivity.LAYOUTS_TO_HIDE, "street|city|zipcode")
Legacy Layout

If you want to use the old Leku layout design you need to add this line to the builder:

val locationPickerIntent = LocationPickerActivity.Builder()
    .withLegacyLayout()
Search Zone

By default the search will be restricted to a zone determined by your default locale. If you want to force the search zone you can do it by adding this line with the locale preferred:

intent.putExtra(LocationPickerActivity.SEARCH_ZONE, "es_ES")
Search Zone Rect

If you want to force the search zone you can do it by adding this line with the lower left and upper right rect locations:

intent.putExtra(LocationPickerActivity.SEARCH_ZONE_RECT, SearchZoneRect(LatLng(26.525467, -18.910366), LatLng(43.906271, 5.394197)))
Default Search Zone Locale

If you want to be able to search with the default device locale, you can do it by adding this line:

intent.putExtra(LocationPickerActivity.SEARCH_ZONE_DEFAULT_LOCALE, true)

Note: If you don't specify any search zone it will not search using any default search zone. It will search on all around the world.

Force return location on back pressed

If you want to force that when the user clicks on back button it returns the location you can use this parameter (note: is only enabled if you don't provide a location):

intent.putExtra(LocationPickerActivity.BACK_PRESSED_RETURN_OK, true)
Enable/Disable the Satellite view

If you want to disable the satellite view button you can use this parameter (note: the satellite view is enabled by default):

intent.putExtra(LocationPickerActivity.ENABLE_SATELLITE_VIEW, false)
Enable/Disable requesting location permissions

If you want to disable asking for location permissions (and prevent any location requests)

intent.putExtra(LocationPickerActivity.ENABLE_LOCATION_PERMISSION_REQUEST, false)
Enable/Disable voice search

Now you can hide the voice search option on the search view

intent.putExtra(LocationPickerActivity.ENABLE_VOICE_SEARCH, false)
Hide/Show "Unnamed Road" on Address view

Now you can hide or show the text returned by the google service with "Unnamed Road" when no road name available

intent.putExtra(LocationPickerActivity.UNNAMED_ROAD_VISIBILITY, false)

Tracking

Optionally, you can set a tracking events listener. Implement LocationPickerTracker interface, and set it in your Application class as follows:

LocationPicker.tracker = <>()

Available tracking events are:

|TAG|Message| |---|---| |GOOGLEAPICONNECTIONFAILED|Connection Failed| |STARTVOICERECOGNITIONACTIVITYFAILED|Start Voice Recognition Activity Failed| |ONLOADLOCATIONPICKER|Location Picker| |ONSEARCHLOCATIONS|Click on search for locations| |ONLOCALIZEDME|Click on localize me| |ONLOCALIZEDBYPOI|Long click on map| |SIMPLEONLOCALIZEBYPOI|Click on map| |SIMPLEONLOCALIZEBYLEKUPOI|Click on POI| |RESULT_OK|Return location| |CANCEL|Return without location|

Geocoding API Fallback

In few cases, the geocoding service from Android fails due to an issue with the NetworkLocator. The only way of fixing this is rebooting the device.

In order to cover these cases, you can instruct Leku to use the Geocoding API. To enable it, just use the method '''withGeolocApiKey''' when invoking the LocationPicker.

You should provide your Server Key as parameter. Keep in mind that the free tier only allows 2,500 requests per day. You can track how many times is it used in the Developer Console from Google.

Extra

If you would like to use the Geocoder presenter (MVP) used for this use case you are free to use it! GeocoderPresenter has three methods:

  • getLastKnownLocation: Which obviously returns the last known user location as a Location object.

  • getFromLocationName(String query): Returns a List

    <
    Address
    >
    for the text introduced.

  • getFromLocationName(String query, LatLng lowerLeft, LatLng upperRight): Returns a List

    <
    Address
    >
    for the text and the Rectangle introduced.

  • getDebouncedFromLocationName(String query, int debounceTime): Returns a List

    <
    Address
    >
    for the text introduced. Useful if you want to implement your own search view with auto-complete.

  • getDebouncedFromLocationName(String query, LatLng lowerLeft, LatLng upperRight, int debounceTime): Returns a List

    <
    Address
    >
    for the text and the Rectangle introduced. Useful if you want to implement your own search view with auto-complete.

  • getInfoFromLocation(double latitude, double longitude): Returns a List

    <
    Address
    >
    based on a latitude and a longitude.

To use it first you need to implement the GeocoderViewInterface interface in your class like:

class LocationPickerActivity : AppCompatActivity(), GeocoderViewInterface {

Then you need to setup the presenter:

private val geocoderPresenter: GeocoderPresenter

override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState)


val placesDataSource = GooglePlacesDataSource(Places.getGeoDataClient(this, null)) val geocoder = Geocoder(this, Locale.getDefault()) apiInteractor = GoogleGeocoderDataSource(NetworkClient(), AddressBuilder()) val geocoderRepository = GeocoderRepository(AndroidGeocoderDataSource(geocoder), apiInteractor!!) val timeZoneDataSource = GoogleTimeZoneDataSource( GeoApiContext.Builder().apiKey(GoogleTimeZoneDataSource.getApiKey(this)).build()) geocoderPresenter = GeocoderPresenter( ReactiveLocationProvider(applicationContext), geocoderRepository, placesDataSource, timeZoneDataSource) geocoderPresenter!!.setUI(this)


}

And besides filling the interface methods you have to add some things to your activity/fragment lifecycle to ensure that there are no leaks.

override fun onStart() {
    super.onStart()
    geocoderPresenter!!.setUI(this)
}

override fun onStop() { geocoderPresenter!!.stop() super.onStop() }

Tests

Note: If you need to execute the Espresso test you will need to add the Google Maps Key into the Tests AndroidManifest.xml

Now you have all you need. :)

Important

Searching using the "SearchView" (geocoder) will be restricted to a zone if you are with a Locale from: US, UK, France, Italy and Spain. If not, the search will return results from all the world.

Sample usage

We provide a sample project which provides runnable code samples that demonstrate their use in Android applications. Note that you need to include your Google Play services key in the sample to be able to test it.

Who made this

| Ferran Pons |--- | Ferran Pons

Contributors

Diego Millán

Gerard Pedreny Marc Serra Sergio Castillo Bernat Borras Cristian García
Diego Millán Gerard Pedreny Marc Serra Sergio Castillo Bernat Borras Cristian García

Apps using Leku

The following is a list of some of the public apps using Leku and are published on the Google Play Store.

Want to add your app? Found an app that no longer works or no longer uses Leku? Please submit a pull request on GitHub to update this page!

| | | |---|---|--- | vibbo | Worksi | Domoticz

Contribute

  1. Create an issue to discuss about your idea
  2. Fork it
  3. Create your feature branch (
    git checkout -b my-new-feature
    )
  4. Commit your changes (
    git commit -am 'Add some feature'
    )
  5. Push to the branch (
    git push origin my-new-feature
    )
  6. Create a new Pull Request
  7. Profit! :whitecheckmark:

Bugs and Feedback

For bugs, questions and discussions please use the Github Issues.

License

Copyright 2016-2020 Adevinta Spain S.L.

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

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.