iOS 9.0+环境下MKLocalSearchCompleter的替代方案（Swift 4.0）

针对你遇到的MKLocalSearchCompleter仅支持iOS 9.3+，但需要兼容iOS 9.0+的问题，我整理了几个可行的替代方案，同时也会帮你优化之前使用CLGeocoder时的频繁调用问题：

一、优化CLGeocoder的使用：解决频繁调用问题 #

你之前用geocodeAddressString()遇到频繁调用的问题，核心是没做请求节流，苹果的地理编码API确实限制了调用频率，但只要合理控制请求时机，完全可以正常使用。这里推荐用**防抖（Debounce）**机制，只有用户停止输入一段时间后才触发请求，同时取消未完成的旧请求：

import CoreLocation

class LocationSearchHandler: NSObject {
    private let geocoder = CLGeocoder()
    private var pendingSearchTask: DispatchWorkItem?
    
    func performSearch(with query: String) {
        // 取消之前待执行的请求，避免旧请求返回干扰结果
        pendingSearchTask?.cancel()
        
        guard !query.trimmingCharacters(in: .whitespaces).isEmpty else {
            // 清空搜索结果
            return
        }
        
        // 创建新的搜索任务，延迟0.3秒执行（可根据需求调整）
        let task = DispatchWorkItem { [weak self] in
            guard let self = self else { return }
            self.geocoder.geocodeAddressString(query) { placemarks, error in
                if let error = error {
                    print("地理编码失败：\(error.localizedDescription)")
                    return
                }
                // 解析Placemark获取补全建议，比如地址名称、街道等
                let suggestions = placemarks?.compactMap {
                    $0.name ?? $0.thoroughfare ?? $0.locality
                } ?? []
                // 这里可以更新UI展示补全列表
                print("补全建议：\(suggestions)")
            }
        }
        
        pendingSearchTask = task
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3, execute: task)
    }
}

这样设置后，用户快速输入时不会频繁触发API请求，只有输入停顿超过0.3秒才会执行，既符合苹果的调用规范，也能避免无效请求。

二、版本降级适配：结合MKLocalSearchCompleter和MKLocalSearch #

如果系统版本是iOS 9.3+，优先用MKLocalSearchCompleter（它的补全效率更高、结果更精准）；如果是iOS 9.0-9.2，则用MKLocalSearch模拟补全功能，因为MKLocalSearch从iOS 6.0就开始支持了：

import MapKit

class AdaptiveLocationCompleter: NSObject {
    private let completer: MKLocalSearchCompleter?
    private var ongoingSearch: MKLocalSearch?
    
    override init() {
        if #available(iOS 9.3, *) {
            completer = MKLocalSearchCompleter()
            completer?.delegate = self
        } else {
            completer = nil
        }
        super.init()
    }
    
    func updateQuery(_ query: String) {
        let trimmedQuery = query.trimmingCharacters(in: .whitespaces)
        guard !trimmedQuery.isEmpty else {
            // 清空结果
            return
        }
        
        if #available(iOS 9.3, *) {
            completer?.queryFragment = trimmedQuery
        } else {
            // 降级使用MKLocalSearch
            ongoingSearch?.cancel()
            
            let searchRequest = MKLocalSearch.Request()
            searchRequest.naturalLanguageQuery = trimmedQuery
            // 可选：设置搜索区域，让结果更贴近用户所在位置
            searchRequest.region = MKCoordinateRegion(
                center: CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074),
                span: MKCoordinateSpan(latitudeDelta: 0.2, longitudeDelta: 0.2)
            )
            
            ongoingSearch = MKLocalSearch(request: searchRequest)
            ongoingSearch?.start { response, error in
                if let error = error {
                    print("搜索失败：\(error.localizedDescription)")
                    return
                }
                // 解析搜索结果作为补全建议
                let suggestions = response?.mapItems.compactMap { $0.name } ?? []
                // 更新UI展示
                print("低版本补全建议：\(suggestions)")
            }
        }
    }
}

// MKLocalSearchCompleter的代理实现（仅iOS 9.3+生效）
@available(iOS 9.3, *)
extension AdaptiveLocationCompleter: MKLocalSearchCompleterDelegate {
    func completerDidUpdateResults(_ completer: MKLocalSearchCompleter) {
        let suggestions = completer.results.compactMap { $0.title }
        // 更新UI展示补全列表
        print("高版本补全建议：\(suggestions)")
    }
    
    func completer(_ completer: MKLocalSearchCompleter, didFailWithError error: Error) {
        print("Completer失败：\(error.localizedDescription)")
    }
}

这种方案能最大化利用系统API的优势，同时保证低版本的兼容性。

三、额外优化建议 #

• 缓存常用搜索词：可以把用户经常搜索的地址缓存起来，下次输入相同关键词时直接从本地读取，减少API调用。
• 权限处理：如果需要根据用户当前位置缩小搜索范围，记得申请定位权限（NSLocationWhenInUseUsageDescription），这样搜索结果会更精准。
• 错误兜底：当API请求失败时，可以展示历史搜索记录或者默认提示，提升用户体验。

内容的提问来源于stack exchange，提问作者Sazzad Hissain Khan