SwiftData — 地理位置

在 SwiftData 中保存地理位置是一种常见需求，尤其是涉及应用中使用位置功能（如保存用户位置、地点标记等）时。如果你需要保存地理位置，通常存储 经纬度（latitude 和 longitude） 的值是最通用的方法。

以下是如何使用 SwiftData 将地理位置与访存数据模型结合的详细实现方法：

1. 使用 @Model 定义存储地理位置的数据模型 #

在 SwiftData 中，一个地理位置可以通过存储经度和纬度来实现。这些值可以使用 Double 类型进行存储，并通过一个数据模型进行管理。

示例代码 #

import SwiftData

@Model
struct Location {
    var name: String           // 地点的名称
    var latitude: Double       // 纬度
    var longitude: Double      // 经度
    var timestamp: Date = Date() // 保存位置的时间（可选）
}

解释 #

  1. latitude 和 longitude：
    • 用 Double 类型存储地理位置的经纬度。
  2. name（可选的地点名称）：
    • 用户可以为位置命名（如“家”或“公司”）。
  3. timestamp（可选）：
    • 如果需要跟踪地理位置的记录时间，时间戳是一个常见的字段。

2. 如何获取当前位置（地理数据） #

保存地理位置的前提是从设备获取地理数据，可以使用 CoreLocation 框架完成。

示例：获取经纬度 #

import CoreLocation
import SwiftUI

class LocationManager: NSObject, ObservableObject, CLLocationManagerDelegate {
    private var locationManager = CLLocationManager()
    
    @Published var latitude: Double = 0.0
    @Published var longitude: Double = 0.0
    @Published var error: String?

    override init() {
        super.init()
        locationManager.delegate = self
        locationManager.requestWhenInUseAuthorization()
        locationManager.startUpdatingLocation()
    }

    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        guard let location = locations.first else { return }
        
        // 获取到的地理位置信息
        latitude = location.coordinate.latitude
        longitude = location.coordinate.longitude
    }

    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
        self.error = error.localizedDescription
    }
}

解释 #

  1. 使用 CoreLocation 获取设备的地理位置信息。
  2. 在 didUpdateLocations 中通过回调更新经纬度。

3. 将地理位置保存到 SwiftData 数据库 #

从设备中获取到经纬度后，可以通过实例化 Location 数据模型对象，并将其保存到 SwiftData。

示例：保存位置到 SwiftData #

import SwiftUI
import SwiftData

struct LocationSaverView: View {
    @Environment(\.modelContext) private var modelContext // SwiftData 上下文
    @StateObject private var locationManager = LocationManager()

    var body: some View {
        VStack {
            Text("当前纬度: \(locationManager.latitude)")
            Text("当前经度: \(locationManager.longitude)")

            Button("保存当前位置") {
                let newLocation = Location(
                    name: "My Current Location",
                    latitude: locationManager.latitude,
                    longitude: locationManager.longitude
                )
                modelContext.insert(newLocation) // 插入到 SwiftData 上下文
                try? modelContext.save() // 保存持久化数据
            }
        }
        .padding()
    }
}

步骤解析 #

  1. 获取地理位置：
    • 从 LocationManager 中的 latitude 和 longitude 获取当前位置。
  2. 保存到数据模型：
    • 使用 Location 数据模型实例化一个新的位置对象。
    • 调用 modelContext.insert() 将这个对象插入 ModelContext。
    • 调用 try? modelContext.save() 将更改保存到 SwiftData 数据库。

4. 加载并显示保存的地理位置 #

从 SwiftData 数据库中读取存储的地理位置，可以通过 SwiftUI 的 @Query 属性获取数据。

示例：加载并显示保存的地理位置 #

import SwiftUI
import SwiftData

struct LocationListView: View {
    @Query var locations: [Location] // 自动从 SwiftData 数据库中查询所有的 Location

    var body: some View {
        List(locations) { location in
            VStack(alignment: .leading) {
                Text(location.name)
                    .font(.headline)
                Text("纬度: \(location.latitude), 经度: \(location.longitude)")
                    .font(.subheadline)
                Text("记录时间: \(location.timestamp.formatted())")
                    .font(.footnote)
                    .foregroundColor(.gray)
            }
        }
    }
}

步骤解析 #

  1. 使用 @Query 自动加载 SwiftData 中保存的所有地理位置信息。
  2. 将 locations 数组通过 List 组件展示到界面上。
  3. 支持显示位置名称、经纬度及记录时间。

5. 自定义地理位置格式化显示 #

为了改善用户体验，可以减少经纬度的小数位数或将位置显示为具体的地址。

格式化经纬度显示 #

extension Double {
    func formattedCoordinate() -> String {
        String(format: "%.5f", self) // 保留 5 位小数
    }
}

使用方法：

Text("纬度: \(location.latitude.formattedCoordinate()), 经度: \(location.longitude.formattedCoordinate())")

将经纬度转换为地址（反向地理编码） #

使用 CLGeocoder 将经纬度转换为用户熟悉的地址信息：

import CoreLocation

func reverseGeocode(latitude: Double, longitude: Double, completion: @escaping (String?) -> Void) {
    let geocoder = CLGeocoder()
    let location = CLLocation(latitude: latitude, longitude: longitude)
    
    geocoder.reverseGeocodeLocation(location) { placemarks, error in
        if let error = error {
            print("反向地理编码错误: \(error.localizedDescription)")
            completion(nil)
            return
        }
        if let placemark = placemarks?.first {
            let address = "\(placemark.locality ?? ""), \(placemark.country ?? "")"
            completion(address)
        } else {
            completion(nil)
        }
    }
}

将地址信息保存到模型中：

reverseGeocode(latitude: locationManager.latitude, longitude: locationManager.longitude) { address in
    let newLocation = Location(
        name: address ?? "未知位置",
        latitude: locationManager.latitude,
        longitude: locationManager.longitude
    )
    modelContext.insert(newLocation)
    try? modelContext.save()
}

6. 数据模型支持扩展 #

若需要更复杂的地理功能，例如存储一组地理位置或计算两点之间的距离，可以进一步扩展数据模型。

添加距离计算方法 #

import CoreLocation

extension Location {
    func distance(to other: Location) -> CLLocationDistance {
        let currentLocation = CLLocation(latitude: latitude, longitude: longitude)
        let otherLocation = CLLocation(latitude: other.latitude, longitude: other.longitude)
        return currentLocation.distance(from: otherLocation) // 返回距离（单位：米）
    }
}

完整示例总结 #

  1. 模型定义：

    • 使用 SwiftData 的 @Model 定义一个带 latitude、longitude 和可选 name 等字段的数据结构。

  2. 获取地理位置：

    • 使用 CoreLocation 获取设备位置。
    • 将经纬度值传给 Location 模型对象。

  3. 保存地理位置：

    • 使用 SwiftData 的 ModelContext 将获取到的数据持久化。

  4. 显示数据：

    • 使用 @Query 查询保存的地理位置，并通过 List 或其他组件展示。

  5. （选项）附加功能：

    • 反向地理编码获取用户友好的地址。
    • 通过扩展计算地点之间的距离。

借助 SwiftData 和 CoreLocation，你可以快速搭建一个应用来保存和处理地理位置，同时还能享受 SwiftUI 的高效开发流程和系统级持久化支持！

本文共 1629 字，上次修改于 Jan 24, 2025