Get Started Contact sales

GoogleMaps3D Framework Reference

View

extension View where Controls : MapControl, Self : MapAnimatable
 
extension View where Self : MapAnimatable
 
extension View where Self : MapAnimatable, Trigger : Equatable
 
extension View where Self : MapContentTappable

Available where `Controls` : `MapControl`, `Self` : `MapAnimatable`

  • Adds custom controls to the map view.

    Use this modifier to place controls like the compass, zoom buttons at a specific position on the map. Applying this modifier multiple times for the same position will overwrite any previously set controls for that position.

    Controls are ordered from top to bottom for vertical positions (.leading, .trailing) and from left to right for horizontal positions (.top, .bottom).

    Use SwiftUI’s Spacer to push controls to one side, attach them to the opposite side, or add flexible space between them.

    Map(mode: .hybrid)
  .mapControls(at: .trailing) {
    CompassControl()
    ZoomControl()
  }
  .mapControls(at: .top) {
    Spacer()
    PanHorizontalControl()
  }

    Declaration

    Swift

    @MainActor
@preconcurrency
func mapControls<Controls>(at position: MapControlPosition = .trailing, margin: CGFloat = 16, spacing: CGFloat = 8, @MapControlsBuilder _ controls: () -> Controls) -> some MapAnimatable & View

    Parameters

    at

    The edge of the map where the controls should be placed. Defaults to .trailing.
    margin

    The distance between the controls and the map edge. Defaults to 16.
    spacing

    The distance between individual controls in the stack. Defaults to 8.
    controls

    A result builder closure that specifies the controls to display.

Available where `Self` : `MapAnimatable`

  • Applies a set of restrictions to the map’s camera behavior.

    Use this modifier to constrain how the user can manipulate the map’s viewpoint, ensuring it stays within defined altitude, heading, tilt, or geographical bounds. Applying an empty array removes any existing restrictions.

    Map(mode: .hybrid)
  .cameraRestrictions([
    .altitude(0...10000), // Limit zoom-out altitude
    .tilt(0...60)         // Limit maximum tilt
  ])

    Note

    If the array has more than one restriction of the same type, the last one will be used.

    Declaration

    Swift

    @MainActor
@preconcurrency
func cameraRestrictions(_ restrictions: [CameraRestriction]) -> Self

    Parameters

    restrictions

    An array of CameraRestriction cases defining the limits to apply to the camera’s movement and orientation.

    Return Value

    The Map instance, allowing for further modifier chaining.

  • Adds a closure to be called when the map is tapped.

    Declaration

    Swift

    @MainActor
@preconcurrency
func onTap(_ handler: @escaping (MapTapInfo) -> Void) -> some MapAnimatable & View

    Parameters

    handler

    A closure that the system calls when the map is tapped. This closure receives a MapTapInfo object containing tap content information and geographic coordinates.

Available where `Self` : `MapAnimatable`, `Trigger` : `Equatable`

  • Fly the camera around the given center camera with the given duration and repeat count.

    Declaration

    Swift

    @MainActor
@preconcurrency
func flyCameraAround<Trigger>(_ camera: Camera, duration: TimeInterval = 2, repeatCount: Double = 1, trigger: Trigger, completion: (() -> Void)? = nil) -> ModifiedContent<Self, EquatableChangeModifier<Trigger>>

    Parameters

    camera

    The center camera to fly around.
    duration

    The duration of one animation cycle in seconds.
    repeatCount

    The number of times to fly around the center camera.
    trigger

    The trigger to fly the camera.
    completion

    The callback to be called when the animation is complete.

  • Fly the camera to the given destination camera with the given duration.

    Declaration

    Swift

    @MainActor
@preconcurrency
func flyCameraTo<Trigger>(_ camera: Camera, duration: TimeInterval = 2, trigger: Trigger, completion: (() -> Void)? = nil) -> ModifiedContent<Self, EquatableChangeModifier<Trigger>>

    Parameters

    camera

    The destination camera to fly to.
    duration

    The duration of the animation in seconds.
    trigger

    The trigger to fly the camera.
    completion

    The callback to be called when the animation is complete.

Available where `Self` : `MapContentTappable`

  • Registers a handler to be called when the map content is tapped.

    Declaration

    Swift

    @MainActor
@preconcurrency
func onTap(_ handler: @escaping () -> Void) -> some MapContent

    Parameters

    handler

    The handler to be called when the map content is tapped.

Available where `Self` : `MapAnimatable`

  • Adds a closure to be called when a place is tapped to determine the behavior of the built-in place information plugin.

    Declaration

    Swift

    @MainActor
@preconcurrency
func onPlaceTap(_ handler: @escaping (String) -> PlaceTapAction) -> some MapAnimatable & View

    Parameters

    handler

    A closure that the system calls when a place is tapped. This closure receives the place ID and returns a PlaceTapAction.