透過簡單的 HTTP 要求,在網頁上放置互動式地圖或街景服務全景,無須使用 JavaScript。
費用
所有 Maps Embed API 要求都不收費,且無使用次數限制。不過,所有要求都需要有效的 Google Cloud API 金鑰。詳情請參閱「用量與計費」。
事前準備
如要在網頁上建立嵌入式地圖,請點選下列分頁標籤,完成必要的設定步驟:
步驟 1
控制台
-
在 Google Cloud 控制台的專案選取器頁面中,按一下「建立專案」,開始建立新的 Cloud 專案。
-
確認 Cloud 專案已啟用計費功能。 確認專案已啟用計費功能。
Google Cloud 提供免付費試用期。試用期將於 90 天後或帳戶費用累積達 $300 美元時 (以先發生者為準) 結束。您隨時可以取消試用。Google 地圖平台每月提供 $200 美元的抵免額。詳情請參閱「帳單帳戶抵免額」和「帳單」。
Cloud SDK
gcloud projects create "PROJECT"
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令:
步驟 2
如要使用 Google 地圖平台,請啟用打算在專案中使用的 API 或 SDK。
控制台
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 金鑰的方法如下:
控制台
-
前往「Google Maps Platform」(Google 地圖平台) >「Credentials」(憑證) 頁面。
-
在「Credentials」(憑證) 頁面上,點選「Create credentials」(建立憑證) >「API key」(API 金鑰)。
「API key created」(建立的 API 金鑰) 對話方塊會顯示您新建立的 API 金鑰。 -
按一下「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 安裝和下列指令:
產生 iframe
依序點選下列選項,並新增位置和 API 金鑰,即可為網頁產生 iframe。如需其他參數和選項,請參閱嵌入地圖。
測試 iframe
如要在 HTML 瀏覽器視窗中查看 iframe,請按照下列步驟操作:
- 開啟預設文字編輯器。根據預設,您的裝置應已安裝 TextEdit 或 Microsoft Windows 記事本 這類文字編輯器。
- 建立 HTML 檔案並命名為
index.html
。 將下列程式碼加入您在上方產生的 iframe:
<html> <!-- Replace this code comment with your iframe. --> </html>
儲存
index.html
HTML 檔案。從桌面拖曳 HTML 檔案到網路瀏覽器中載入。在大部分的作業系統上,也可以按兩下檔案載入。
恭喜!您剛剛使用 Maps Embed API 設定並建構地圖。
正在清除所用資源
您可以刪除 Google Cloud 專案,這樣系統就會停止對該專案使用的所有資源收取費用。
- 在 Google Cloud 控制台中前往「管理資源」頁面:
- 如果您要刪除的專案已附加至某個機構,請選取並展開頁面頂端的機構清單。
- 在專案清單中選取要刪除的專案,然後按一下「刪除」。
- 在對話方塊中輸入專案 ID,然後按一下「Shut down」(關閉) 即可刪除專案。
後續步驟
設定 Google Cloud 專案,開始使用 Maps Embed API 進行開發:
如要查看可在 iframe 中新增的其他參數和選項清單,請參閱以下說明:
使用 JavaScript API 擴充 Google 地圖專案: