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

Maps Demo Key 是一项免费功能,让您无需输入结算信息即可使用 Google Maps Platform 开始原型设计。在升级到付费账号之前,先验证您的想法并查看实际效果。 本页介绍了 Maps 演示版密钥的运作方式、配额、可使用的功能,以及如何获取和使用密钥。

注意:从技术上讲,Maps Demo Key 是一种 API 密钥,但仅支持有限的一组功能。它仅用于测试和原型设计,不适合生产环境。还需遵守《Maps 演示项目服务条款》

我可以使用 Maps Demo Key 实现哪些功能?

Maps Demo Key 支持有限的 Google Maps Platform 功能和服务。 如需使用以下未列出的任何 API 或功能,您需要 向 Maps Demo Key 添加结算账号创建新的 API 密钥并启用结算功能。如需了解详情,请参阅设置 Maps JavaScript API

Maps JavaScript API

  • 地图渲染 加载具有卫星视图和地形视图的 2D/3D 地图。
  • 标记事件 添加标记、信息窗口并处理用户点击。
  • 地图样式设置 将自定义主题和 JSON 样式应用于地图。
  • Places UI Kit 用于地点搜索和地点详情的预构建组件。
  • 绘图工具 绘制形状和多段线以直观呈现数据。
  • Place 类 * 获取全球数百万个地点的位置数据。

网络服务 API

* 用户生成的内容(例如用户提交的照片和评价)无法通过 Maps Demo Key 获取。

Maps Demo Key 配额

Maps Demo Key 的使用量限额可能会发生变化。如果您达到每日限额,系统会暂停您的用量,直到第二天,您无需担心产生费用。

如何使用 Maps Demo Key

第 1 步:获取您的 Maps Demo Key

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

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

第 2 步:将 Maps 演示密钥与 Maps JavaScript API 搭配使用

从技术上讲,Maps Demo Key 是一种支持有限功能集的 API 密钥。您可以在任何支持的功能和服务中使用 Maps 演示密钥来代替标准 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>

后续步骤