取得 Maps 試用金鑰，並搭配 Maps JavaScript API 使用

Maps Demo Key 無須付費，不必輸入帳單資訊，就能使用 Maps JavaScript API 開始設計原型。先驗證並查看實際成效，再決定是否要使用付費帳戶。本頁說明 Maps 試用版金鑰的運作方式、配額、可使用的功能，以及如何取得和使用金鑰。

注意：Maps 試用版金鑰在技術上是 API 金鑰，但僅支援部分功能。僅供測試和原型設計之用，不適合用於正式環境。此外，您也必須遵守《Maps Demo Project 服務條款》。

哪些功能可搭配地圖示範金鑰使用？

地圖示範金鑰僅支援 Maps JavaScript API 和 Weather API 的部分功能。如要使用下列未列出的 API 或功能，您需要 將帳單帳戶新增至地圖示範金鑰，或建立新的 API 金鑰並啟用帳單。 詳情請參閱「設定 Maps JavaScript API」一文。

支援的 Maps JavaScript API 功能

✔ 支援的功能

  • 地圖算繪 載入 2D/3D 地圖，並顯示衛星和地形檢視畫面。
  • 標記和事件 新增標記、資訊視窗，以及處理使用者點擊事件。
  • 地圖樣式 將自訂主題和 JSON 樣式套用至地圖。
  • Places UI Kit 預先建構的元件，可用於地點搜尋和詳細資料。
  • 繪圖工具 繪製形狀和折線，以視覺化方式呈現資料。

✘ 不支援的功能

  • Places API (新版) 程式輔助搜尋方法，例如 searchByText。
  • 路徑和導航 路線規劃服務和 Distance Matrix API。
  • 地址驗證 高精確度的地址修正服務。

除了上述功能，您也可以搭配使用地圖示範金鑰和 Weather API。詳情請參閱「取得地圖示範金鑰並搭配 Weather API 使用」。

Maps 示範金鑰配額

Maps 示範金鑰有使用限制，且可能會有所變動。如果達到每日上限，系統會暫停使用，直到隔天為止，不會產生任何費用。

如何使用 Maps 示範金鑰

步驟 1：取得 Maps 試用版金鑰

如要產生金鑰，請確認你已登入 Google 帳戶，然後按一下「取得試用金鑰」按鈕。 接受地圖示範金鑰條款後，系統會顯示金鑰，您即可立即使用。

您也會收到電子郵件，內含如何從 Google Cloud 控制台擷取金鑰的操作說明。

步驟 2：搭配 Maps JavaScript API 使用地圖示範金鑰

地圖試用版金鑰在技術上是 API 金鑰，但僅支援部分功能。您可以在支援的任何 Maps JavaScript API 功能或 Weather API 中，使用 Maps 試用金鑰取代標準 API 金鑰。以下範例說明如何搭配基本地圖使用 Maps 示範金鑰。將 YOUR_DEMO_KEY 替換為您剛才擷取的金鑰。

<html>
<head>
  <title>Add a Map using HTML</title>
  <link rel="stylesheet" href="./style.css" />
  <script type="module" src="./index.js"></script>
</head>
<body>
  <gmp-map
    center="38.7946,-106.5348"
    zoom="4"
    map-id="DEMO_MAP_ID"
    style="height: 400px"
  >
  </gmp-map>
  <!--
    The `defer` attribute causes the script to execute after the full HTML
    document has been parsed. -->
  <script
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_DEMO_KEY&libraries=maps"
    defer
  ></script>
</body>
</html>

後續步驟