mapbox-ios-patterns

Map(viewport: $viewport)
    .mapStyle(.standard)
    .ornamentOptions(OrnamentOptions(
        scaleBar: .init(visibility: .visible),
        compass: .init(visibility: .adaptive),
        logo: .init(position: .bottomLeading)
    ))

import UIKit
import MapboxMaps
 
class MapViewController: UIViewController {
    private var mapView: MapView!
 
    override func viewDidLoad() {
        super.viewDidLoad()
 
        let options = MapInitOptions(
            cameraOptions: CameraOptions(
                center: CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194),
                zoom: 12
            )
        )
 
        mapView = MapView(frame: view.bounds, mapInitOptions: options)
        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.addSubview(mapView)
 
        mapView.mapboxMap.loadStyle(.standard)
    }
}

import SwiftUI
@_spi(Experimental) import MapboxMaps
 
struct ContentView: View {
    var body: some View {
        Map {
            Marker(coordinate: CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194))
                .color(.red)
                .text("San Francisco")
        }
    }
}

Map {
    ForEvery(locations, id: \.id) { location in
        Marker(coordinate: location.coordinate)
            .color(.red)
            .text(location.name)
    }
}

Map(viewport: $viewport) {
    PointAnnotation(coordinate: CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194))
        .image(.init(image: UIImage(named: "marker")!, name: "marker"))
}

// Create annotation manager (once, reuse for updates)
var pointAnnotationManager = mapView.annotations.makePointAnnotationManager()
 
// Create marker
var annotation = PointAnnotation(coordinate: CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194))
annotation.image = .init(image: UIImage(named: "marker")!, name: "marker")
annotation.iconAnchor = .bottom
 
// Add to map
pointAnnotationManager.annotations = [annotation]

let annotations = locations.map { coordinate in
    var annotation = PointAnnotation(coordinate: coordinate)
    annotation.image = .init(image: UIImage(named: "marker")!, name: "marker")
    return annotation
}
 
pointAnnotationManager.annotations = annotations

<key>NSLocationWhenInUseUsageDescription</key>
<string>Show your location on the map</string>

import CoreLocation
 
// Request permissions
let locationManager = CLLocationManager()
locationManager.requestWhenInUseAuthorization()
 
// Show user location puck
mapView.location.options.puckType = .puck2D()
mapView.location.options.puckBearingEnabled = true

// ❌ Don't create new managers repeatedly
func updateMarkers() {
    let manager = mapView.annotations.makePointAnnotationManager()
    manager.annotations = markers
}
 
// ✅ Create once, reuse
let pointAnnotationManager: PointAnnotationManager
 
init() {
    pointAnnotationManager = mapView.annotations.makePointAnnotationManager()
}
 
func updateMarkers() {
    pointAnnotationManager.annotations = markers
}

// ✅ Update all at once
pointAnnotationManager.annotations = newAnnotations
 
// ❌ Don't update one by one
for annotation in newAnnotations {
    pointAnnotationManager.annotations.append(annotation)
}

// Use weak self in closures
mapView.gestures.onMapTap.observe { [weak self] context in
    self?.handleTap(context.coordinate)
}.store(in: &cancelables)
 
// Clean up on deinit
deinit {
    cancelables.forEach { $0.cancel() }
}

// ✅ Standard style is optimized and recommended
.mapStyle(.standard)
 
// Use other styles only when needed for specific use cases
.mapStyle(.standardSatellite) // Satellite imagery

mapView.mapboxMap.onStyleLoaded.observe { [weak self] _ in
    print("Style loaded successfully")
    // Add layers and sources here
}.store(in: &cancelables)