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 Notepad。
  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」(關閉) 即可刪除專案。

後續步驟