開始使用 Places SDK for iOS (Objective-C)

開始使用 Places SDK for iOS (Objective-C)

程式碼研究室簡介

subject上次更新時間：12月 3, 2021
account_circle作者：Laurence Moroney

1. 事前準備

開始編寫程式碼之前，您必須設定一些先決條件。

Xcode

本教學課程使用 Apple 的 Xcode 工具以及 Objective-C 語言，建立可在模擬器中執行的簡易 iOS 應用程式。你不需要實體裝置。您可以前往 https://developer.apple.com/xcode/ 取得 Xcode

CocoaPods

Places SDK for iOS 可做為 CocoaPods pod。CocoaPods 是 Swift 和 Objective-C 專案的開放原始碼依附元件管理工具。如果您尚未安裝這項工具，請先進行安裝，再進行後續操作。您可以從終端機安裝，如下所示：

sudo gem install cocoapods

如要進一步瞭解 CocoaPods，請參閱 CocoaPods 入門指南。

安裝 SDK

如要安裝 SDK，您需要在專案目錄中建立 Podfile，讓 CocoaPods 用來下載和設定必要的依附元件。最簡單的方法是在 Xcode 中建立新專案，在其中新增 Podfile 並安裝 Pod。

開啟 [Xcode] 後，您會看到「歡迎使用 Xcode'」畫面。在這裡選取 [建立新的 Xcode 專案]

4f1ecee473937c7b.png

在下一個畫面中，系統會請您為新專案提供範本。選取 [單一檢視應用程式] (適用於 iOS 裝置)，然後按下 [下一步]。

要求提供產品名稱時，您可以選擇任何所需的項目，但請記得記下系統產生的軟體包 ID。您稍後會用到。

72fbf25cb2db22ad.png

按 [下一步]，即可為您建立專案。記下建立目錄的目錄。關閉 Xcode 並使用終端機，前往該目錄。

使用終端機，輸入下列指令：

pod init

系統將為您建立名為 Podfile 的檔案。編輯以在 Google 地圖上新增 pod，如下所示：

target '{YOUR APP NAME}' do
pod 'GoogleMaps'
end

儲存並關閉 Xcode。請務必關閉專案，因為在下一個步驟中，您將要編輯基礎專案。完成之後，您必須打開一個不同的工程文件，這裡的設計人很常識到一切都像以前他們之前都不接近 Xcode！現在，在終端機中前往專案目錄，然後執行「pod install&#39」；範例如下：

789c5bc62817f68a.png

完成後，系統就會安裝 pod 並建立新的 .xcworkspace 檔案。從現在起，請為專案套用這項設定。不過在編寫程式碼之前，接下來您就需要提供 API 金鑰。

2. 取得 API 金鑰

在下列啟用步驟中，啟用 Maps SDK for iOS。

設定 Google 地圖平台

如果您還沒有 Google Cloud Platform 帳戶和已啟用計費功能的專案，請參閱開始使用 Google 地圖平台指南，建立帳單帳戶和專案。

  1. 在 Cloud Console 中按一下專案下拉式選單，然後選取您要用於這個程式碼研究室的專案。

  1. 在 Google Cloud Marketplace 中啟用此程式碼研究室所需的 Google 地圖平台 API 和 SDK。詳細步驟請參閱這部影片或這份文件。
  2. 在 Cloud Console 的「憑證」頁面中產生 API 金鑰。你可以按照這部影片或這份說明文件中的步驟進行。傳送至 Google 地圖平台的所有要求都需要 API 金鑰。

3. 建立 Places API 應用程式

現在您已經建立了主控台專案，並已為其啟用 Places API，並取得 API 金鑰後，就可以開始編寫第一個 Places API 應用程式。

安裝 pod 檔案之前，系統已為您建立新的 .xcworkspace 檔案。按兩下即可開啟。

19d62f34c08e645c.png

您會在「專案多層檢視」中發現，您現已建立了名為「Pods'」的新資料夾。如果成功，您就會看到內含架構的 GoogleMaps 資料夾。

8844d861f64c61aa.png

4. 編輯 Info.plist 檔案。

首次執行應用程式時，iOS 會顯示一個對話方塊，要求使用者授予定位服務的存取權限。這個對話方塊會提供您定義的字串，並將其放在 Info.plist 檔案中。如果這個字串不存在，此對話方塊並不會顯示，應用程式也無法繼續運作。

您可以在 Project Explorer 中找到 Info.plist 檔案，網址如下：

c224c920ab3f1ef.png

只要選取該標籤，系統就會列出 plist 編輯器。

859ca56f3b19da5.png

將滑鼠移到任何元素上，您就會看見「+'」圖示。按下該按鈕後，您就會看到新的項目。在這個方塊中，輸入「NSLocationAlwaysUsageDescription&#39」值。

9fb225d6f5508794.png

按下 Enter 鍵即可新增按鍵。接著按兩下此鍵值的「值」欄，並新增一個字串：

5aefeb184187aa58.png

如要進一步瞭解這個字串，請參閱 Apple 開發人員說明文件。

