项目
在 GitHub 查看
flywave/flywave.gl
flywave/flywave.gl has 34 GitHub stars and 11 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-15 14:59 UTC. Last push 2026-11-07.
可以做什么
- 🌍 Visually Appealing 3D Maps - Create immersive map experiences using WebGL technology
- 🎨 Dynamic Visualizations - Based on the popular three.js library
- 🎨 Thematic Maps - Supports multiple map styles and themes with dynamic switching
- ⚡ High-performance Rendering - Parallelizing CPU-intensive tasks with Web Workers
实测星标增长
- 24小时
- +1
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
flywave.gl is an open-source 3D map rendering engine built with TypeScript. This project adopts a modular monorepo architecture, aiming to provide a high-performance, scalable, and modular 3D map rendering solution.
创作与媒体README.zh.md
原文🌍 Flywave.gl
一个基于 TypeScript 构建的开源 3D 地图渲染引擎
使用 WebGL 和 Three.js 创建高性能、可扩展的 3D 地图可视化解决方案
🌟 项目简介
flywave.gl 是一个基于 TypeScript 构建的开源 3D 地图渲染引擎。该项目采用模块化 monorepo 架构,旨在提供一个高性能、可扩展且模块化的 3D 地图渲染解决方案。
🔧 核心能力
- 🌍 视觉吸引力的 3D 地图 - 利用 WebGL 技术创建沉浸式地图体验
- 🎨 动态可视化效果 - 基于流行的 three.js 库
- 🎨 主题地图 - 支持多种地图样式和主题的动态切换
- ⚡ 高性能渲染 - 使用 Web Workers 并行化 CPU 密集型任务
- 🔧 模块化设计 - 可根据需要交换模块和数据提供者
📸 功能展示
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
🚀 快速开始
📋 环境要求
| 工具 | 版本 | 检查命令 |
|---|---|---|
| Node.js | >= 22.15.0 | node --version |
| pnpm | >= 9.0.0 | pnpm --version |
🛠️ 安装步骤
有两种方式安装 flywave.gl:
直接使用 npm 安装(推荐用于项目)
# 使用 npm
npm install @flywave/flywave.gl
# 使用 pnpm(推荐)
pnpm add @flywave/flywave.gl
从源码安装(用于开发)
# 克隆仓库
git clone https://github.com/flywave/flywave.gl.git
cd flywave.gl
# 安装依赖
pnpm install
# 启动开发服务器
pnpm start
# 访问:http://localhost:8080/
📦 生产环境构建
🎯 核心功能
- 🚀 高性能渲染:利用 WebGL 和现代图形技术实现流畅的 3D 地图渲染
- 🔧 模块化设计:可以根据需要选择和组合不同的功能模块
- 🎨 可扩展主题:支持动态切换和自定义地图主题
- 🗺️ 多数据源支持:支持多种地图数据源格式
- 🖱️ 丰富的交互功能:提供完整的地图交互和控制功能
- 🌍 多种投影方式:支持球面、平面和椭球投影
- 🏔️ 地形支持:内置数字高程模型 (DEM) 支持
💡 使用示例
带数据源的基础地图
import {
MapView,
GeoCoordinates,
MapControls,
sphereProjection,
ArcGISWebTileDataSource
} from "@flywave/flywave.gl";
// 初始化地图视图
const mapView = new MapView({
projection: sphereProjection,
target: new GeoCoordinates(39.9042, 116.4074), // 北京坐标
zoomLevel: 10,
canvas: document.getElementById("mapCanvas")
});
// 创建数据源
const webTileDataSource = new ArcGISWebTileDataSource();
// 添加数据源到地图
mapView.addDataSource(webTileDataSource);
// 添加控制以支持用户交互
const mapControls = new MapControls(mapView);
📚 资源链接
| 资源 | 描述 | 链接 |
|---|---|---|
| 📖 官方文档 | API 文档、教程、最佳实践 | flywave.github.io/flywave.gl/docs |
| 🎯 示例代码 | 功能示例、代码片段 | flywave.github.io/flywave.gl/examples |
| 🏠 官网 | 项目主页、最新动态 | flywave.github.io/flywave.gl |
| 🐛 问题反馈 | Bug 报告、功能建议 | GitHub Issues |
| 💬 社区讨论 | 技术交流、使用帮助 | GitHub Discussions |
🤝 贡献指南
我们欢迎来自社区的贡献!请阅读我们的 贡献指南 (English Version) 开始参与。
- Fork 仓库
- 创建功能分支
- 提交更改
- 推送到分支
- 发起拉取请求
📄 许可证
版权所有 © 2022-2025 Flywave 项目作者
基于 Apache 许可证 2.0 版 授权。











