“`html

Swift CoreLocation 使用指南：最新定位與地圖操作實作（2025）

Swift CoreLocation 是一個強大的框架，可以幫助開發者在應用程式中獲取使用者的地理位置。透過使用 CoreLocation，您可以輕鬆地將定位與地圖操作功能整合到您的 App 中，使其更加完整和互動。本文將深入介紹如何使用 Swift CoreLocation 獲取使用者位置，並將該位置顯示在地圖上。

CoreLocation 基本概念

CoreLocation 框架提供了獲取使用者位置的功能，包括經緯度的獲取和地址的轉換。開發者可以利用此框架來獲取使用者的當前位置，並根據位置進行相關操作。

CoreLocation 實作流程

以下是使用 CoreLocation 獲取位置並顯示在地圖上的完整實作步驟：

1. 配置 Info.plist

首先，您需要在 info.plist 中添加一個隱私描述欄位：Privacy – Location When In Use Usage Description。這將提示使用者您的應用程式需要訪問他們的位置。

2. 設定 CLLocationManager

在 ViewController 中，您需要初始化 CLLocationManager 並設置其代理：

let locationManager = CLLocationManager()
locationManager.delegate = self

3. 請求位置權限

在 viewDidLoad 方法中，請求使用者同意使用位置資訊：

locationManager.requestWhenInUseAuthorization()

4. 獲取位置更新

實作 CLLocationManagerDelegate 的方法，當位置更新時執行相應操作：

func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
    guard let location = locations.last else { return }
    let center = CLLocationCoordinate2D(latitude: location.coordinate.latitude, longitude: location.coordinate.longitude)
    let region = MKCoordinateRegion(center: center, latitudinalMeters: 1000, longitudinalMeters: 1000)
    mapView.setRegion(region, animated: true)
}

5. 添加 MKMapView

在 ViewController 中添加 MKMapView，並設置其代理：

let mapView = MKMapView()
mapView.delegate = self

6. 顯示地址

使用 MKMapViewDelegate 的方法來顯示當前地點的地址：

func mapView(_ mapView: MKMapView, regionDidChangeAnimated animated: Bool) {
    let center = getCenterLocation(for: mapView)
    let geoCoder = CLGeocoder()
    geoCoder.reverseGeocodeLocation(center) { placemarks, error in
        guard let placemark = placemarks?.first else { return }
        let streetNumber = placemark.subThoroughfare ?? ""
        let streetName = placemark.thoroughfare ?? ""
        DispatchQueue.main.async {
            self.addressLabel.text = "\(streetNumber) \(streetName)"
        }
    }
}

func getCenterLocation(for mapView: MKMapView) -> CLLocation {
    let latitude = mapView.centerCoordinate.latitude
    let longitude = mapView.centerCoordinate.longitude
    return CLLocation(latitude: latitude, longitude: longitude)
}

錯誤排除建議

在開發過程中，您可能會遇到一些常見的問題，例如：

• 權限未正確設定：請確保在 info.plist 中已添加位置使用描述。
• 地圖未能顯示位置：檢查是否有正確的地圖視圖設置和位置更新權限。

結論

本文介紹了如何使用 Swift CoreLocation 來獲取使用者位置並顯示在地圖上。通過在 info.plist 中添加必要的隱私描述，並在 ViewController 中實作 CLLocationManager 和 MKMapView，您可以輕鬆地為您的應用程式增添定位功能。

Q&A（常見問題解答）

Q1: 如何處理位置獲取失敗的情況？

A1: 您可以在 locationManager(_:didFailWithError:) 方法中處理錯誤，並提示使用者檢查位置服務。

Q2: 如何在地圖上添加標記？

A2: 使用 MKPointAnnotation 可以在地圖上添加標記，並使用 mapView.addAnnotation() 方法來顯示。

Q3: 可以在不使用地圖的情況下僅獲取位置嗎？

A3: 是的，您可以僅使用 CLLocationManager 獲取位置，而不必顯示地圖。

“`
—