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

Web示例

• 栅格瓦片层（OSM）
• 矢量瓦片层（Maplibre）
  • 使用顶部按钮更改地图样式
  • 单击任何对象以获取有关它的信息
• 要素层
  • 注意！包含大型数据集（约16MB），可能需要一些时间来加载
  • 绘制250个国家边界，由约4000个多边形组成，约500K个顶点，加上40K个城市点
  • 将鼠标指针移至任何国家以突出显示，单击国家将名称写入控制台
• Lambert等面积投影地图
  • 使用墨卡托投影的数据集（国家边界）并将其绘制到LAEA投影的地图上
• 非常多的点
  • 享受3.6百万点用GPU加热你的房间。

概述

通用性

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

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

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

它也不对瓦片层模式、CRS和基准做出任何假设。要素层支持透明地重新投影到地图CRS（计划支持投影瓦片层，但尚未实现）。

跨平台

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

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

尽管如此，后端不是Galileo设计的一部分，所以我们可能会尝试其他有前途的后端（如 vello）。

FFI

在此阶段，您只能使用Rust语言开发Galileo应用程序。但有一个POC示例展示了我们如何在其他平台上进行未来开发的设想：[wasm_examples/raster_tiles](https://github.com/maximkaaa/galileo/blob/e8d4e0780bd7280b5ebc7d7ca7322bf9520d0d5f/galileo-mvt/wasm_examples/raster_tiles)。当Galileo的主要功能基本稳定（或者当有需求时），我们将使用wasm-bindgen和uniffi添加其他语言的FFI绑定。这将允许您使用通用API在JS、Kotlin、Swift或Python中创建应用程序。

功能

Galileo是一个活跃的WIP，以下是已经存在的功能列表

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

路线图

我们对地图引擎有很多期望，但不可能同时完成所有这些功能。以下是我们的当前计划和优先级

v0.1 - 用户体验优化

• 库的架构和基本构建块
• 基本的样式，以便可以使用Galileo进行简单但有用的应用
• 支持主要源类型（TMS瓦片、2D几何形状、MVT）
• 基本的投影支持

v0.2 - 美化

• 高级功能和矢量瓦片的样式（图像点、渐变等）
• 支持更多的源和样式格式
• 文本标签渲染
• 高级特征图层（聚合、热图等）

v0.3 - 3D化

• 3D地球仪、大气层和星空，让你的夜晚更加明亮
• 地形渲染，绘制你攀登过的每一座山
• 3D模型，将你的房子放在那些山上
• 高级投影和CRS支持

运行示例

Rust示例位于[galileo/examples](https://github.com/maximkaaa/galileo/blob/e8d4e0780bd7280b5ebc7d7ca7322bf9520d0d5f/galileo-mvt/galileo/examples)。请参阅[README.md](https://github.com/maximkaaa/galileo/blob/e8d4e0780bd7280b5ebc7d7ca7322bf9520d0d5f/galileo-mvt/galileo/examples/README.md)以获取列表、描述和运行说明。

Web

在[wasm_examples](https://github.com/maximkaaa/galileo/blob/e8d4e0780bd7280b5ebc7d7ca7322bf9520d0d5f/galileo-mvt/wasm_examples)文件夹中还有在Web浏览器中运行Galileo的示例。这些示例被排除在工作区之外（因为Cargo不喜欢跨平台工作区）。要运行这些示例，您需要[安装wasm-pack](https://wasm.rust-lang.net.cn/wasm-pack/installer/)。

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

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

Android

查看[此示例](https://github.com/maximkaaa/galileo/blob/e8d4e0780bd7280b5ebc7d7ca7322bf9520d0d5f/galileo-mvt/android_examples/raster_tiles/README.md)以在Android上运行Galileo。

从Linux交叉编译到Windows

安装目标

rustup target add x86_64-px-window-gnu

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

sudo apt-get install mingw-w64

然后构建它

cargo build --target x86_64-px-windows-gnu

赞助

要使Galileo功能齐全、生产就绪并对许多人有用，还需要做大量工作。我们愿意全职致力于此，尽快将其带给您。因此，我们正在寻找赞助商来实现这一目标。

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

如果您认为这个库对您或您所爱的人有用，请考虑支持其开发。赞助具有额外的优势

• 提高开发速度。
• 将您的需求作为我们的优先事项。
• 在项目的页面上看到您的标志。

许可

您可以在不担忧的情况下使用此库，因为它受以下任一许可的许可：[此处省略具体许可信息]

• Apache许可证，版本2.0（LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT 或 http://opensource.org/licenses/MIT）

由您选择。

贡献

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

注意，由于该库仍处于早期开发阶段，任何部分都可能随时更改。因此，在开始使用它或在其内部进行任何重大工作之前，请发起讨论以同步您的想法与其他人的想法。