5. 編輯應用程式委派

在專案多層檢視中，找出並開啟 AppDelegate.m 以開啟 API 金鑰。

請在檔案頂端的 ## 行下方加入以下內容：

@import GoogleMaps;

然後在 doFinishLaunchingWithOptions: 函式中，加入有關「return YES' line:」的指令。

[GMSServices provideAPIKey:@"<Add your API Key>"];

請務必使用您之前產生的 API 金鑰。

6. 編輯您的分鏡腳本檔案

在專案多層檢視中，開啟 Main.storyboard 檔案。按下右上角的側欄按鈕，確定側欄已啟用。

352af28b970d9e2.png

接著，在側欄底部選取 [Object Library] (物件庫)，即可找到標籤控制項。

adec7051ae949531.png

在左側的「View Controller Scene」中，確認已選取「View'」：

e4827b92b5861e3e.png

然後將 7 個標籤拖曳到檢視畫面中。請按照這裡的說明排列。請務必拖曳廣告素材的大小，以符合顯示內容。如要編輯標籤中的文字，請按兩下文字，然後輸入必要值：

f8a9457772358069.png

針對最底層的標籤 (真的大標籤)，請前往屬性編輯器，確定它設定為 0 行 (預設值為 1)。這將允許顯示多行。

a4abacf00d8888fe.png

7. 為值建立插座

對於 3“值'標籤，您需要建立一個插座。如此一來，您就能使用程式碼變更其值。如果要這麼做，必須先啟用助理編輯器。做法是先按一下屬性側欄的 [移除] 按鈕，即可予以移除。(這個按鈕顯示在上一個步驟中)

然後，選取助理按鈕，這裡就是雙圓圈的圓圈：

e92dcc4ceea20a51.png

請確定該檔案可以顯示 ViewController.h 檔案。如果不支援，你可以使用助理視窗頂端的編輯器來變更設定。

d42f0fcc18b84703.png

然後，按住 CONTROL 鍵後，將每個標籤拖放至助理中 ViewController.h 檔案的 @face 行下方。系統會顯示一個對話方塊，詢問您要建立的連線類型：

a44b7888ed0f62b.png

請確認設定如下所示 (連線：插座；類型：UILabel；儲存空間：低)，然後為各個項目命名。就本程式碼研究室而言，我分別將「經度」、「緯度」、「高度」標籤分別稱為「lblLongitude」、「lblLatitude」和「lblAltidude」。也可以從底部拖曳大型標籤，並將其命名為 lblPlaces。

完成後，ViewController.h 檔案應該會如下所示：

#import <UIKit/UIKit.h>
@import GoogleMaps;

@interface ViewController : UIViewController
@property (weak, nonatomic) IBOutlet UILabel *lblLatitude;
@property (weak, nonatomic) IBOutlet UILabel *lblLongitude;
@property (weak, nonatomic) IBOutlet UILabel *lblAltitude;
@property (weak, nonatomic) IBOutlet UILabel *lblPlaces;

@end

8. 編輯 Location 和 Google Client API 的標頭檔案

在最後一個步驟 (您必須建置使用 Places API 的應用程式) 中，您必須在標頭檔案 (ViewController.h) 中再設定幾個變數。以下是核心位置管理員和核心位置物件：

@property (strong, nonatomic) CLLocationManager *locationManager;
@property (strong, nonatomic) CLLocation *location;

您還需要 Google API 用戶端：

@property GMSPlacesClient *placesClient;

最後，您必須更新標頭檔案，讓類別實作 CLLocationManagerDelegate：

@interface ViewController : UIViewController<CLLocationManagerDelegate>

完成後，您的標頭檔案看起來應該會像這樣：

#import <UIKit/UIKit.h>
#import <CoreLocation/CoreLocation.h>
#import <GoogleMaps/GoogleMaps.h>


@interface ViewController : UIViewController<CLLocationManagerDelegate>
@property (strong, nonatomic) CLLocationManager *locationManager;
@property (strong, nonatomic) CLLocation *location;
@property (weak, nonatomic) IBOutlet UILabel *lblLongitude;
@property (weak, nonatomic) IBOutlet UILabel *lblLatitude;
@property (weak, nonatomic) IBOutlet UILabel *lblAltitude;
@property (weak, nonatomic) IBOutlet UILabel *lblPlaces;

@property GMSPlacesClient *placesClient;
@end

9. 編輯您的資料檢視控制器

第一個步驟是編輯 view 最多載入函式，以初始化位置管理員，並要求使用者授權存取位置資訊，最後再啟動位置管理員，讓它能夠追蹤目前的位置。您也會初始化 Google Places API 用戶端。

- (void)viewDidLoad {
    [super viewDidLoad];
    self.locationManager = [[CLLocationManager alloc]init];
    self.locationManager.desiredAccuracy = kCLLocationAccuracyBest;
    if([self.locationManager respondsToSelector:@selector(requestAlwaysAuthorization)]) {
        [self.locationManager requestAlwaysAuthorization];
        // Or [self.locationManager requestWhenInUseAuthorization];
    }
    [self.locationManager startUpdatingLocation];
    
    self.locationManager.delegate = self;
    self.location = [[CLLocation alloc] init];
    self.placesClient = [GMSPlacesClient sharedClient];
}

