Maps SDK for Android sample code

Select platform: Android iOS JavaScript

The Maps SDK for Android repositorysitory on GitHub includes samples illustrating the use of the Maps SDK for Android in your Android app.

The repository contains the ApiDemos app, a sample app that lets you build and run the samples from a single Android app. Import and build the app, add your API key, view the demo, and use the sample code supplied as a starting point for your app.

When you run the sample app, it displays a list of available samples that you can run on your own device. Select one of the options. For example, click Basic Map.

Troubleshooting: If the sample app runs successfully but you don't see a map, check that you've added your API key to the app's manifest file, as described in Using API Keys.

Clone and run the samples

Git is required to run this sample locally. The following command clones the sample application repository.

git clone git@github.com:googlemaps-samples/android-samples.git

Import the sample project into Android Studio:

  1. In Android Studio, select File > New > Import Project.
  2. Go to the location where you saved the repository and select the project directory for Kotlin or Java:

    • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
    • Java: PATH-REPO/android-samples/ApiDemos/java
  3. Select Open. Android Studio builds your project, using the Gradle build tool.
  4. Open your project's local.properties file.
  5. Add the following string, replacing YOUR_API_KEY with the value of your API key:

    MAPS_API_KEY=YOUR_API_KEY
  6. Run the app.

Sample app for maps on Wear OS

A sample app is available on GitHub, which you can use as a starting point when building a wearable app. The sample shows you how to set up a basic Google Map on Wear OS.