想在 iPhone App 裡加入 Foursquare 的簽到與地點搜尋功能,卻不知從何下手?本文整理了一條可行的整合路徑,從 OAuth 授權到搜尋附近場館,並附上關鍵程式碼。
Foursquare 提供了完整的 API 與範例專案,出發前建議先參考官方文件與範例,了解授權流程與介面呼叫方式。整合的核心在於兩個環節:判斷是否需要授權,以及授權後如何搜尋場館。
下面的範例展示了 viewDidLoad 中的處理邏輯:先檢查是否需要授權,需要的話就彈出 WebView 引導使用者登入;若已完成授權,則直接搜尋附近場館。
- (void)viewDidLoad {
[super viewDidLoad];
self.title = @"Foursquare";
// 檢查是否需要授權
if ([Foursquare2 isNeedToAuthorize]) {
// 需要時顯示 WebView 引導登入
webView = [[UIWebView alloc] initWithFrame:CGRectMake(0, 0, 320, 480)];
NSString *url = [NSString stringWithFormat:@"https://foursquare.com/oauth2/authenticate?display=touch&client_id=%@&response_type=code&redirect_uri=%@", OAUTH_KEY, REDIRECT_URL];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:url]];
[webView loadRequest:request];
[webView setDelegate:self];
[self.view addSubview:webView];
[webView release];
mTableView.hidden = YES;
} else {
// 已授權,顯示主視圖
mTableView.hidden = NO;
[Foursquare2 searchVenuesNearByLatitude:@"40.763"
longitude:@"-73.990"
accuracyLL:nil
altitude:nil
accuracyAlt:nil
query:@""
limit:@"15"
intent:@""
callback:^(BOOL success, id result){
if (success) {
tableData = [[FoursquareParser parseSearchVenuesResultsDictionary:(NSDictionary*)result] retain];
[mTableView reloadData];
}
}];
}
}
整體來說,Foursquare 的整合可以拆成「授權」與「資料取得」兩大步驟。透過 OAuth 2.0 完成身分驗證後,就能呼叫搜尋介面取得周邊場館資料,再交由列表呈現。實際開發時,別忘了把範例中的經緯度、Client ID 與 Redirect URL 換成你自己的設定,並依需求調整搜尋條件。