Swift 3纯代码实现地图显示用户位置及标注问题求助

Hey there! Let's fix those issues one by one — I’ve been in your shoes switching from Storyboards to pure code, so I know how easy it is to miss those small but critical details.

1. Fixing the "Zoom to User Location on Launch" Problem #

First, let’s address why your current code isn’t working:

• You’re creating a local mapView variable instead of using the class-level mapView property, which breaks delegate connections and future references.
• You’re initializing the map region with an empty noLocation coordinate, so it can’t zoom to a real user position.
• You haven’t properly configured CLLocationManager to request and receive the user’s actual location.

Here’s how to fix it:

Step 1: Update the Map Setup #

Replace your setupMapView method to use the class property and add location manager configuration:

func setupMapView() {
    // Initialize the map to fill the entire view, with auto-resizing for rotation
    mapView = MKMapView(frame: view.bounds)
    mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    
    // Configure map properties
    mapView.mapType = .standard
    mapView.isZoomEnabled = true
    mapView.isScrollEnabled = true
    mapView.showsCompass = true
    mapView.showsScale = true
    mapView.showsUserLocation = true
    mapView.delegate = self // Required for overlay rendering later
    
    view.addSubview(mapView)
    
    // Set up location tracking
    setupLocationManager()
}

Step 2: Configure Location Manager #

Add this method to handle location permissions and updates:

func setupLocationManager() {
    locationManager.delegate = self
    locationManager.desiredAccuracy = kCLLocationAccuracyBest // Use highest accuracy for user location
    
    // Handle location authorization status
    switch CLLocationManager.authorizationStatus() {
    case .notDetermined:
        locationManager.requestWhenInUseAuthorization() // Ask for permission
    case .authorizedWhenInUse, .authorizedAlways:
        locationManager.startUpdatingLocation() // Start fetching location
    case .denied, .restricted:
        // Alert user if permission is denied
        let alert = UIAlertController(
            title: "Location Access Needed",
            message: "Please enable location access in Settings to see your current position.",
            preferredStyle: .alert
        )
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        present(alert, animated: true)
    @unknown default:
        break
    }
}

Step 3: Zoom to User Location #

Implement the CLLocationManagerDelegate methods to get the user’s location and set the map region:

func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
    guard let userLocation = locations.last else { return }
    
    // Stop updating location to save battery once we have the position
    locationManager.stopUpdatingLocation()
    
    // Define zoom level (smaller delta = closer zoom)
    let zoomSpan = MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
    let userRegion = MKCoordinateRegion(center: userLocation.coordinate, span: zoomSpan)
    
    // Animate the map to the user's location
    mapView.setRegion(userRegion, animated: true)
}

// Handle permission changes after the user updates settings
func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
    if manager.authorizationStatus == .authorizedWhenInUse || manager.authorizationStatus == .authorizedAlways {
        locationManager.startUpdatingLocation()
    }
}

Critical Note #

Don’t forget to add the NSLocationWhenInUseUsageDescription key to your Info.plist with a message like "Need location access to show your current position on the map." — your app will crash without this.

2. Adding Long-Press to Drop Pins & Circle Overlays #

Converting your Storyboard IBAction to pure code is straightforward — we’ll add a long-press gesture recognizer directly to the map view.

Step 1: Add the Gesture Recognizer #

Add this code at the end of your setupMapView method:

// Create long-press gesture for pin dropping
let longPress = UILongPressGestureRecognizer(target: self, action: #selector(handleLongPress(_:)))
longPress.minimumPressDuration = 0.5 // Adjust how long the user needs to press
mapView.addGestureRecognizer(longPress)

Step 2: Handle the Long-Press Action #

Add this method to create pins and circle overlays when the user long-presses:

@objc func handleLongPress(_ gesture: UILongPressGestureRecognizer) {
    // Only trigger when the gesture starts (avoid repeated calls during the press)
    guard gesture.state == .began else { return }
    
    // Convert the touch point to map coordinates
    let touchPoint = gesture.location(in: mapView)
    let pinCoordinate = mapView.convert(touchPoint, toCoordinateFrom: mapView)
    
    // Create and add the pin annotation
    let pin = MKPointAnnotation()
    pin.coordinate = pinCoordinate
    pin.title = "Custom Pin"
    pin.subtitle = "Added via long-press"
    mapView.addAnnotation(pin)
    
    // Create and add a 100-meter radius circle overlay
    let circleOverlay = MKCircle(center: pinCoordinate, radius: 100)
    mapView.addOverlay(circleOverlay)
}

Step 3: Render the Circle Overlay #

Implement the MKMapViewDelegate method to style the circle:

func mapView(_ mapView: MKMapView, viewFor overlay: MKOverlay) -> MKOverlayView? {
    guard let circle = overlay as? MKCircle else { return nil }
    
    let circleView = MKCircleOverlayView(overlay: circle)
    circleView.strokeColor = .systemBlue
    circleView.fillColor = UIColor.systemBlue.withAlphaComponent(0.2)
    circleView.lineWidth = 2
    return circleView
}

Full Updated Code #

Here’s the complete, cleaned-up version of your MapViewController:

import UIKit
import MKMapKit
import CoreLocation

class MapViewController: UIViewController, MKMapViewDelegate, CLLocationManagerDelegate {
    var mapView: MKMapView!
    let locationManager = CLLocationManager()

    override func viewDidLoad() {
        super.viewDidLoad()
        setupMapView()
    }

    func setupMapView() {
        mapView = MKMapView(frame: view.bounds)
        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        
        mapView.mapType = .standard
        mapView.isZoomEnabled = true
        mapView.isScrollEnabled = true
        mapView.showsCompass = true
        mapView.showsScale = true
        mapView.showsUserLocation = true
        mapView.delegate = self
        
        // Add long-press gesture
        let longPress = UILongPressGestureRecognizer(target: self, action: #selector(handleLongPress(_:)))
        longPress.minimumPressDuration = 0.5
        mapView.addGestureRecognizer(longPress)
        
        view.addSubview(mapView)
        setupLocationManager()
    }

    func setupLocationManager() {
        locationManager.delegate = self
        locationManager.desiredAccuracy = kCLLocationAccuracyBest
        
        switch CLLocationManager.authorizationStatus() {
        case .notDetermined:
            locationManager.requestWhenInUseAuthorization()
        case .authorizedWhenInUse, .authorizedAlways:
            locationManager.startUpdatingLocation()
        case .denied, .restricted:
            let alert = UIAlertController(
                title: "Location Access Required",
                message: "Enable location access in Settings to view your current position.",
                preferredStyle: .alert
            )
            alert.addAction(UIAlertAction(title: "OK", style: .default))
            present(alert, animated: true)
        @unknown default:
            break
        }
    }

    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        guard let userLocation = locations.last else { return }
        locationManager.stopUpdatingLocation()
        
        let zoomSpan = MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
        let userRegion = MKCoordinateRegion(center: userLocation.coordinate, span: zoomSpan)
        mapView.setRegion(userRegion, animated: true)
    }

    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
        if manager.authorizationStatus == .authorizedWhenInUse || manager.authorizationStatus == .authorizedAlways {
            locationManager.startUpdatingLocation()
        }
    }

    @objc func handleLongPress(_ gesture: UILongPressGestureRecognizer) {
        guard gesture.state == .began else { return }
        
        let touchPoint = gesture.location(in: mapView)
        let pinCoordinate = mapView.convert(touchPoint, toCoordinateFrom: mapView)
        
        let pin = MKPointAnnotation()
        pin.coordinate = pinCoordinate
        pin.title = "Custom Pin"
        pin.subtitle = "Long-press created"
        mapView.addAnnotation(pin)
        
        let circleOverlay = MKCircle(center: pinCoordinate, radius: 100)
        mapView.addOverlay(circleOverlay)
    }

    func mapView(_ mapView: MKMapView, viewFor overlay: MKOverlay) -> MKOverlayView? {
        guard let circle = overlay as? MKCircle else { return nil }
        
        let circleView = MKCircleOverlayView(overlay: circle)
        circleView.strokeColor = .systemBlue
        circleView.fillColor = UIColor.systemBlue.withAlphaComponent(0.2)
        circleView.lineWidth = 2
        return circleView
    }
}

内容的提问来源于stack exchange，提问作者CJ90