10. 處理位置更新

「位置管理員」會呼叫 doUpdateLocations 函式，將您傳回的位置更新與「檢視控制器」一併傳回。你必須把它新增到 ViewController.m。此函式看起來像這樣：

-(void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations{
    // Enter code here
}

這個函式需要執行一些動作。

首先，它會快取最近收到的位置。

self.location = locations.lastObject;

接著，請更新「Google 定位」、「經度」和「高度」這 3 個標籤：

self.lblLatitude.text = [NSString stringWithFormat:@"%f", self.location.coordinate.latitude];

self.lblLongitude.text = [NSString stringWithFormat:@"%f", self.location.coordinate.longitude];

self.lblAltitude.text = [NSString stringWithFormat:@"%f", self.location.altitude];

接下來，請使用 Places Client 呼叫 Places API。只要指定回呼函式，即可取得可能性清單。Places API 會根據您的位置，判斷您位於特定地點的可能性。它會傳回可能位置的名稱，以及介於 0 和 1 之間的值，其中包含您在該位置的機率。

[self.placesClient currentPlaceWithCallback:^(GMSPlaceLikelihoodList *likelihoodList, NSError *error) {

然後就可以執行回呼。系統就會反覆瀏覽可能性清單，為這些地點新增地點和可能性。

[self.placesClient currentPlaceWithCallback:^(GMSPlaceLikelihoodList *likelihoodList, NSError *error) {

  if (error != nil) {
    NSLog(@"Current Place error %@", [error localizedDescription]);
    return;
  }
  NSMutableString *strPlaces = [NSMutableString stringWithString:@""];

  for (GMSPlaceLikelihood *likelihood in likelihoodList.likelihoods) {
    GMSPlace* place = likelihood.place;
    NSLog(@"Current Place name %@ at likelihood %g", place.name,
            likelihood.likelihood);
    NSLog(@"Current Place address %@", place.formattedAddress);
    NSLog(@"Current Place attributions %@", place.attributions);
    NSLog(@"Current PlaceID %@", place.placeID);
    [strPlaces appendString:place.name];
    [strPlaces appendString:@" "];
    [strPlaces appendFormat:@"%g",likelihood.likelihood];
    [strPlaces appendString:@"\n"];
  }
  self.lblPlaces.text = strPlaces;
}];

完成後，已完成的 UpdateLocations 函式應如下所示：

-(void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations{
    
    self.location = locations.lastObject;
    self.lblLatitude.text = [NSString stringWithFormat:@"%f", self.location.coordinate.latitude];
    self.lblLongitude.text = [NSString stringWithFormat:@"%f", self.location.coordinate.longitude];
    self.lblAltitude.text = [NSString stringWithFormat:@"%f", self.location.altitude];
    
    NSLog(@"%@", self.location.description);
    
    [self.placesClient currentPlaceWithCallback:^(GMSPlaceLikelihoodList *likelihoodList, NSError *error) {

        if (error != nil) {
            NSLog(@"Current Place error %@", [error localizedDescription]);
            return;
        }
        NSMutableString *strPlaces = [NSMutableString stringWithString:@""];
        
        for (GMSPlaceLikelihood *likelihood in likelihoodList.likelihoods)  
        {
            GMSPlace* place = likelihood.place;
            NSLog(@"Current Place name %@ at likelihood %g", place.name, likelihood.likelihood);
            NSLog(@"Current Place address %@", place.formattedAddress);
            NSLog(@"Current Place attributions %@", place.attributions);
            NSLog(@"Current PlaceID %@", place.placeID);
            [strPlaces appendString:place.name];
            [strPlaces appendString:@" "];
            [strPlaces appendFormat:@"%g",likelihood.likelihood];
            [strPlaces appendString:@"\n"];
        }
        self.lblPlaces.text = strPlaces;
    }];
}

現在，你可以開始執行並測試應用程式了！

11. 在模擬器中執行應用程式

應用程式標題列上的 [執行] 按鈕可用來執行應用程式。這也可讓您選取執行類型。如此處所見，我使用模擬器在 iPhone 6 上進行測試。

bbbe0b8820c8a913.png

按下執行按鈕後，應用程式即會啟動並啟動。系統隨即顯示允許應用程式存取位置資訊的要求，包括您之前指定的自訂字串。

b9bb2ace7e68f186.png

如此一來，「Google 定位」和「經度」就會進行更新。如要變更位置，請選取 [偵錯] 選單，然後選擇位置。例如，您可以挑選「高速公路公路」

dcb1ce091d780f56.png

如此一來，您就能查看可能更新的地點，模擬高速公路車道。

649e3eeb2321ae03.png

這樣就完成了！您已成功在 iOS 版 Google Places API 中存取目前地點詳細資料。

bug_report 回報錯誤