为 World Flight 添加 Google 地图 API 密钥

FPVSIM模拟器地图9:42
在 YouTube 上观看

创建并添加 Google 地图 API 密钥以解锁 FPVSIM World Flight 中的真实世界位置。

本教程涵盖的内容

本教程将个人 Google Maps Platform 项目连接到 FPVSIM 的世界飞行场景。您创建一个专用的云项目,启用 Maps Tiles API,创建受限凭证,将该凭证保存在 FPVSIM 中,然后加载虚拟 FPV 飞行的真实位置。

切勿复制旧视频、屏幕截图、评论或公共存储库中显示的密钥。创建您自己的受限凭证。演示密钥是临时的,任何公开暴露的密钥都应被撤销和更换。

开始之前

  • 有权访问 Google Cloud Console 的 Google 帐户。
  • 创建项目、配置地图平台以及完成任何当前计费或帐户验证要求的权限。
  • FPVSIM 访问和稳定的互联网连接,用于流式传输地图图块。
  • 审查当前 Google 定价、配额和条款的时间;自 2023 年录制以来,控制台和策略可能已发生变化。

安全地创建凭证

  1. 创建专用云项目

    登录Google Cloud Console,创建一个专门用于FPVSIM地图图块的项目。专用项目使使用、限制和撤销更易于管理。

  2. 完成当前账户设置

    按照 Google 当前的帐户和结算设置提示进行操作。请勿依赖视频中有关免费使用或配额的历史描述;验证控制台中显示的条款。

  3. 启用地图图块 API

    打开API库,搜索Maps Tiles API,选择它,并为新项目启用它。

  4. 创建 API 密钥

    打开凭据并创建新的 API 密钥。即使基于浏览器的集成可能会从客户端传输该值,也要将该值视为秘密。

  5. 限制密钥

    限制 Maps Tiles API 的密钥并应用适合您的 FPVSIM 使用案例的最窄应用程序限制。仅允许所需的来源或应用程序,并且不要将密钥重复用于不相关的项目。

  6. 添加成本控制

    查看配额并配置预算或使用警报(如果可用)。每当 Google 更改 Maps Platform 定价或限制时,请重新检查这些控制措施。

在 FPVSIM 中加载世界位置

  1. 开启世界飞行场景

    启动FPVSIM,选择“快速播放”,然后打开场景列表末尾显示的基于Google Earth或Google Maps的场景。

  2. 输入您自己的密钥

    将新创建的凭据粘贴到 API 密钥字段中并保存。请勿粘贴从本教程或任何其他公共教程复制的密钥。

  3. 等待图块加载

    保存凭证后,场景开始请求地图图块。如果相机在表面以下启动,请重新加载或重新进入场景,如图所示。

  4. 选择地点并飞行

    导航到您想要探索的位置并开始飞行。平铺细节可能会逐渐显示,尤其是在较慢的连接情况下。

安全和故障排除提示

  • 如果某个密钥曾被暴露,请在 Google Cloud Console 中撤销它并创建一个替换项,而不是稍后尝试隐藏旧值。
  • 空白或部分加载的世界可能意味着 API 被禁用、限制与请求不匹配、配额已用尽、计费不活动或网络速度缓慢。
  • 会议结束后检查项目使用情况,以便尽早发现意外请求。
  • 保留屏幕截图和支持消息,使其不包含完整的凭据值。

编辑的成绩单

此文字记录删除了所有凭证值并更新了安全措辞,同时保留了教程演示的流程。自记录以来,Google Cloud 标签、结算要求和配额可能已发生变化。

00:04–00:33

该视频展示了如何获取 Google 地图 API 密钥并使用它在 FPVSIM 内的真实位置飞行。在录制时,地图图块功能尚处于实验阶段,需要用户携带自己的凭据。

00:34–01:14

登录 Google Cloud Console,完成初始帐户设置,并创建第一个项目。项目创建可能需要一些时间。按照 Google 要求的帐户提示继续操作。

01:14–02:28

设置后,控制台提供对凭据的访问。创建并复制您自己的 API 密钥,然后使用适当的限制来保护它。该视频短暂地显示了一个演示键,但该键旨在被禁用且不得重复使用。

02:47–03:11

在 API 库中搜索 Maps Tiles API 并为项目启用它。如果您之前没有复制密钥,则可以从“凭据”页面进行管理。

03:11–04:18

录音审查了当时可用的配额,并将该功能描述为实验性的。定价和限制是外部政策,因此请检查当前的 Google Cloud Console,而不是依赖视频中的历史数字。

04:18–05:13

打开FPVSIM,选择“快速播放”,然后选择“Google Earth”场景。将您自己的密钥粘贴到 API 密钥字段中并保存。地图图块开始加载。如果初始视图位于地面以下,请再次进入场景。

05:13–08:55

演示飞越威基基,飞往夏威夷钻石头山。图块加载速度取决于互联网连接,但场景允许对所选区域进行远程虚拟探索。

08:56–09:26

使用您自己项目中的凭据,监视其使用情况,并且不要使用视频中公开的任何密钥。本教程最后邀请有关设置的问题。

常见问题

我可以使用原始视频中可见的 API 密钥吗?

不。这是临时演示凭证,计划停用。在您自己的 Google Cloud 项目中创建和限制密钥。

Maps Tiles API 是否保证免费?

不应从 2023 年的记录中推断出任何保证。启用之前,请在您自己的控制台中查看当前的 Google Maps Platform 定价、配额、结算要求和条款。

我该如何限制凭证?

将其限制为 Maps Tiles API 并使用最窄的兼容应用程序限制,例如仅 FPVSIM 工作流程所需的源或应用程序。让项目专门用于此用途。

为什么世界图块是空白的或缓慢的?

确认 Maps Tiles API 已启用,关键限制与请求匹配,计费和配额处于活动状态,并且您的连接可以传输图块。较慢的连接可能会逐渐填充细节。

如果我不小心公布了我的密钥怎么办?

立即在 Google Cloud Console 中撤销暴露的密钥、创建替换项、应用限制并检查意外请求的使用情况。

简体中文