設定 Xcode 專案

使用 CocoaPods

Maps SDK for iOS 以 CocoaPods Pod 的形式提供。CocoaPods 是一種適用於 Swift 和 Objective-C Cocoa 專案的開放原始碼依附元件管理員。

如果您還沒有 CocoaPods 工具，請在終端機上執行下列指令，即可在 macOS 中安裝這項工具。詳情請參閱 CocoaPods 入門指南。

sudo gem install cocoapods

為 Maps SDK for iOS 建立 Podfile，並使用該檔案安裝 API 及其依附元件：

1. 如果尚未建立 Xcode 專案，請立即建立一個專案並儲存至本機電腦。如果你是 iOS 開發新手：
   1. 建立新專案。
   2. 依序選取「iOS」>「應用程式」範本。
   3. 在專案選項畫面上：
      1. 輸入專案名稱。
      2. 記錄「Bundle ID」欄位的值。 您可以使用該值限制下方的 API 金鑰。
      3. 將專案的「Interface」設為「Storyboard」。
      4. 將「Language」(語言) 設為「Swift」或「Goal-C」。
2. 在專案目錄中建立名為 Podfile 的檔案。這個檔案定義了專案的依附元件。
3. 編輯 Podfile 並新增依附元件及其versions。以下範例包含 Maps SDK for iOS 所需的依附元件：

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '14.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '8.3.0'
   end
   

   請務必定期執行 pod outdated，偵測是否有更新版本，確保您保持在最新版本。如有需要，請升級至最新版本。
4. 儲存 Podfile。

5. 開啟終端機並前往包含 Podfile 的目錄：

   cd <path-to-project>

6. 執行 pod install 指令。此動作會安裝 Podfile 中指定的 API 及其所有依附元件。

   pod install

7. 關閉 Xcode，接著按兩下來開啟專案的 .xcworkspace 檔案來啟動 Xcode。從現在起，您必須使用 .xcworkspace 檔案來開啟專案。

如要更新現有專案的 API，請按照下列步驟操作：

1. 開啟終端機，然後前往包含 Podfile 的專案目錄。
2. 執行 pod update 指令。這會將 Podfile 中指定的所有 API 更新為最新版本。

手動安插

1. 下載下列 SDK 二進位檔和資源檔案：
   • GoogleMaps
   • GoogleMapsBase
   • GoogleMapsCore
   • GoogleMapsM4B
   • GoogleMapsResources
2. 解壓縮 ZIP 檔案後，即可存取 XCFrameworks 和資源。
3. 如果尚未建立 Xcode 專案，請立即建立一個專案並儲存至本機電腦。如果你是 iOS 開發新手：
   1. 建立新專案。
   2. 依序選取「iOS」>「應用程式」範本。
   3. 在專案選項畫面上：
      1. 輸入專案名稱。
      2. 記錄「Bundle ID」欄位的值。 您可以使用該值限制下方的 API 金鑰。
      3. 將專案的「Interface」設為「Storyboard」。
      4. 將「Language」(語言) 設為「Swift」或「Goal-C」。
4. 將下列 XCFrameworks 將其拖曳至「Frameworks、Library and Embedded Content」之下，請務必為每個 XCFramework 勾選「Do Not Embed」：
   • GoogleMaps.xcframework
   • GoogleMapsBase.xcframework
   • GoogleMapsCore.xcframework
   • (僅適用於付費方案客戶) GoogleMapsM4B.xcframework
5. 將您下載的 GoogleMapsResources 中的 GoogleMaps.bundle 拖曳到 Xcode 專案的頂層目錄。畫面中出現提示訊息時，請確認已選取「Copy items if needed」。
6. 從 Project Navigator 中選取專案，然後選擇應用程式的目標。
7. 開啟應用程式目標的「Build Phases」分頁，然後在「Link Binary with Libraries」內加入下列架構和程式庫：
   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 選擇專案 (而不是特定目標)，然後開啟「Build Settings」分頁。在「Other Linker Flags」(其他連結器旗標) 區段中，新增 -ObjC。如果找不到這些設定，請將「Build Settings」列中的篩選器從「Basic」變更為「All」。

9. 如要安裝 Places SDK for iOS XCFramework，請參閱「開始使用 Places SDK for iOS」一文。

Swift

將 API 金鑰新增到您的 AppDelegate.swift 中，如下所示：

1. 新增下列匯入陳述式：

   import GoogleMaps

2. 使用您的 API 金鑰，將以下內容加入 application(_:didFinishLaunchingWithOptions:) 方法：

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. 如果您也有使用 Places API，請再次新增金鑰，如下所示：

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

將 API 金鑰新增到您的 AppDelegate.m 中，如下所示：

1. 新增下列匯入陳述式：

   @import GoogleMaps;

2. 使用您的 API 金鑰，將以下內容加入 application:didFinishLaunchingWithOptions: 方法：

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. 如果您也有使用 Places API，請再次新增金鑰，如下所示：

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Swift

/*
 *   Copyright 2020 Google Inc. All rights reserved.
 *
 *
 *   Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 *   file except in compliance with the License. You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software distributed under
 *   the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 *   ANY KIND, either express or implied. See the License for the specific language governing
 *   permissions and limitations under the License.
 */

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.

        let options = GMSMapViewOptions()
        options.camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        options.frame = self.view.bounds

        let mapView = GMSMapView(options: options)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}

Objective-C

/*
*   Copyright 2020 Google Inc. All rights reserved.
*
*
*   Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
*   file except in compliance with the License. You may obtain a copy of the License at
*
*   http://www.apache.org/licenses/LICENSE-2.0
*
*   Unless required by applicable law or agreed to in writing, software distributed under
*   the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
*   ANY KIND, either express or implied. See the License for the specific language governing
*   permissions and limitations under the License.
*/

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController()

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
  options.frame = self.view.bounds;
  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end