借助 Google Maps Platform 提供的免费功能“地图演示密钥”,您无需输入结算信息即可开始进行原型设计。在升级到付费账号之前,先验证并查看您的想法是否可行。 本页介绍了 Maps 演示版密钥的运作方式、配额、可使用的功能,以及如何获取和使用密钥。
注意:从技术上讲,地图演示密钥是一种 API 密钥,但仅支持有限的一组功能。它仅用于测试和原型设计,不适合生产环境。还需遵守《地图演示项目服务条款》。
我可以使用 Maps Demo Key 实现哪些功能?
地图演示密钥仅支持 Maps JavaScript API 和 Weather API 的部分功能。 如需使用以下未列出的任何 API 或功能,您需要 向 Maps 演示密钥添加结算账号或创建新的 API 密钥并启用结算功能。 如需了解详情,请参阅 Google Maps Platform 使用入门。
支持的 Maps JavaScript API 功能
✔ 支持的功能
- 地图渲染 加载具有卫星视图和地形视图的 2D/3D 地图。
- 标记和事件 添加标记、信息窗口并处理用户点击。
- 地图样式设置 为地图应用自定义主题和 JSON 样式。
- Places UI Kit 用于地点搜索和详情的预建组件。
- 绘图工具 绘制形状和多段线以直观呈现数据。
✘ 不支持的功能
- Places API(新) searchByText 等程序化搜索方法。
- 路线和导航 Directions 服务和 Distance Matrix API。
- 地址验证 高精度地址更正服务。
除了上述功能之外,您还可以将 Maps 演示密钥与 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 与 Google Maps Platform 搭配使用
从技术上讲,地图演示密钥是一种支持有限功能集的 API 密钥。您可以在任何受支持的 Maps JavaScript API 功能或 Weather 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>
后续步骤
- 探索:查看文档,并尝试 Maps 演示版密钥支持的更多功能: 向网页添加 Google 地图、 3D 地图、 标记、 活动、 适用于 JavaScript 的 Places UI Kit、 在地图上绘制内容以及 Weather API。
- 检索:您可以通过 Google Cloud 控制台检索现有密钥。
- 升级:当您准备好将代码移至生产环境时,可以为 Maps 演示密钥添加结算账号,也可以创建新的 API 密钥并启用结算功能。如需了解详情,请参阅 Google Maps Platform 使用入门 。