Google Places SDK for Android Demos

This repo contains several standalone applications that demonstrate use of the Google Places SDK for Android:

1. demo-java: Basic Java application demonstrating core Places SDK capabilities including Place Autocomplete (Intent and Programmatic), Place Details, and Current Place.
2. demo-kotlin: The Kotlin equivalent of the standard Java demo, showing idiomatic usage of the base SDK.
3. kotlin-demos: Demonstrates the use of the android-places-ktx library, highlighting Kotlin Coroutines support and modernized API responses for the Places SDK.
4. PlaceDetailsCompose: Shows how to build modern, interactive Place Details UI screens leveraging Jetpack Compose and the New Places API.
5. PlaceDetailsUIKit: Shows how to build immersive Place Details UI screens using modern Android Views (UIKit) and the New Places API.
6. PlacesUIKit3D: Blends the Places API with the Photorealistic 3D Maps SDK, providing an immersive location-viewing experience with dynamic camera fly-alongs.

Additionally, the snippets app contains code snippets used across the official Google Places SDK developer documentation.

Getting Started

These demos use the Gradle build system.

First download the demos by cloning this repository or downloading an archived snapshot. (See the options on the right hand side.)

In Android Studio, use "Open an existing Android Studio project", and select the root directory (android-places-demos). This will load all the demo modules at once.

Alternatively use the ./gradlew assembleDebug command from the root directory to build all projects simultaneously.

The demos require that you provide your own API keys. The project enforces the presence of required keys before the build can even start to prevent runtime crashes.

1. Get an API Key with the Places API (New) and Maps SDK for Android enabled.
2. In the root directory, create a secrets.properties file (this is git-ignored to prevent accidental commits).
3. Add your keys. See local.defaults.properties for the complete list of required and secondary optional keys. At minimum, you must add the required keys:

   PLACES_API_KEY=AIza...
   MAPS_API_KEY=AIza...

   Optional Keys: There are also optional keys required for specific demos to function completely:
   • MAPS3D_API_KEY: Required only for the PlacesUIKit3D demo to load the Photorealistic 3D Maps tiles.
   • MAP_ID: Required only for the PlaceDetailsCompose demo to demonstrate cloud-based map styling.

   MAPS3D_API_KEY=AIza...
   MAP_ID=...

4. Sync the Android Studio project, build, and run any of the application modules.

Running Demos via Command Line

Each runnable project includes a convenient installAndLaunch task. Instead of using Android Studio, you can natively build, install, and execute any demo directly on your connected device or emulator with a single command:

# Launch the standard Java Demo
./gradlew :demo-java:installAndLaunch

# Launch the Kotlin Demo
./gradlew :demo-kotlin:installAndLaunch

# Launch the Kotlin Coroutines (KTX) Demo
./gradlew :kotlin-demos:installAndLaunch

# Launch the Jetpack Compose Demo
./gradlew :PlaceDetailsCompose:installAndLaunch

# Launch the UIKit Demo
./gradlew :PlaceDetailsUIKit:installAndLaunch

# Launch the Photorealistic 3D Maps Demo
./gradlew :PlacesUIKit3D:installAndLaunch

# Launch the Documentation Snippets app
./gradlew :snippets:installAndLaunch

Terms of Service

This sample uses Google Maps Platform services. Use of Google Maps Platform services through this sample is subject to the Google Maps Platform Terms of Service.

If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region. Learn more.

This sample is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this sample.

Support

This sample is offered via an open source license. It is not governed by the Google Maps Platform Support Technical Support Services Guidelines, the SLA, or the Deprecation Policy. However, any Google Maps Platform services used by the sample remain subject to the Google Maps Platform Terms of Service.

If you find a bug, or have a feature request, please file an issue on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our developer community channels. If you'd like to contribute, please check the contributing guide.

You can also discuss this sample on our Discord server.