Maps Embed API 快速入門導覽課程

使用簡單的 HTTP 要求在網頁中加入互動式地圖或街景服務全景，完全不需使用 JavaScript。

費用

所有 Maps Embed API 要求都不收費，且不限用量。不過，所有要求仍需要有效的 Google Cloud API 金鑰。詳情請參閱用量與計費一文。

事前準備

如要在網頁中建立內嵌地圖，請點擊下列分頁標籤，完成必要的設定步驟：

步驟 1

控制台

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

    前往專案選取器頁面

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

步驟 2

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

控制台

啟用 Maps Embed API

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

步驟 3

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

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

建立 API 金鑰的方法如下：

控制台

  1. 前往「Google 地圖平台」>「憑證」頁面。

    前往「憑證」頁面

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

Cloud SDK

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

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

產生 iframe

請點選下列選項，加入位置和 API 金鑰來產生網頁的 iframe。如需其他參數和選項，請參閱嵌入地圖。

測試 iframe

如何在 HTML 瀏覽器視窗中查看 iframe：

  1. 開啟預設文字編輯器。根據預設，您應該已經在裝置上安裝文字編輯器，例如 TextEdit 或 Microsoft Windows 記事本。
  2. 建立 HTML 檔案，並命名為 index.html。

  3. 使用您於上方產生的 iframe 加入下列程式碼：

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. 儲存 index.html HTML 檔案。

  5. 在網路瀏覽器中載入 HTML 檔案，只要將檔案從桌面拖曳至您的瀏覽器即可；同樣地，按兩下檔案也能在大多數的作業系統上執行。

恭喜！您只需使用 Maps Embed API 設定並建構地圖即可。

清除所用資源

您可以刪除 Google Cloud 專案，停止使用該專案內所有資源的計費功能。

  1. 前往 Google Cloud Console 中的「管理資源」頁面：

    前往「Manage resources」(管理資源) 頁面

  2. 如果您打算刪除的專案已連結到機構，請選取並展開頁面頂端的機構清單。
  3. 在專案清單中，選取您要刪除的專案，然後按一下 [Delete] (刪除)。
  4. 在對話方塊中輸入專案 ID，然後按一下「Shut down」(關閉) 即可刪除專案。

後續步驟