萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS 逆地理編碼最佳實踐:CLGeocoder 獲取結構化地址(國家/省/市/街道/郵編)

現代 API:CLGeocoder (iOS 5+)

已棄用:MKReverseGeocoder (iOS 8 棄用),請遷移至 CLGeocoder。

核心代碼


@interface GeoCoderHelper : NSObject
+ (void)reverseGeocodeLocation:(CLLocation *)location
                  completion:(void (^)(NSString *formattedAddress, CLPlacemark *placemark, NSError *error))completion;
@end

@implementation GeoCoderHelper

+ (void)reverseGeocodeLocation:(CLLocation *)location completion:(void (^)(NSString *, CLPlacemark *, NSError *))completion {
    CLGeocoder *geocoder = [[CLGeocoder alloc] init];
    [geocoder reverseGeocodeLocation:location completionHandler:^(NSArray *placemarks, NSError *error) {
        if (error) {
            completion(nil, nil, error);
            return;
        }
        CLPlacemark *placemark = placemarks.firstObject;
        NSString *address = [self formattedAddressFromPlacemark:placemark];
        completion(address, placemark, nil);
    }];
}

+ (NSString *)formattedAddressFromPlacemark:(CLPlacemark *)placemark {
    // 中國地址格式:國家 省 市 區 街道 號
    return [NSString stringWithFormat:@"%@%@%@%@%@%@",
        placemark.country ?: @"",
        placemark.administrativeArea ?: @"",
        placemark.locality ?: @"",
        placemark.subLocality ?: @"",
        placemark.thoroughfare ?: @"",
        placemark.subThoroughfare ?: @""];
}

// 便捷方法:直接經緯度
+ (void)reverseGeocodeLatitude:(CLLocationDegrees)lat longitude:(CLLocationDegrees)lon completion:(void (^)(NSString *, CLPlacemark *, NSError *))completion {
    CLLocation *loc = [[CLLocation alloc] initWithLatitude:lat longitude:lon];
    [self reverseGeocodeLocation:loc completion:completion];
}
@end

CLPlacemark 完整字段對照表

關鍵注意事項

  1. 必須聯網:Apple 服務端解析,離線不可用
  2. 頻率限制:每分鐘請求數有限制,批量查詢需節流、緩存
  3. 語言跟隨系統:返回地址語言 = 設備語言,無法強制指定
  4. 權限前置:Info.plist 必配 NSLocationWhenInUseUsageDescription,且需用戶授權
  5. 異步回調:主線程回調,可直接更新 UI
  6. 錯誤處理:kCLErrorNetwork、kCLErrorGeocodeFoundNoResult、kCLErrorGeocodeFoundPartialResult

Swift 版本


func reverseGeocode(latitude: CLLocationDegrees, longitude: CLLocationDegrees) async throws -> String {
    let location = CLLocation(latitude: latitude, longitude: longitude)
    let placemarks = try await CLGeocoder().reverseGeocodeLocation(location)
    guard let pm = placemarks.first else { throw CLError(.geocodeFoundNoResult) }
    return [pm.country, pm.administrativeArea, pm.locality, pm.subLocality, pm.thoroughfare, pm.subThoroughfare]
        .compactMap { $0 }.joined()
}

高級:離線/自建地址庫方案

若需離線、高頻、無網環境:

  • 內嵌 GeoNames / OpenStreetMap 精簡數據庫 (SQLite)
  • 使用 Geohash / QuadTree 索引快速查找最近 POI
  • 或接入高德/騰訊/百度地圖 SDK 逆地理編碼(需商業授權)
copyright © 萬盛學電腦網 all rights reserved
屬性中文含義示例 (北京國貿)
namePOI 名稱中國國際貿易中心
country國家中國
ISOcountryCodeISO 國家碼CN
administrativeArea省/直轄市/自治區北京市
subAdministrativeArea地級市(省轄)北京市
locality區/縣級市朝陽區
subLocality街道/鄉鎮建國門街道
thoroughfare道路名建國路
subThoroughfare門牌號88號
postalCode郵政編碼100020
areasOfInterest商圈/地標[@"CBD", @"國貿"]
inlandWater內陸水體—
ocean海洋—