Skip to content
项目

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.

这些数字如何统计

34 星标11 复刻 +1 24小时

可以做什么

  • 🌍 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

CI Code Coverage 许可证 NPM 版本 Twitter

一个基于 TypeScript 构建的开源 3D 地图渲染引擎

使用 WebGL 和 Three.js 创建高性能、可扩展的 3D 地图可视化解决方案

:us: English Version • 📚 官方文档 • 🎯 示例代码


🌟 项目简介

flywave.gl 是一个基于 TypeScript 构建的开源 3D 地图渲染引擎。该项目采用模块化 monorepo 架构,旨在提供一个高性能、可扩展且模块化的 3D 地图渲染解决方案。

🔧 核心能力

  • 🌍 视觉吸引力的 3D 地图 - 利用 WebGL 技术创建沉浸式地图体验
  • 🎨 动态可视化效果 - 基于流行的 three.js 库
  • 🎨 主题地图 - 支持多种地图样式和主题的动态切换
  • ⚡ 高性能渲染 - 使用 Web Workers 并行化 CPU 密集型任务
  • 🔧 模块化设计 - 可根据需要交换模块和数据提供者

📸 功能展示

3D 地球 地形 大气
控制 后期处理 动画
平面 3D 瓦片 绘图
新功能 1 新功能 2 新功能 3

🚀 快速开始

📋 环境要求

工具 版本 检查命令
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 版 授权。


由 Flywave 社区用心制作

Stars Forks