本頁面將逐步說明基本的必要操作,協助您瞭解如何開始使用 Google 地圖平台的相關 API 和 SDK。
快速入門導覽課程
如果您「從未」使用 Google Cloud 控制台建立帳單帳戶或專案,請按一下「開始使用」按鈕,即可使用 Cloud 控制台提供的互動式新使用者設定體驗:
開始使用或者,您也可以完成下列必要設定步驟:
步驟 1:設定專案
控制台
-
在 Google Cloud 控制台的專案選取器頁面中,按一下「建立專案」,開始建立新的 Cloud 專案。
-
確認 Cloud 專案已啟用計費功能。 確認專案已啟用計費功能。
Google Cloud 提供免付費試用期。試用期將於 90 天後或帳戶費用累積達 $300 美元時 (以先發生者為準) 結束。您隨時可以取消試用。詳情請參閱「帳單帳戶抵免額」和「帳單」。
Cloud SDK
gcloud projects create "PROJECT"
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令:
步驟 2:啟用 API 或 SDK
如要使用 Google 地圖平台,請啟用打算在專案中使用的 API 或 SDK。
請注意,有些整合需要您啟用多個 API/SDK。如果不確定要啟用哪些 API 或 SDK,請嘗試使用功能探索工具,或查詢要使用的 API/SDK 專用說明文件。
如要啟用一或多個 API 或 SDK,請按照下列步驟進行:
控制台
-
請前往 Cloud 控制台的「Maps API 程式庫」頁面,查看您可以啟用的 Google Maps Platform API 和 SDK:
- 按一下您要啟用的 API 或 SDK。
- 如果按鈕顯示「啟用」,請按一下按鈕啟用該 API 或 SDK。
- 如果按鈕顯示「管理」,表示 API 或 SDK 已啟用,您不需要再採取任何動作。
- 按一下上述其中一個按鈕,畫面隨即會顯示該 API 或 SDK 的資訊主頁 (按一下「停用」按鈕,即可將該 API 或 SDK 從這個專案中移除)。
Cloud SDK
下列指令會啟用所有 Maps、Routes 和 Places API:
gcloud services enable \ --project "PROJECT" \ "addressvalidation.googleapis.com" \ "areainsights.googleapis.com" \ "tile.googleapis.com" \ "aerialview.googleapis.com" \ "elevation-backend.googleapis.com" \ "routes.googleapis.com" \ "geocoding-backend.googleapis.com" \ "geolocation.googleapis.com" \ "maps-android-backend.googleapis.com" \ "maps-backend.googleapis.com" \ "maps-embed-backend.googleapis.com" \ "maps-ios-backend.googleapis.com" \ "mapsplatformdatasets.googleapis.com" \ "places-backend.googleapis.com" \ "roads.googleapis.com" \ "routeoptimization.googleapis.com" \ "static-maps-backend.googleapis.com" \ "street-view-image-backend.googleapis.com" \ "timezone-backend.googleapis.com"
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令:
使用下列指令啟用 Environment API:
gcloud services enable \ --project "PROJECT" \ "airquality.googleapis.com" \ "solar.googleapis.com" \ "pollen.googleapis.com" \ "weather.googleapis.com"
步驟 3:取得 API 金鑰
此步驟僅適用 API 金鑰建立程序。若您在正式環境中使用 API 金鑰,強烈建議您為 API 金鑰設定限制。詳情請參閱特定產品的「使用 API 金鑰」頁面。
API 金鑰是一組專屬 ID,用於驗證與您專案有關的使用權限及帳單處理要求。您的專案至少要有一個相關聯的 API 金鑰。 如要建立新金鑰,或將 API/SDK 新增至現有金鑰,請按照下列操作說明進行。
控制台
-
前往「Google Maps Platform」>「金鑰和憑證」頁面。
- 如果出現系統提示,請選取您的專案。
-
請執行下列任一步驟:
-
建立新金鑰:
- 依序按一下 [Create credentials] (建立憑證) > [API key] (API 金鑰)。
- 在「建立 API 金鑰」面板中,開啟「選取 API 限制」清單。
- 清除這組金鑰不需要的所有 API,並確認您要使用的 API 仍處於選取狀態。
- 按一下「建立」,面板會顯示新的 API 金鑰。
-
使用現有金鑰:
- 按一下金鑰名稱。
- 在「選取 API 限制」清單中,選取要使用的 API。
- 按一下 [儲存]。
在這裡選取 API 並不會啟用該 API。請確認您選取的每個 API 都已在 API 程式庫中啟用。
-
- 如要日後查看金鑰字串,請前往「金鑰和憑證」頁面,然後按一下金鑰的「顯示金鑰」。
如果控制台與這些步驟不同,請參閱 Google Cloud 說明文件中的「建立 API 金鑰」和「新增 API 限制」。
Cloud SDK
在下列指令中,將 PROJECT_ID 替換為您的專案 ID。
-
建立新金鑰:執行下列指令,並將 DISPLAY_NAME 替換為金鑰名稱。將 SERVICE_NAME 替換成您要使用的 API 服務名稱,例如
places.googleapis.com。如要允許更多 API,請重複--api-target旗標。gcloud services api-keys create \ --project="PROJECT_ID" \ --display-name="DISPLAY_NAME" \ --api-target=service=SERVICE_NAME
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令:
-
使用現有金鑰:執行下列指令,並將 KEY_ID 替換為金鑰 ID。將 SERVICE_NAME 替換為要新增的 API 服務名稱。
--append旗標會保留金鑰已允許的 API。如果沒有這項參數,指令會替換這些執行個體。gcloud services api-keys update KEY_ID \ --project="PROJECT_ID" \ --append \ --api-target=service=SERVICE_NAME
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令:
金鑰 ID 不是金鑰字串或顯示名稱。如要找出這個值,請執行
gcloud services api-keys list --project="PROJECT_ID"。ID 是name欄位的最後一部分:projects/PROJECT_NUMBER/locations/global/keys/KEY_ID。
如要查看金鑰字串,請執行 gcloud services api-keys get-key-string KEY_ID
--project="PROJECT_ID"。
帳單帳戶抵免額
- 如果您未曾付費使用 Google Cloud、Google Maps Platform 或 Firebase,且未曾申請免費試用 Google Cloud,則符合免費試用和 $300 美元新用戶抵免額的資格,可用於 Google Maps Platform 服務。
- 每個 Google 地圖平台 SKU 每月都提供一定額度的免費使用量,詳情請參閱定價清單和 Google 地圖平台計費方式。
- Google 也為公共計畫提供抵免額,例如非營利機構、新創公司、臺灣災害應變資訊平台、新聞媒體、教育和運輸公司。
後續步驟
設定完成後,您就能開始使用 Google Maps Platform API 和 SDK。 您可以參閱相關的總覽介紹、開發人員指南和入門指南,進一步瞭解您感興趣的 API 和 SDK。如需瀏覽 API 和 SDK 清單,請參考 Google Maps Platform 說明文件 (按產品分類) 和 Google Maps Platform API (按平台分類)。