https://github.com/akexorcist/googledirectionlibrary
[Android] Library for Google Direction API for Google Maps Android API v2
https://github.com/akexorcist/googledirectionlibrary
android android-library java kotlin
Last synced: 7 months ago
JSON representation
[Android] Library for Google Direction API for Google Maps Android API v2
- Host: GitHub
- URL: https://github.com/akexorcist/googledirectionlibrary
- Owner: akexorcist
- License: apache-2.0
- Created: 2015-11-30T00:48:42.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-04-18T04:09:23.000Z (almost 5 years ago)
- Last Synced: 2025-05-24T23:12:19.038Z (8 months ago)
- Topics: android, android-library, java, kotlin
- Language: Java
- Homepage:
- Size: 2.26 MB
- Stars: 572
- Watchers: 34
- Forks: 175
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](http://android-arsenal.com/details/1/1374)
[](https://search.maven.org/artifact/com.akexorcist/google-direction-library)
[](https://github.com/akexorcist/GoogleDirectionLibrary/actions)
# Android-GoogleDirectionLibrary
Google Maps Direction API helper for Android
Download
===============================
Since version 2.1.2 will [move from JCenter to MavenCentral](https://developer.android.com/studio/build/jcenter-migration)
```groovy
// build.gradle (project)
allprojects {
repositories {
mavenCentral()
/* ... */
}
}
```
**Gradle**
```
implementation 'com.akexorcist:google-direction-library:1.2.1'
```
Sample Code
===============================
Simple Direction Request
```kotlin
GoogleDirection.withServerKey("YOUR_SERVER_API_KEY")
.from(LatLng(37.7681994, -122.444538))
.to(LatLng(37.7749003,-122.4034934))
.avoid(AvoidType.FERRIES)
.avoid(AvoidType.HIGHWAYS)
.execute(
onDirectionSuccess = { direction: Direction? ->
if(direction.isOK()) {
// Do something
} else {
// Do something
}
},
onDirectionFailure = { t: Throwable ->
// Do something
}
)
```
Multiple Waypoints Direction Request
```kotlin
GoogleDirection.withServerKey("YOUR_SERVER_API_KEY")
.from(LatLng(41.8838111, -87.6657851))
.and(LatLng(41.8766061, -87.6556908))
.and(LatLng(41.8909056, -87.6467561))
.to(LatLng(41.9007082, -87.6488802))
.transportMode(TransportMode.DRIVING)
.execute(
onDirectionSuccess = { direction: Direction? ->
if(direction.isOK()) {
// Do something
} else {
// Do something
}
},
onDirectionFailure = { t: Throwable ->
// Do something
}
)
```
or
```kotlin
val waypoints: List = listOf(
LatLng(41.8766061, -87.6556908),
LatLng(41.8909056, -87.6467561)
)
GoogleDirection.withServerKey("YOUR_SERVER_API_KEY")
.from(LatLng(41.8838111, -87.6657851))
.and(waypoints)
.to(LatLng(41.9007082, -87.6488802))
.transportMode(TransportMode.DRIVING)
.execute(
onDirectionSuccess = { direction: Direction? ->
if(direction.isOK()) {
// Do something
} else {
// Do something
}
},
onDirectionFailure = { t: Throwable ->
// Do something
}
)
```
See example code for more detail
To get API key, please read [Get Google Maps Direction API Key](https://developers.google.com/maps/documentation/directions/get-api-key)
Demo
===============================
Try it at [Google Play](https://play.google.com/store/apps/details?id=com.akexorcist.googledirection.sample)
ProGuard
===========================
```
-keep class com.google.android.gms.maps.** { *; }
-keep interface com.google.android.gms.maps.* { *; }
-dontwarn retrofit2.**
-keep class retrofit2.** { *; }
-keepattributes Signature
-keepattributes Exceptions
-keepclasseswithmembers class * {
@retrofit2.http.* ;
}
-keep class com.akexorcist.googledirection.model.** { *;}
```
Change Log
====
See [CHANGELOG.md](CHANGELOG.md)
Licence
===========================
Copyright 2021 Akexorcist
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or 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.