Places SDK for Android code samples

AI-generated Key Takeaways

• This page provides instructions for setting up and running sample apps that demonstrate the use of the Places SDK for Android.

• The sample apps are available in both Kotlin and Java, accessible through a GitHub repository.

• You'll need to clone the repository, import the project into Android Studio, and configure your API keys to run the examples.

• The provided samples showcase various functionalities like Place Autocomplete, offering a starting point for developing your own Android apps with Places SDK.

• Troubleshooting information is included if the map doesn't display, guiding you to verify the API key configuration.

Select platform: Android iOS JavaScript

The Places SDK for Android samples repository on GitHub includes sample apps that demonstrate the use of the Places SDK for Android. 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 Place Autocomplete.

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 [e-mail]:googlemaps-samples/android-places-demos.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-places-demos/demo-kotlin
   • Java: PATH-REPO/android-places-demos/demo-java
3. Select Open. Android Studio builds your project, using the Gradle build tool.
4. In your top-level project directory, create a secrets.properties file.
5. Get an API key from your project with the Places API and/or Places API (New) enabled.

6. In the secrets.properties file, add the following strings, replacing YOUR_API_KEY with the value of your API key:

       PLACES_API_KEY=YOUR_API_KEY
       MAPS_API_KEY=YOUR_API_KEY
     

7. Run the app.