地圖上標記位置的那個 view 叫 marker(或 pin),點下去後彈出的那個叫 CalloutView。系統預設樣式很樸素,要換成自訂版面,得先理解這兩者其實都是 annotation。
一個 annotation 對應一個 view。系統幫你管的情況是:annotation 對應 MKPinAnnotationView(marker),點擊後彈出的資訊框則由同一個 view 的 leftCalloutAccessoryView 等屬性或預設樣式產生,而這個預設框幾乎無法客製。
因此自訂的思路是:把 callout 也當成一個獨立的 annotation 來處理。做法是定義兩個 annotation 類別——CustomPinAnnotation 代表地上的圖釘,CustomCalloutAnnotation 代表彈出的資訊框。圖釘沿用系統樣式就好,通常只要換一張圖;資訊框則完全自繪成 CustomCalloutView。
1. 呼叫 addAnnotation: 加入一個 CustomPinAnnotation。系統會回呼 delegate 的 viewForAnnotation:,你在這裡回傳一個 MKPinAnnotationView(記得設定 canShowCallout = NO,否則系統預設框會跟自訂框打架)。
2. 使用者點擊圖釘,系統呼叫 didSelectAnnotationView:。你在這個方法裡 addAnnotation: 一個 CustomCalloutAnnotation,座標設為圖釘位置。
3. 這次 add 又會觸發 viewForAnnotation:。這回你判斷型別,回傳自製的 CustomCalloutView 即可。
4. 使用者點到別處或地圖移動時,記得把 callout annotation 移除,避免殘留。
在 viewForAnnotation: 中做型別分流是關鍵:
- (MKAnnotationView *)mapView:(MKMapView *)mapView
viewForAnnotation:(id<MKAnnotation>)annotation {
if ([annotation isKindOfClass:[CustomCalloutAnnotation class]]) {
// 回傳自訂的 callout view
CustomCalloutView *callout = [[CustomCalloutView alloc] initWithAnnotation:annotation
reuseIdentifier:@"Callout"];
callout.canShowCallout = NO;
return callout;
}
// 一般圖釘
MKPinAnnotationView *pin = [[MKPinAnnotationView alloc] initWithAnnotation:annotation
reuseIdentifier:@"Pin"];
pin.image = [UIImage imageNamed:@"pin.png"];
pin.canShowCallout = NO; // 關掉系統預設框
return pin;
}
自訂 view 通常要在其中擺放圖片與文字標籤,並在 initWithAnnotation: 時把 annotation 的 title、subtitle 等值取出來 assign 給子視圖。另外別忘了實作 prepareForReuse 之外的 reuse 邏輯,因為 MKMapView 會重用 view,未清空的舊內容會殘留。
若需要「氣泡尾巴」指向圖釘的視覺效果,可以用 Core Graphics 畫一個帶尖角的三角形,或者直接把氣泡底圖做成九宮格切圖再拼上。

上面這套「用兩個 annotation 疊出 callout」的技巧,是在 iOS 9 之前常見的解法,因為當時系統幾乎不給客製空間。iOS 9 之後,蘋果為 MKAnnotationView 加入了 detailCalloutAccessoryView,可以直接塞入任何 UIView 作為資訊框內容;配合 leftCalloutAccessoryView 與 rightCalloutAccessoryView,多數「自訂彈出內容」的需求都能在不離開系統 callout 的前提下完成,動畫、箭頭指向、點擊外部關閉等行為都由系統處理。
因此現在的建議順序是:先看 detailCalloutAccessoryView 能否滿足需求(多數情況可以);確實需要完全自繪時,再考慮上述的雙 annotation 做法,或改用第三方地圖函式庫。無論走哪條路,「annotation 對應 view、view 由 delegate 提供」這個基本模型都沒有改變,先理解它,之後實作任何變形都不會迷路。