啟用計費功能並建立 API 金鑰後,您就可以設定要用來開發應用程式的 Xcode 專案。
每個版本都會提供版本資訊。
步驟 1:安裝必要軟體
如要使用 Maps SDK for iOS 建立專案,您必須下載並安裝:
步驟 2:建立 Xcode 專案,並安裝 Maps SDK for iOS
如要在新專案中安裝 API,請按照下列步驟操作:
使用 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 及其依附元件:
- 如果尚未建立 Xcode 專案,請立即建立一個專案並儲存至本機電腦。如果你是 iOS 開發新手:
- 建立新專案。
- 依序選取「iOS」>「應用程式」範本。
- 在專案選項畫面上:
- 輸入專案名稱。
- 記錄「Bundle ID」欄位的值。 您可以使用該值限制下方的 API 金鑰。
- 將專案的「Interface」設為「Storyboard」。
- 將「Language」(語言) 設為「Swift」或「Goal-C」。
- 在專案目錄中建立名為
Podfile
的檔案。這個檔案定義了專案的依附元件。 - 編輯
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
,偵測是否有更新版本,確保您保持在最新版本。如有需要,請升級至最新版本。 - 儲存
Podfile
。 開啟終端機並前往包含
Podfile
的目錄:cd <path-to-project>
執行
pod install
指令。此動作會安裝Podfile
中指定的 API 及其所有依附元件。pod install
關閉 Xcode,接著按兩下來開啟專案的
.xcworkspace
檔案來啟動 Xcode。從現在起,您必須使用.xcworkspace
檔案來開啟專案。
如要更新現有專案的 API,請按照下列步驟操作:
- 開啟終端機,然後前往包含
Podfile
的專案目錄。 - 執行
pod update
指令。這會將Podfile
中指定的所有 API 更新為最新版本。
手動安插
本指南說明如何手動將包含 Maps SDK for iOS 的 XCFrameworks 手動加入專案,並在 Xcode 中調整建構設定。XCFramework 是可在多個平台上使用的二進位套件,包括採用 Apple 晶片的機器。- 下載下列 SDK 二進位檔和資源檔案:
- 解壓縮 ZIP 檔案後,即可存取 XCFrameworks 和資源。
- 如果尚未建立 Xcode 專案,請立即建立一個專案並儲存至本機電腦。如果你是 iOS 開發新手:
- 建立新專案。
- 依序選取「iOS」>「應用程式」範本。
- 在專案選項畫面上:
- 輸入專案名稱。
- 記錄「Bundle ID」欄位的值。 您可以使用該值限制下方的 API 金鑰。
- 將專案的「Interface」設為「Storyboard」。
- 將「Language」(語言) 設為「Swift」或「Goal-C」。
- 將下列 XCFrameworks 將其拖曳至「Frameworks、Library and Embedded Content」之下,請務必為每個 XCFramework 勾選「Do Not Embed」:
GoogleMaps.xcframework
GoogleMapsBase.xcframework
GoogleMapsCore.xcframework
- (僅適用於付費方案客戶)
GoogleMapsM4B.xcframework
- 將您下載的 GoogleMapsResources 中的
GoogleMaps.bundle
拖曳到 Xcode 專案的頂層目錄。畫面中出現提示訊息時,請確認已選取「Copy items if needed」。 - 從 Project Navigator 中選取專案,然後選擇應用程式的目標。
- 開啟應用程式目標的「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
選擇專案 (而不是特定目標),然後開啟「Build Settings」分頁。在「Other Linker Flags」(其他連結器旗標) 區段中,新增
-ObjC
。如果找不到這些設定,請將「Build Settings」列中的篩選器從「Basic」變更為「All」。如要安裝 Places SDK for iOS XCFramework,請參閱「開始使用 Places SDK for iOS」一文。
步驟 3:將 API 金鑰加進專案
先前依「取得 API 金鑰」一節的說明,為應用程式產生了 API 金鑰,現在請將這個金鑰加進 Xcode 專案。
請將以下範例中的 YOUR_API_KEY
替換成您的 API 金鑰。
一節。
Swift
將 API 金鑰新增到您的 AppDelegate.swift
中,如下所示:
- 新增下列匯入陳述式:
import GoogleMaps
- 使用您的 API 金鑰,將以下內容加入
application(_:didFinishLaunchingWithOptions:)
方法:GMSServices.provideAPIKey("YOUR_API_KEY")
- 如果您也有使用 Places API,請再次新增金鑰,如下所示:
GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
將 API 金鑰新增到您的 AppDelegate.m
中,如下所示:
- 新增下列匯入陳述式:
@import GoogleMaps;
- 使用您的 API 金鑰,將以下內容加入
application:didFinishLaunchingWithOptions:
方法:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
- 如果您也有使用 Places API,請再次新增金鑰,如下所示:
[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
步驟 4:新增地圖
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
步驟 5 (選用):宣告 API 使用的網址架構
從 iOS 9 和 Xcode 7 開始,應用程式可以在應用程式的 Info.plist
檔案中指定配置,以宣告想要開啟的網址配置。Maps SDK for iOS 會在使用者點按地圖上的 Google 標誌時,開啟 Google 地圖行動應用程式,因此您的應用程式可宣告相關的網址配置。
如要宣告 Maps SDK for iOS 使用的網址配置,請在 Info.plist
中加入下列程式碼:
以下螢幕截圖顯示 Xcode 使用者介面中的設定:
如果沒有上述宣告,使用者輕觸地圖上的 Google 標誌時,可能會發生下列錯誤:
-canOpenURL: failed for URL: "comgooglemaps://" - error: 「This app can not allowed to query for scheme comgooglemaps" -canOpenURL: failed for URL:」(googlechromes:// (googlechromes://) - 錯誤:這個應用程式無法查詢 scheme googlechromes"
如要排除這些錯誤,請將宣告新增至 Info.plist
。
後續步驟
取得 API 金鑰和 Xcode 專案後,接下來請建立並執行應用程式。Maps SDK for iOS 提供許多教學課程和範例應用程式,協助您踏出第一步。相關詳情請參閱: