開始使用 Google 地圖平台

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

快速入門導覽課程

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

開始使用

或者,您也可以完成下列必要設定步驟:

步驟 1:設定專案

控制台

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

    前往專案選取器頁面

  2. 確認 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,請按照下列步驟進行:

控制台

  1. 請前往 Cloud 控制台的「Maps API 程式庫」頁面,查看您可以啟用的 Google Maps Platform API 和 SDK:

    前往 Maps API 程式庫頁面

  2. 按一下您要啟用的 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 新增至現有金鑰,請按照下列操作說明進行。

控制台

  1. 前往「Google Maps Platform」>「金鑰和憑證」頁面。

    前往「Keys & Credentials」(金鑰和憑證) 頁面

  2. 如果出現系統提示,請選取您的專案。
  3. 請執行下列任一步驟:

    • 建立新金鑰:

      1. 依序按一下 [Create credentials] (建立憑證) > [API key] (API 金鑰)。
      2. 在「建立 API 金鑰」面板中,開啟「選取 API 限制」清單。
      3. 清除這組金鑰不需要的所有 API,並確認您要使用的 API 仍處於選取狀態。
      4. 按一下「建立」,面板會顯示新的 API 金鑰。
    • 使用現有金鑰:

      1. 按一下金鑰名稱。
      2. 在「選取 API 限制」清單中,選取要使用的 API。
      3. 按一下 [儲存]。

    在這裡選取 API 並不會啟用該 API。請確認您選取的每個 API 都已在 API 程式庫中啟用。

  4. 如要日後查看金鑰字串,請前往「金鑰和憑證」頁面,然後按一下金鑰的「顯示金鑰」。

如果控制台與這些步驟不同,請參閱 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 (按平台分類)。