https://github.com/memaev/androidplacepicker
Simple android Maps Picker library based on Google Maps SDK
https://github.com/memaev/androidplacepicker
android google google-maps-api kotlin kotlin-android library location location-services maps
Last synced: 6 months ago
JSON representation
Simple android Maps Picker library based on Google Maps SDK
- Host: GitHub
- URL: https://github.com/memaev/androidplacepicker
- Owner: memaev
- License: mit
- Created: 2024-02-17T16:01:34.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-01T16:17:50.000Z (over 1 year ago)
- Last Synced: 2025-02-06T09:18:35.423Z (8 months ago)
- Topics: android, google, google-maps-api, kotlin, kotlin-android, library, location, location-services, maps
- Language: Kotlin
- Homepage:
- Size: 180 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Place Picker
✅ This is the light-weight and simple for use place picker library for Android.
Written on Kotlin, using Jetpack Compose and Google Maps SDK.
> [!TIP]
> Library is still in development stage. Feel free to contribute 👨💻
## Adding library to your project
In order to add library to your project you need to do the following:
- Add `Jitpack` to your `settings.gradle`
- Add dependency to your **app** level `build.gradle`
- Add place picker activity to your `AndroidManifest.xml`
### Adding jitpack
To your `settings.gradle.kts` add Jitpack import:
***Kotlin DSL***
```
dependencyResolutionManagement {
...
repositories {
maven{ url = uri("https://jitpack.io") }
}
}
```
***Groovy***
```
dependencyResolutionManagement {
...
repositories {
maven { url 'https://jitpack.io' }
}
}
```
### Adding dependency to `build.gradle`
Add the following dependency to app module `build.gradle` file:
***Kotlin DSL***
```
dependencies{
...
implementation("com.github.memaev:AndroidPlacePicker: [current-version]")
}
```
***Groovy***
```
dependencies{
...
implementation 'com.github.memaev:AndroidPlacePicker: [current-version]'
}
```
> [!NOTE]
> Replace [current-version] with the latest version of the library. You can view it in releases tab.
### Add place picker activity to `AndroidManifest.xml`
In order to open new activity for place picking you need to mark it in your manifest file.
To do it go to **manifest -> AndroidManifest.xml** and add new `activity` to your application:
``` xml
```
## How to use
> [!IMPORTANT]
> You need to get your Google Maps API key before, to use Place Picker!
> [How to get api key](https://developers.google.com/maps/documentation/android-sdk/get-api-key)
> [How to add api key to your project](https://developers.google.com/maps/documentation/android-sdk/secrets-gradle-plugin)
1. Register activity result receiver in your activity:
``` kotlin
private val pickerActivityResult = registerForActivityResult(
ActivityResultContracts.StartActivityForResult()
){result->
val address = result.data?.getParcelable(LOCATION) // Location class is from library's sources
if (result.resultCode== RESULT_OK && address!=null){
// Access all information about the location
val name = address.name?:"Default name"
val latitude = address.latitude
val longitude = address.longitude
}else{
//Failed
}
}
```
2. Call PlacePicker intent builder, provide the Google Maps SDK API key, call build and provide context. Then start the intent with `pickerActivityResult` that was created before:
``` kotlin
val intent = PlacePicker.IntentBuilder()
.setApiKey("your-api-key")
.build(this)
pickerActivityResult.launch(intent)
```
> [!IMPORTANT]
>Enjoy using the library and add it to the favourites!