只需发出简单的 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 密钥,请执行以下操作:
控制台
-
前往 Google Maps Platform > 凭据页面。
-
在凭据页面上,依次点击创建凭据 > 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 控制台中,前往管理资源页面:
- 如果您打算删除的项目已附加到某个组织,请选择并展开页面顶部的组织列表。
- 在项目列表中,选择要删除的项目,然后点击删除。
- 在对话框中输入项目 ID,然后点击关停以删除项目。
后续步骤
设置 Google Cloud 项目,开始使用 Maps Embed API 进行开发:
如需查看您可以在 iframe 中添加的其他参数和选项的列表,请参阅:
使用 Javascript API 扩展您的 Google 地图项目: