The Maps 3D SDK for iOS lets you build 3D map experiences in iOS apps using Google's 3D imagery. It provides SwiftUI APIs for markers, popovers, polylines, polygons, 3D models (glTF), camera path animations, and camera and interaction controls.

## Maps 3D SDK for iOS: key facts

- **Product:** Maps 3D SDK for iOS
- **Category:** Maps
- **Platform:** iOS
- **Runs on:** Client (app or browser code)
- **Launch stage:** GA
- **Lifecycle:** Active
- **Overview:** [Maps 3D SDK for iOS overview](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/overview.md.txt)

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

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

- You need an interactive, photorealistic 3D map in a native iOS (SwiftUI) app.
- You need to place markers, popovers, polylines, polygons, or glTF 3D models on a 3D map in iOS.
- You need fly-to or fly-around camera animations, or camera restrictions, on a 3D map in iOS.
- You need users to tap 3D map points of interest and see place details through the built-in Places UI Kit widget.
**Don't use Maps 3D SDK for iOS when:**

- You need a 3D map in an Android app. Use [Maps 3D SDK for Android](https://developers.google.com/maps/documentation/maps-3d/android-sdk/quick-reference.md.txt) instead.
- You need a 3D map in a web page. Use [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript/quick-reference.md.txt) instead.
- You need a standard 2D map in an iOS app. Use [Maps SDK for iOS](https://developers.google.com/maps/documentation/ios-sdk/quick-reference.md.txt) instead.

## Maps 3D SDK for iOS: setup

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

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

- swift_package: `https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)`
- swift_package: `https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)`

## Maps 3D SDK for iOS: related products

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

## Maps 3D SDK for iOS: common mistakes

- **Problem:** If no map mode is set when the map loads, the map fails to load. **Fix:** Always pass a mode when creating the `Map`, for example `Map(mode: .hybrid)`. See [/maps/documentation/maps-3d/ios-sdk/map-modes](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/map-modes.md.txt).
- **Problem:** Setting the API key both in the app entry point and on individual map views produces a console error. **Fix:** Set `Map.apiKey` in one place only: the app entry point or each map view. See [/maps/documentation/maps-3d/ios-sdk/setup](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/setup.md.txt).
- **Problem:** `Camera` `altitudeMode` is ignored outside camera animations; it only applies to `flyCameraTo` and `flyCameraAround`. **Fix:** Use `flyCameraTo` or `flyCameraAround` when you depend on the `Camera` `altitudeMode`. See [/maps/documentation/maps-3d/ios-sdk/custom-camera-paths](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/custom-camera-paths.md.txt).
- **Problem:** In `GoogleMaps3DKit` the Places UI widget shows by default when a user taps a point of interest. **Fix:** Use `placeInformationEnabled(false)` or return `.none` from `onPlaceTap(_:)` to suppress the widget. See [/maps/documentation/maps-3d/ios-sdk/points-of-interest](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/points-of-interest.md.txt).

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

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/ios-sdk/add-a-3d-map.md.txt)
- [Add a marker to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/add-a-marker.md.txt)
- [Customize a marker on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/marker-customization.md.txt)
- [Add a 3D model to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/add-3d-models.md.txt)
- [Add a 3D polyline to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/add-polylines.md.txt)
- [Add a 3D polygon to a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/add-polygons.md.txt)
- [Respond to user interactions and events on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/add-a-3d-map.md.txt#listen_for_map_tap_events)
- [Customize the controls that appear on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-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/ios-sdk/custom-camera-paths.md.txt)
- [Control camera restrictions on a photorealistic 3D map.](https://developers.google.com/maps/documentation/maps-3d/ios-sdk/map-camera-restrictions.md.txt)