The Maps 3D SDK for Android lets Android apps display interactive 3D maps built from Google's 3D imagery. It provides markers, popovers, polylines, polygons, glTF 3D models, camera path animations, and controls for user interaction and camera movement.

## Maps 3D SDK for Android: key facts

- **Product:** Maps 3D SDK for Android
- **Also known as:** Maps 3D Android SDK
- **Category:** Maps
- **Platform:** Android
- **Runs on:** Client (app or browser code)
- **Launch stage:** GA
- **Lifecycle:** Active
- **Overview:** [Maps 3D SDK for Android overview](https://developers.google.com/maps/documentation/maps-3d/android-sdk/overview.md.txt)
- **Regional availability:** Limited. Availability varies by country and region; see the Maps 3D (JavaScript, Android, iOS) column on the Google Maps Platform coverage page. ([coverage details](https://developers.google.com/maps/coverage.md.txt))

## Maps 3D SDK for Android: when to use it

**Use Maps 3D SDK for Android when:**

- You need to show an interactive, photorealistic 3D map of real-world locations in an Android app.
- You need markers, popovers, polylines, polygons, or glTF 3D models placed on a 3D map in an Android app.
- You need predefined camera animations (fly-to, fly-around) that guide users between points on a 3D map.
- You need to control which camera movements and UI controls users can use on a 3D map in an Android app.
**Don't use Maps 3D SDK for Android when:**

- You're building a web app that needs 3D maps. Use [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript/quick-reference.md.txt) instead.
- You're building an iOS app that needs 3D maps. Use [Maps 3D SDK for iOS](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/quick-reference.md.txt) instead.
- You need a production-ready standard 2D street map in an Android app (`ROADMAP` mode in this SDK is Experimental). Use [Maps SDK for Android](https://developers.google.com/maps/documentation/android-sdk/quick-reference.md.txt) instead.

## Maps 3D SDK for Android: setup

- **Service to enable:** `mapsandroid.googleapis.com`
- **Authentication:** API key
- **Get started:** [Set up Maps 3D SDK for Android](https://developers.google.com/maps/documentation/maps-3d/android-sdk/setup.md.txt)
- **Reference:** [Maps 3D SDK for Android reference](https://developers.google.com/maps/documentation/maps-3d/android-sdk/reference.md.txt)
- **Pricing:** [Maps 3D SDK for Android usage and billing](https://developers.google.com/maps/documentation/maps-3d/android-sdk/usage-and-billing.md.txt)
- **Policies:** [Maps 3D SDK for Android policies](https://developers.google.com/maps/documentation/maps-3d/android-sdk/policies-attributions.md.txt)
- **Release notes:** [Maps 3D SDK for Android release notes](https://developers.google.com/maps/documentation/maps-3d/android-sdk/release-notes.md.txt)

**Official Maps 3D SDK for Android packages:**

- maven: `com.google.android.gms:play-services-maps3d`

## Maps 3D SDK for Android: related products

- **Often used with:** [Places SDK for Android](https://developers.google.com/maps/documentation/places/android-sdk/quick-reference.md.txt)

## Maps 3D SDK for Android: common mistakes

- **Problem:** If the map mode isn't specified when the map loads, the map fails to load. **Fix:** Always set a `Map3DMode` (`SATELLITE`, `HYBRID`, or `ROADMAP`) in layout XML (`map3d:mapMode`) or with `setMapMode`/`Map3DInitConfig`. See [/maps/documentation/maps-3d/android-sdk/map-modes](https://developers.google.com/maps/documentation/maps-3d/android-sdk/map-modes.md.txt).
- **Problem:** Click listeners (map and marker clicks) don't run on the main UI thread, so direct UI updates from the handler fail. **Fix:** Switch to the main thread before updating UI, for example with `lifecycleScope.launch(Dispatchers.Main)`. See [/maps/documentation/maps-3d/android-sdk/add-a-marker](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-a-marker.md.txt).
- **Problem:** Map state is shared across `Map3DView` instances, so markers, overlays, and camera position from an old view carry over to a new one. **Fix:** Keep only one active `Map3DView`; call `onDestroy()` on the old instance and manually clear markers, overlays, and reset the camera through `GoogleMap3D`. See [/maps/documentation/maps-3d/android-sdk/add-a-3d-map](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-a-3d-map.md.txt).
- **Problem:** By default, tapping a basemap point of interest shows the Places UI widget, which also requires the Places SDK dependency. **Fix:** Add the Places SDK for Android dependency, and return `true` from `onMap3DClick` in `OnMap3DClickListener` to suppress the default widget if you don't want it. See [/maps/documentation/maps-3d/android-sdk/points-of-interest](https://developers.google.com/maps/documentation/maps-3d/android-sdk/points-of-interest.md.txt).

## What you can do with Maps 3D SDK for Android

See the guides linked below for each task, or compare across products in the
[Capabilities Explorer](https://developers.google.com/maps/documentation/capabilities-explorer.md.txt).

- [Add an interactive, photorealistic 3D map to a web page.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-a-3d-map.md.txt)
- [Add a marker to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-a-marker.md.txt)
- [Customize a marker on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/marker-customization.md.txt)
- [Add a 3D model to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-3d-models.md.txt)
- [Add a 3D polyline to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-polylines.md.txt)
- [Add a 3D polygon to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-polygons.md.txt)
- [Respond to user interactions and events on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/add-a-3d-map.md.txt#listen_for_map_click_events)
- [Customize the controls that appear on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/configure-camera-controls.md.txt#ui_controls)
- [Control camera path and animations on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/custom-camera-paths.md.txt)
- [Control camera restrictions on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/android-sdk/map-camera-restrictions.md.txt)