通过简单的 HTTP 请求(无需 JavaScript)在您的网页上放置互动式地图或街景全景图片。
费用
所有 Maps Embed API 请求均免费提供,用量不受限制。但是,所有请求仍然需要有效的 Google Cloud API 密钥。如需了解详情,请参阅用量和结算。
准备工作
如需在网页上创建嵌入式地图,请点击以下标签页,完成所需的设置步骤:
第 1 步
控制台
-
在 Google Cloud 控制台中,打开项目选择器页面,点击创建项目以开始创建新的 Cloud 项目。
-
确保您的 Cloud 项目已启用结算功能。确认您的项目已启用结算功能。
Google Cloud 提供免费试用。试用期将在 90 天后或者当帐号费用累积达到 300 美元时(两者取其先)结束。您随时可以取消订阅。Google Maps Platform 每月定期提供 200 美元的赠金。如需了解详情,请参阅结算帐号赠金和结算。
Cloud SDK
gcloud projects create "PROJECT"
详细了解 Google Cloud SDK、Cloud SDK 安装和以下命令:
第 2 步
如要使用 Google Maps Platform,您必须启用您打算用于该项目的 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 密钥是唯一标识符,用于对与您的项目相关联的请求进行身份验证,以便您使用相关产品和执行结算。您必须至少有一个与您的项目相关联的 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 Console 中,转到管理资源页面:
- 如果您计划删除的项目已附加到组织,请选择并展开页面顶部的组织列表。
- 在项目列表中,选择要删除的项目,然后点击删除。
- 在对话框中输入项目 ID,然后点击关停以删除项目。
后续步骤
设置您的 Google Cloud 项目,开始使用 Maps Embed API 进行开发:
如需查看可在 iframe 中添加的其他参数和选项的列表,请执行以下操作:
使用 JavaScript API 扩展您的地图项目: