您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Places API for iOS

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Places API for iOS
  3. 建立適當的金鑰
繼續

程式碼範例總覽

隨著 Google Places API for iOS 提供的 SDK 示範應用程式示範數個功能,包括地點挑選器、地點自動完成,以及地點相片。此外,您可以在此《開發人員指南》的每個頁面上找到程式碼片段。

使用 CocoaPods 嘗試 SDK 示範

Google Places API for iOS 是以 CocoaPods pod 的形式提供。CocoaPods 是適用於 Swift 與 Objective-C Cocoa 專案的開放原始碼相依性管理員。

Google Places API for iOS 提供一組 SDK 示範應用程式,供您使用 pod try 指令安裝並執行。

依照這些步驟安裝 CocoaPods 並嘗試 Google Places API for iOS。

  1. 如果您還沒有 CocoaPods 工具,請從終端機執行下列指令,以便在 macOS 上加以安裝。如需詳細資料,請參閱 CocoaPods 入門指南
    sudo gem install cocoapods
  2. 開啟終端機視窗並執行下列指令其中之一:
    • pod try GooglePlaces
    • pod try GooglePlacePicker

    CocoaPods 會更新您的規格存放庫,然後在暫存 Xcode 專案中開啟 SDK 示範;暫存專案可能為 GooglePlacesDemos.xcworkspaceGooglePlacePickerDemos.xcworkspace,端視您所選擇的示範而定。

  3. 針對您的 Google API Console 專案,同時啟用 Google Places API for iOS 和 Google Maps SDK for iOS
  4. 如果您還沒有 API 金鑰,請依照指示在 Google API Console 上設定專案並取得 API 金鑰。在 Google API Console 上設定金鑰時,您可以指定應用程式的套件組合識別碼,以確定只有您的應用程式可以使用該金鑰。SDK 範例應用程式的預設套件組合識別碼是 com.example.GooglePlacesDemoscom.example.GooglePlacePickerDemos,視您所選擇的示範而定。
  5. 編輯 SDKDemoAPIKey 檔案,並將您的 API 金鑰貼到適當的常數中。在地點挑選器示範的案例中,這指的是 kPlacesAPIKeykMapsAPIKey 常數。例如:
    internal let kPlacesAPIKey = "YOUR_API_KEY"
    internal let kMapsAPIKey = "YOUR_API_KEY"
  6. 如果 Xcode 提示您將 SDKDemoAPIKey 檔案解鎖以進行編輯,請選擇 [Unlock]
  7. 如果有的話,移除下面的行,因為它是用來註冊問題的:
    #error Register your API key and insert here, then delete this line.
  8. 重新建置並執行專案。
  9. 如果第一次執行時,因為您的 API 金鑰相關錯誤而導致建置失敗或應用程式當機,請再次檢查確認您已在 SDKDemoAPIKey 檔案中提供必要的金鑰。
  10. 如果您執行的是 GooglePlaces 示範,則 iOS 模擬器視窗會顯示地點示範清單。
  11. 如果系統提示您允許 GooglePlacesDemos 或 GooglePlacePickerDemos 存取您的位置,請選擇 [Allow]
  12. 現在,您所選擇的範例已準備好可以執行。

使用來自《開發人員指南》的程式碼片段

《開發人員指南》中的每一頁都包括展示 API 特定功能的程式碼片段。例如,請參閱地點挑選器自動完成取得目前地點相片的指南,以及本指南的其他頁面。

傳送您對下列選項的寶貴意見...

這個網頁
location_on
Google Places API for iOS