伽利略是一个通用跨平台的地理渲染库。

Web示例

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

概述

通用性

伽利略的架构设计专门允许不同的使用模式

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

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

它也不会对瓦片图层架构、CRS和基准做任何假设。特征图层支持透明地重新投影到地图CRS（计划支持投影瓦片图层，但尚未实现）。

跨平台

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

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

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

FFI

在此阶段，您只能使用 Rust 语言开发 Galileo 应用程序。但有一个演示如何在其他平台上进行未来开发的 POC 示例：[wasm_examples/raster_tiles](https://github.com/maximkaaa/galileo/blob/e8d4e0780bd7280b5ebc7d7ca7322bf9520d0d5f/galileo/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 模型，将你的房子放在那些山上
• 高级支持投影和坐标参考系统

运行示例

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

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-px-window-gnu

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

sudo apt-get install mingw-w64

然后构建它

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

赞助

为了让 Galileo 功能完善、可用于生产并且对许多人有用，还有很多工作要做。我们愿意全职投入这项工作，以便尽快将这项工作带给您。因此，我们正在寻找赞助商来实现这一目标。

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

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

• 提高开发速度。
• 将您的需求作为我们的首要任务。
• 在项目页面上看到您的标志。

许可

您可以使用这个库，无需担忧，因为它受以下其中之一的许可协议保护：

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

任选其一。

贡献

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

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