72 lines
2.1 KiB
Swift
72 lines
2.1 KiB
Swift
//
|
|
// LocationProviding.swift
|
|
// suixinkan
|
|
//
|
|
|
|
import CoreLocation
|
|
import Foundation
|
|
|
|
/// 位置采集结果。
|
|
struct HomeLocationSnapshot: Sendable, Equatable {
|
|
let latitude: Double
|
|
let longitude: Double
|
|
let address: String
|
|
}
|
|
|
|
/// 定位服务协议，便于 ViewModel 注入与单元测试 mock。
|
|
protocol LocationProviding: Sendable {
|
|
/// 按指定精度请求当前坐标与地址。
|
|
@MainActor
|
|
func requestSnapshot(desiredAccuracy: CLLocationAccuracy) async throws -> HomeLocationSnapshot
|
|
/// 按指定精度请求当前坐标。
|
|
@MainActor
|
|
func requestCoordinate(desiredAccuracy: CLLocationAccuracy) async throws -> CLLocationCoordinate2D
|
|
/// 逆地理编码。
|
|
@MainActor
|
|
func reverseGeocode(latitude: Double, longitude: Double) async -> String
|
|
}
|
|
|
|
extension LocationProviding {
|
|
/// 请求当前坐标与地址，默认使用最高精度以保持既有业务行为。
|
|
@MainActor
|
|
func requestSnapshot() async throws -> HomeLocationSnapshot {
|
|
try await requestSnapshot(desiredAccuracy: kCLLocationAccuracyBest)
|
|
}
|
|
|
|
/// 请求当前坐标，默认使用最高精度以保持既有业务行为。
|
|
@MainActor
|
|
func requestCoordinate() async throws -> CLLocationCoordinate2D {
|
|
try await requestCoordinate(desiredAccuracy: kCLLocationAccuracyBest)
|
|
}
|
|
}
|
|
|
|
/// 定位错误。
|
|
enum LocationProviderError: LocalizedError, Equatable {
|
|
case privacyNotAccepted
|
|
case permissionDenied
|
|
case locationFailed
|
|
|
|
var errorDescription: String? {
|
|
switch self {
|
|
case .privacyNotAccepted:
|
|
"请先阅读并同意隐私政策"
|
|
case .permissionDenied:
|
|
"需要定位权限才能使用此功能"
|
|
case .locationFailed:
|
|
"定位失败，请稍后重试"
|
|
}
|
|
}
|
|
}
|
|
|
|
/// 订单核销场景定位错误，保持原有提示文案。
|
|
enum OrderLocationError: LocalizedError {
|
|
case permissionDenied
|
|
|
|
var errorDescription: String? {
|
|
switch self {
|
|
case .permissionDenied:
|
|
"缺少定位权限，功能无法进行"
|
|
}
|
|
}
|
|
}
|