Join us for our next
Google Maps Platform Developer Community Day in San Francisco in December!
Apply now to attend.
Send feedback
Change the map mode
Stay organized with collections
Save and categorize content based on your preferences.
Important: You must set the map mode when loading a map. If the mode isn't
specified, the map will fail to load.
The following 3D map modes are available in the Maps 3D SDK for iOS:
Known issue: .roadmap mode isn't working on some devices in the
current SDK release. A fix is anticipated imminently.
science .roadmap shows the default roadmap view with basemap labels.
.satellite shows a photorealistic map based on aerial imagery.
.hybrid shows the satellite map view with basemap labels.
Set the map mode
Set the map mode when initializing the Map view by specifying the
mode parameter with one of the
MapMode enum
cases:
import SwiftUI
import GoogleMaps3D
struct ContentView : View {
var body : some View {
Map ( mode : . roadmap )
}
}
Bind the map mode to a state variable to change it dynamically:
import SwiftUI
import GoogleMaps3D
struct ContentView : View {
@ State private var mapMode : MapMode = . roadmap
var body : some View {
Map ( mode : mapMode )
}
}
Use cases
The following are common use cases for each map mode:
Roadmap: Ideal for navigation-heavy apps where legibility and street-level
data are primary.
Satellite and Hybrid: Ideal for real estate, environmental monitoring, or
tourism apps where visual fidelity and terrain context are essential.
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-22 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-10-22 UTC."],[],[]]