Change the map mode

This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the Google Maps Platform Service Specific Terms. For more information, see the launch stage descriptions.

Select platform: Android iOS JavaScript

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:

• .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.