You're all set!

To start developing, please head over to our developer documentation.

Activate the Google Maps Android API

To get you started we'll guide you through the Google Developers Console to do a few things first:

  1. Create or choose a project
  2. Activate the Google Maps Android API
  3. Create appropriate keys
Continue

Google Maps Android API Utility Setup

This page describes how to set up the Google Maps Android API utility library, and to run the demo app included in the library.

Quick setup

Add the following dependency to your app's Gradle build file:

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

Use one of the utilities from the library, such as marker clustering, heatmaps, or the other utilities.

Prerequisites and notes

The Google Maps Android API utility library supports Android API level 9 and above. The animated re-clustering features are only available for Android API level 14 and above. When setting your project build target, make sure you use the latest Android API level.

The reference documentation is available on GitHub.

Get the Google Maps Android API utility library

Download the android-maps-utils repository. You can do it by cloning the repo (recommended, to receive automatic updates) or downloading a zip file. If you want to customize the library, you should fork the repo.

The repository includes:

  • A demo application, in the demo directory.
  • The library of utilities, in the library directory.
  • Various files containing license, contributors, and readme information.
  • Gradle build configuration, for use with Android Studio.

Run the utility demo app

The utility library ships with a demo app that includes sample implementations of each utility. Follow these steps to run the demo app on your Android device.

  1. Clone the utility library:
    git clone https://github.com/googlemaps/android-maps-utils.git
    
  2. In Android Studio, choose File -> New -> Import Project.
  3. Browse to and select (double-click) the android-maps-utils directory that was created when you cloned the utility library. Android Studio now builds the project.
  4. If you haven't already done so, enable developer mode on the Android device. Then attach the Android device to your computer.
  5. Build and run the demo app.

The app should open on the Android device, displaying a list of utilities including clustering, poyutil, heatmap, and more. You can also find the app in your app list, under the name Maps Utils Demo.

Send feedback about...

Google Maps Android API
Google Maps Android API
Need help? Visit our support page.