Google Maps Android API utility library

Handy extensions to the Google Maps Android API. github.com/googlemaps/android-maps-utils

Introduction

This open-source library contains classes that are useful for a wide range of applications using the Google Maps Android API.

The library is under heavy development, but ready for use. Check the issue tracker to see what's happening.

Features/Overview


An introductory video:

Getting Started

The current version of the library is 0.3.2.

Android Studio/Gradle

Add the following dependency to your Gradle build file:

dependencies {
    compile 'com.google.maps.android:android-maps-utils:0.3+'
}

Maven

Add the following to your pom.xml:

<dependency>
    <groupId>com.google.maps.android</groupId>
    <artifactId>android-maps-utils-apklib</artifactId>
    <version>0.3+</version>
    <type>apklib</type>
</dependency>

Note: you must have Google Play services included in your project already. See JakeWharton/gms-mvn-install for one way to do this.

Eclipse/ADT

The library is distributed as a Android library project. See the guide on Android developers for instructions on setting up a library project.

Check out the repository from GitHub and reference the library subdirectory.

(zip download is coming soon)

Feedback

Feedback and feature requests can be filed on the GitHub issue tracker.

Source code

The project is hosted on GitHub.

Building the project

The project uses the Gradle build system. Use of the Gradle wrapper (gradlew) is preferred, as it keeps the build more contained ("hermetic", if you enjoy that kind of thing).

Ensure your ANDROID_HOME environment variable is set correctly. This may be something like "/Applications/Android Studio.app/sdk/" on Mac OS X.

You will also need to download the "Google Repository" in the SDK Manager. (You should be using it in your project already!)

# Build everything
$ ./gradlew assemble

# Run tests
$ ./gradlew instrumentTest

# Install demo app on connected device
# Don't forget to put your own API key in AndroidManifest.xml!
$ ./gradlew installDebug

Contributions

Contributions are welcomed. You can submit a pull request via GitHub.

For your first contribution, you will need to fill out one of the contributor license agreements:

License

Copyright 2013 Google Inc.

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.