Swift 4/Google Maps自定义信息窗口标记：didTapAt事件无法触发

Hey Bruce, I’ve run into this exact frustration before—copy-pasting map annotation code that just refuses to work, with random code paths never executing. Let’s break this down step by step to get your UIButton working and figure out why your code isn’t running.

First: Diagnose Why Your Code Isn’t Executing #

Most of the time, "code never runs" issues with map annotations boil down to missed setup steps or incorrect lifecycle handling:

• Forgot to set the map view delegate: If you haven’t added mapView.delegate = self (either in code or via IB outlets), none of your annotation-related delegate methods will fire. This is the #1 copy-paste mistake I see.
• Skipped canShowCallout = true: System annotation views won’t display an info window at all unless you explicitly enable this property. If the info window never pops up, your button setup code will never run.
• Incorrect delegate method signatures: Double-check that methods like mapView(_:viewFor:) have the right parameter types (e.g., using MKAnnotation instead of a specific subclass like MKPointAnnotation—if you narrow the type too much, the method won’t be called for all annotations).
• Missing annotation title/subtitle: The system’s default info window requires at least a title to render. If your annotation has no title set, the callout won’t appear, and your code won’t execute.

Quick debugging trick: Add print("Executing [method name]") or set a breakpoint at the start of your annotation-related code to confirm if it’s even being triggered.

Fixing UIButton Interaction in Info Windows #

The key thing to know: The system’s default callout is a static, non-interactive container for custom views. Directly adding a UIButton as a subview to the callout will fail—here’s the correct approach:

Option 1: Use System Callout Accessory Views (Simplest) #

Leverage the built-in leftCalloutAccessoryView and rightCalloutAccessoryView properties, then handle taps via the delegate:

// First, implement the viewFor annotation delegate method
func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
    // Skip the user's location annotation if needed
    guard !(annotation is MKUserLocation) else { return nil }
    
    let reuseID = "CustomPin"
    var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: reuseID) as? MKPinAnnotationView
    
    if annotationView == nil {
        annotationView = MKPinAnnotationView(annotation: annotation, reuseIdentifier: reuseID)
        // Critical: Enable callout
        annotationView?.canShowCallout = true
        
        // Add your custom UIButton to the right callout
        let actionButton = UIButton(type: .custom)
        actionButton.setImage(UIImage(systemName: "info.circle"), for: .normal)
        actionButton.frame = CGRect(x: 0, y: 0, width: 30, height: 30)
        annotationView?.rightCalloutAccessoryView = actionButton
    } else {
        annotationView?.annotation = annotation
    }
    
    return annotationView
}

// Handle the button tap via delegate
func mapView(_ mapView: MKMapView, annotationView view: MKAnnotationView, calloutAccessoryControlTapped control: UIControl) {
    guard let annotation = view.annotation else { return }
    // Your button action logic here (e.g., present a detail VC, open a link)
    print("Button tapped for annotation: \(annotation.title ?? "Unnamed")")
}

Option 2: Fully Custom Info Window (For Complex UIs) #

If you need more than just left/right buttons, you’ll have to create a custom UIView and manually handle its display/hiding (since system callouts don’t support full custom interactive UIs):

1. Create a custom UIView subclass with your buttons and layout.
2. Implement mapView(_:didSelect:) to add your custom view to the map view and position it over the annotation.
3. Implement mapView(_:didDeselect:) to remove the custom view when the annotation is deselected.

Final Quick Checks #

• Verify that your annotation is actually added to the map view with mapView.addAnnotation(yourAnnotation).
• If you’re using a custom annotation class, make sure it conforms to the MKAnnotation protocol correctly (with coordinate, title, and subtitle properties).

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