Galileo 是一个通用的跨平台地理渲染库。

Web 示例

• 栅格瓦片图层 (OSM)
• 矢量瓦片图层 (Maplibre)
  • 使用顶部的按钮更改地图样式
  • 点击任何对象以获取其信息
• 要素图层
  • 注意！包含大型数据集（约16 MB），可能需要一些时间加载
  • 绘制250个国家的边界，包含约4000个多边形和约50万个顶点，以及4万个城市点
  • 移动鼠标指针以高亮显示任何国家，点击国家将其名称写入控制台
• 兰伯特等面积投影的地图
  • 将墨卡托投影的数据集（国家边界）绘制到LAEA投影的地图上
• 海量点
  • 享受360万个点让你的GPU发热。

概述

通用性

Galileo 的架构专门设计为允许不同的使用模式：

• 客户端GUI地图应用程序
• 服务器模块
• 命令行工具

这确实带来了一些挑战并增加了复杂性。例如，在服务器和客户端应用程序中，加载和渲染对象的缓存工作方式完全不同。Galileo 的设计方式允许库的用户做出所有相关决策，而不强制使用某种方式。

它也不对瓦片图层方案、坐标参考系统和基准面做任何假设。要素图层支持透明地重投影到地图坐标参考系统（计划支持投影瓦片图层，但尚未实现）。

跨平台

目前，Galileo 使用 wgpu 后端来渲染地图。这意味着它可以在 wgpu 支持的任何平台上使用：

• 所有主要桌面平台：Linux、MacOS、Windows
• 移动平台：Android、iOS
• 通过编译为 WASM 在 Web 上使用（使用 WebGL 或更新更酷的 WebGPU）

不过，后端并非 Galileo 设计的不可或缺部分，因此我们可能会尝试其他有前景的后端（如 vello）。

FFI

目前，你只能用 Rust 开发使用 Galileo 的应用程序。但我们有一个概念验证示例，展示了我们如何设想未来在其他平台上的开发：[wasm_examples/raster_tiles]。当 Galileo 的所有主要功能都相对稳定（或有需求时），我们将使用 wasm-bindgen 和 uniffi 添加到其他语言的 FFI 绑定。这将允许你使用通用 API 在 JS、Kotlin、Swift 或 Python 中创建应用程序。

特性

Galileo 正在积极开发中，以下是已经具备的功能列表：

• 栅格瓦片图层
• 带样式的矢量瓦片图层
• 带样式的矢量地理数据图层（要素图层）
• 3D 视图和 3D 对象渲染
• 图层上的用户输入处理（目前仅支持鼠标，触摸功能正在开发中）
• 支持不同的投影和瓦片方案
• 高性能

路线图

我们都希望地图引擎具备许多功能，但不可能同时实现所有功能。因此，这里是我们当前的计划和优先事项：

v0.1 - 实用化

• 库的架构和基本构建块
• 基本样式，以便能够将 Galileo 用于简单但实用的应用程序
• 支持主要源类型（TMS 瓦片、2D 几何图形、MVT）
• 基本投影支持

v0.2 - 美化

• 要素和矢量瓦片的高级样式（图像点、渐变等）
• 支持更多源和样式格式
• 文本标签渲染
• 高级要素图层（聚类、热力图等）

v0.3 - 3D 化

• 3D 地球、大气和周围的星星，让你的黑夜更明亮
• 地形渲染，绘制你攀登过的每座山
• 3D 模型，将你的房子放在那些山上
• 高级投影和坐标参考系统支持

运行示例

使用 Galileo 的 Rust 示例位于 galileo/examples。参考 readme 获取列表、描述和运行说明。

Web

在 wasm_examples 文件夹中还有在 Web 浏览器中运行 Galileo 的示例。这些示例从工作空间中排除（因为 Cargo 不喜欢跨平台工作空间）。要运行这些示例，你需要安装 wasm-pack：

wasm-pack build wasm_examples/countries --target no-modules --release

之后在浏览器中打开 index.html（必须从 localhost 提供服务，使用你喜欢的开发服务器）。

Android

查看这个示例以在 Android 上运行 Galileo。

从 Linux 交叉编译到 Windows

安装目标：

rustup target add x86_64-pc-windows-gnu

安装交叉链接器。对于 Debian/Ubuntu：

sudo apt-get install mingw-w64

然后构建：

cargo build --target x86_64-pc-windows-gnu

赞助

还有很多工作要做，以使 Galileo 功能齐全、可用于生产环境并对许多人有用。我们希望全职致力于此，以尽快为你带来这些功能。因此，我们正在寻找赞助商以使之成为可能。

赞助资金将帮助支持维护者的专门工作，并最终资助自由职业贡献者。

如果你认为这个库对你或你所爱的人有用，请考虑支持其开发。赞助还有额外的好处：

• 加快开发速度。
• 使你的需求成为我们的优先事项。
• 在项目页面上展示你的 logo。

许可证

你可以毫无顾虑地使用这个库，因为它根据以下两种许可证之一授权：

• Apache License, Version 2.0 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

由你选择。

贡献

欢迎提出功能请求、拉取请求、错误报告、评论、问题和讨论。在贡献时，请遵守行为准则。

请注意，由于库仍处于早期开发阶段，任何部分都可能随时更改。因此，在开始任何重大工作之前，请开启讨论以同步你的想法与他人的想法。