Maps Embed API 快速入门

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

通过简单的 HTTP 请求（无需 JavaScript）在您的网页上放置互动式地图或街景全景图片。

费用

所有 Maps Embed API 请求均免费提供，用量不受限制。但是，所有请求仍然需要有效的 Google Cloud API 密钥。如需了解详情，请参阅用量和结算。

准备工作

如需在网页上创建嵌入式地图，请点击以下标签页，完成所需的设置步骤：

第 1 步

控制台

  1. 在 Google Cloud 控制台中，打开项目选择器页面，点击创建项目以开始创建新的 Cloud 项目。

    前往项目选择器页面

  2. 确保您的 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。

控制台

启用 Maps Embed API

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 密钥，请执行以下操作：

控制台

  1. 前往 Google Maps Platform > 凭据页面。

    前往“凭据”页面

  2. 在凭据页面上，依次点击创建凭据 > API 密钥。
    已创建的 API 密钥对话框会显示您新创建的 API 密钥。
  3. 点击关闭。
    新的 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，请执行以下操作：

  1. 打开默认文本编辑器。您应该在设备上默认安装 TextEdit 或 Microsoft Windows 记事本等文本编辑器。
  2. 创建一个 HTML 文件并将其命名为 index.html。

  3. 使用上面生成的 iframe 添加以下代码：

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. 保存您的 index.html HTML 文件。

  5. 将该 HTML 文件从桌面拖放到网络浏览器上进行加载；或者，双击该文件即可在大多数操作系统中正常运行。

恭喜！您刚刚使用 Maps Embed API 设置和构建了地图。

清理

您可以删除 Google Cloud 项目，以停止对该项目中使用的所有资源计费。

  1. 在 Google Cloud Console 中，转到管理资源页面：

    转到“管理资源”页面

  2. 如果您计划删除的项目已附加到组织，请选择并展开页面顶部的组织列表。
  3. 在项目列表中，选择要删除的项目，然后点击删除。
  4. 在对话框中输入项目 ID，然后点击关停以删除项目。

后续步骤