Skip to content

Android place picker module for searching and selecting a location on google maps

License

Notifications You must be signed in to change notification settings

esam00/SimplePlacePicker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Android Studio v4.0

SimplePlacePicker Android

If you have a use case that requires searching and selecting a specific location on map , Here is a nice independent module that you can simply import into your project to handle this scenario with some customizations

Features

  • Rich autoComplete and search for any location with the ability to filter results depending on country.
  • Get parsed string address for any location on map with a specified language.
  • Restrict specific supported areas for user to only pick from .
  • Listen for GPS configuration changes and ask user to enable GPS once it is disabled.

Requirements :

  1. Minimum SDK version 21
  2. Androidx
  3. Google Places Api key

Setup :

Before importing simpleplacepicker module into your android project, make sure that :

  1. your project manifest file contains internet and location permissions
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  1. add meta_data for google api key in application tag within manifest file
<application
    --
    --
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="@string/places_api_key" />
</application>

Make sure that you have original google places api key not only google maps key as autocomplete won't work without Places key.

  1. add this code to the the project level build.gradle file
allprojects {
  repositories {
    --
    --
    maven { url "https://jitpack.io" }
  }
}

How to import as Module

  1. Clone or download simplePlacePicker and save it at a path that you know.
  2. In your android project, Go to File > New > Import Module..
  3. Enter the path of simpleplacepicker module and click finish.
  4. After android studio finishes syncing, go to File > Project Structure and select Dependencies.
  5. Now you should see that you have two modules , your app module and simpleplacepicker module
  6. Select app module and in Declared dependencies section click the plus icon and choose Module Dependency
  7. Choose simpleplacepicker and click Ok.

Now you are ready to use SimplePlacePicker as a part of your project ^-^

just create intent and add extras to get some customization

        Intent intent = new Intent(this, MapActivity.class);
        Bundle bundle = new Bundle();

        bundle.putString(SimplePlacePicker.API_KEY,apiKey);
        bundle.putString(SimplePlacePicker.COUNTRY,country);
        bundle.putString(SimplePlacePicker.LANGUAGE,language);
        bundle.putStringArray(SimplePlacePicker.SUPPORTED_AREAS,supportedAreas);

        intent.putExtras(bundle);
        startActivityForResult(intent, SimplePlacePicker.SELECT_LOCATION_REQUEST_CODE);

Example project : TestPlacePicker

SimplePlacePicker module is implemented with the help of :

About

Android place picker module for searching and selecting a location on google maps

Topics

Resources

License

Stars

Watchers

Forks

Languages