做天氣 App 時常會遇到這樣的需求:手上只有一組經緯度(來自 GPS 或手動設定),卻要顯示「北京市」這樣的地名。CLGeocoder 的反向地理編碼正是為此而生——它接受座標,回傳 CLPlacemark,裡頭有完整的行政區資訊。
在專案的 Build Phases → Link Binary With Libraries 中新增 CoreLocation.framework。
#import <CoreLocation/CLLocation.h>
#import <CoreLocation/CLLocationManager.h>
#import <CoreLocation/CLGeocoder.h>
#import <CoreLocation/CLPlacemark.h>
實務上直接寫 #import <CoreLocation/CoreLocation.h> 一次搞定更省事。
// 先定義幾組常用城市的座標(這裡以北京、上海為例)
#define BJ_LATITUDE 40.06381
#define BJ_LONGITUDE 116.134657
#define SH_LATITUDE 31.219423
#define SH_LONGITUDE 121.496558
// 以經緯度建立位置物件
CLLocation *loc = [[CLLocation alloc] initWithLatitude:BJ_LATITUDE
longitude:BJ_LONGITUDE];
CLGeocoder *geocoder = [[CLGeocoder alloc] init];
[geocoder reverseGeocodeLocation:loc completionHandler:^(NSArray *array, NSError *error) {
if (array.count > 0) {
CLPlacemark *placemark = [array objectAtIndex:0];
// administrativeArea 對應一級行政區,台灣是縣市,中國大陸是省市
NSString *city = placemark.administrativeArea;
NSLog(@"位於:%@", city);
NSLog(@"%@", placemark);
}
}];
2014-03-19 19:52:01.320 location[1366:70b] 位於:北京市
location[1366:70b] 中國北京市海淀區蘇家坨鎮,
<+0.00000000,+0.00000000> +/- 100.00m,
region CLCircularRegion (identifier:'<+40.02953100,+116.20858200> radius 9051.17',
center:<+40.02953100,+116.20858200>, radius:9051.17m)
反查回來的物件包含大量結構化資訊,依「由大到小」大致是:
country:國家administrativeArea:一級行政區(省/市/縣)subAdministrativeArea:二級行政區locality:城市subLocality:街區thoroughfare:街道subThoroughfare:門牌號postalCode:郵遞區號location:實際座標(可能與輸入略有誤差)值得注意的是,administrativeArea 在不同國家語意不同。若你的 App 要國際化,僅靠這一個欄位顯示「城市」可能會出錯,通常得搭配 locality 一起判斷。
權限描述不可少。iOS 8 之後,Info.plist 必須包含 NSLocationWhenInUseUsageDescription,否則定位相關 API 會靜默失效。不過單純的 CLGeocoder 反查座標並不需要定位權限——只有取得裝置當前位置才需要。
網路依賴與錯誤處理。反向地理編碼需要連網。離線時 error 會是 CLErrorDomain 的相關錯誤碼,務必判斷並提供後備方案(例如快取「座標 → 城市」的對照表)。
回呼在背景佇列。completionHandler 不保證在主執行緒呼叫。若要更新 UI,記得 dispatch 回主執行緒。
節流與快取。系統對地理編碼有頻率限制,短時間內大量呼叫會被拒。實務上應把結果快取起來,避免同一座標重複查詢。
更輕量的替代方案。如果只需要國家或行政區,也可以改用 CLGeocoder 以外的路徑,或是以最近的 CLRegion 做本地判斷,省下一次網路往返。