获取 Maps 演示密钥并将其与 Maps JavaScript API 搭配使用

Maps Demo Key 是一项免费功能，让您无需输入结算信息即可使用 Maps JavaScript API 开始原型设计。在升级到付费账号之前，您可以先验证自己的 想法，看看它们是否可行。 本页面介绍了 Maps Demo Key 的工作原理、配额、可使用的功能，以及 如何获取和使用密钥。

注意：Maps Demo Key 在技术上属于 API 密钥，但仅支持部分功能。它仅用于测试和原型设计， 不适合在生产环境中使用。此外，它还受 《地图演示版项目服务条款》的约束。

Maps Demo Key 支持哪些功能？

Maps Demo Key 仅支持 Maps JavaScript API 和 Weather API 中的部分功能。 如需使用以下未列出的任何 API 或功能，您 需要为 Maps Demo Key 添加结算账号，或者 创建新的 API 密钥并启用结算功能。如需了解详情，请参阅 设置 Maps JavaScript API 。

Maps JavaScript API 支持的功能

✔ 支持的功能

  • 地图渲染 加载包含卫星视图和地形视图的 2D/3D 地图。
  • 标记和事件 添加标记、信息窗口和处理用户点击事件。
  • 地图样式设置 将自定义主题和 JSON 样式应用于地图。
  • Places UI Kit 用于地点搜索和详情的预构建组件。
  • 绘图工具 绘制形状和折线以直观呈现数据。

✘ 不支持的功能

  • 新版 Places API 编程搜索方法，例如 searchByText。
  • 路线和导航 Directions 服务和 Distance Matrix API。
  • 地址验证 高精度地址更正服务。

除了上述功能之外，您还可以将 Maps Demo Key 与 Weather API 搭配使用。如需了解详情，请参阅 获取 Maps Demo Key 并将其与 Weather API 搭配使用。

Maps Demo Key 配额

Maps Demo Key 受用量限额限制，这些限制可能会发生变化。如果您达到每日限额，系统会暂停您的使用，直到第二天，且不会收取任何费用。

如何使用 Maps Demo Key

第 1 步：获取 您的 Maps Demo Key

如需生成密钥，请确保您已登录 Google 账号，然后点击 获取演示密钥 按钮。 接受 Maps Demo Key 条款后，系统会显示您的密钥，您可以立即使用 。

您还会收到一封电子邮件，其中包含有关如何从 Google Cloud 控制台检索密钥的说明。

第 2 步：将 Maps Demo Key 与 Maps JavaScript API 搭配使用

Maps Demo Key 在技术上属于 API 密钥，但仅支持部分功能。在任何受支持的 Maps JavaScript API 功能或 Weather API 中，您都可以使用 Maps Demo Key 代替标准 API 密钥。以下示例展示了如何将 Maps Demo Key 与基本地图搭配使用。 将 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>

后续步骤