開始使用 Google 地圖平台

本頁面將逐步說明基本的必要操作，協助您瞭解如何開始使用 Google 地圖平台的相關 API 和 SDK。

快速入門導覽課程

如果您「從未」使用 Google Cloud 控制台建立帳單帳戶或專案，請按一下「開始使用」按鈕，即可使用 Cloud 控制台提供的互動式新手入門設定體驗：

開始使用

或者，您也可以點選下列分頁標籤，完成必要的設定步驟：

步驟 1

控制台

1. 在 Google Cloud 控制台的專案選擇器頁面中，按一下「建立專案」，開始建立新的 Cloud 專案。

   前往專案選取器頁面

2. 確認 Cloud 專案已啟用計費功能。 確認專案已啟用計費功能。

   注意：雖然您需要設定帳單帳戶才能設定 Cloud 專案，但實際使用 Embed API 時不必付費。

   Google Cloud 提供免付費試用期。試用期將於 90 天後或帳戶費用累積達 $300 美元時 (以先發生者為準) 結束。您隨時可以取消試用。Google 地圖平台每月提供 $200 美元的抵免額。詳情請參閱「帳單帳戶抵免額」和「帳單」。

Cloud SDK

gcloud projects create "PROJECT"

進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令：

• gcloud projects create

步驟 2

如要使用 Google 地圖平台，您必須啟用打算在專案中使用的 API 或 SDK。

請注意，有些整合需要您啟用多個 API/SDK。如果您不確定要啟用哪些 API 或 SDK，請嘗試使用 API 選擇器，或查詢您要使用的 API/SDK 專用說明文件。

如要啟用一或多個 API 或 SDK，請按照下列步驟進行：

控制台

1. 請前往 Cloud 控制台的「Maps API 程式庫」頁面，查看您可以啟用的 Google 地圖平台 API 和 SDK：

   前往 Maps API 程式庫頁面

2. 按一下您要啟用的 API 或 SDK。
   • 如果按鈕顯示「啟用」，請按一下按鈕啟用該 API 或 SDK。
   • 如果按鈕顯示「管理」，表示 API 或 SDK 已啟用，您不需要再採取任何動作。
   • 按一下上述其中一個按鈕，畫面隨即會顯示該 API 或 SDK 的資訊主頁 (按一下「停用」按鈕，即可將該 API 或 SDK 從這個專案中移除)。

Cloud SDK

下列指令可啟用所有地圖、路線和地點 API：

gcloud services enable \
    --project "PROJECT" \
    "directions-backend.googleapis.com" \
    "distance-matrix-backend.googleapis.com" \
    "addressvalidation.googleapis.com" \
    "tileaerialview.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 安裝和下列指令：

• gcloud services enable
• gcloud services disable

使用下列指令啟用 Environment API：

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com"

注意：啟用 Places API 也會同時啟用 Places Library、Maps JavaScript API、Places SDK for Android 和 Places SDK for iOS。

步驟 3

此步驟僅適用 API 金鑰建立程序。若您在正式環境中使用 API 金鑰，強烈建議您為 API 金鑰設定限制。詳情請參閱特定產品的「使用 API 金鑰」頁面。

API 金鑰是一組專屬 ID，用於驗證與您專案有關的使用權限及帳單處理要求。您的專案至少要有一個相關聯的 API 金鑰。

建立 API 金鑰的方法如下：

控制台

1. 前往「Google Maps Platform」(Google 地圖平台) >「Credentials」(憑證) 頁面。

   前往「Credentials」(憑證) 頁面

2. 在「Credentials」(憑證) 頁面上，點選「Create credentials」(建立憑證) >「API key」(API 金鑰)。
   「API key created」(建立的 API 金鑰) 對話方塊會顯示您新建立的 API 金鑰。
3. 按一下「Close」(關閉)。
   新建立的 API 金鑰會出現在「Credentials」(憑證) 頁面的「API keys」(API 金鑰) 下方。
   (別忘了先為 API 金鑰設定限制，然後才在正式環境中使用)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令：

• gcloud alpha services api-keys create

帳單帳戶抵免額

建立帳單帳戶和專案後，您就能獲得 Google Cloud Platform 的 $300 美元免付費試用抵免額，以及 Google 地圖平台每月 $200 美元的抵免額。詳情請參閱「帳單帳戶抵免額」。

注意：Google 地圖平台 $200 美元抵免額優惠有效期限至 2025 年 2 月 28 日晚上 11 點 59 分 (當地時間)。自 2025 年 3 月 1 日起，每個 API 的免費使用額度將取代 $200 美元的抵免額。詳情請參閱常見問題。

後續步驟

設定完成後，您就能開始使用 Google 地圖平台 API 和 SDK。 您可以參閱相關的總覽介紹、開發人員指南和入門指南，進一步瞭解您感興趣的 API 和 SDK。如需瀏覽 API 和 SDK 清單，請參考 Google 地圖平台說明文件 (按產品分類) 和 Google 地圖平台 API (按平台分類)。