mapbox-gl-rs

mapbox-gl-js 的非官方 Rust 绑定

这是什么？

mapbox-gl-js 是一个开源库，用于在网页浏览器中渲染美丽的基于矢量的地图，由 Mapbox 和 OSS 社区构建。本项目旨在通过 WebAssembly 创建 mapbox-gl-js 的 Rust 绑定，以便 Rustacean 可以仅使用 Rust 构建具有美丽 Mapbox 地图的 web 应用。

注意： mapbox-gl-rs 处于超级初生阶段。大多数功能都是 WIP。如果您感兴趣，请耐心等待！此外，任何贡献，例如错误报告、功能请求、发送补丁都受到欢迎。

它是如何工作的？

wasm-bindgen 提供了一个 Rust 库和工具，用于将 Rust 代码编译成 WebAssembly，这使得基于 Rust 的应用程序，例如 egui 和 RustPython 可以在网页浏览器上运行。大多数人不知道 wasm-bindgen 还允许从 Rust 调用 JavaScript 代码。本项目利用这一特性为 mapbox-gl-js 提供了 Rust 绑定。

使用方法

将 mapboxgl 添加到您的 Cargo.toml

mapboxgl = "0.4"

在 html 中添加以下 CSS 和 JavaScript 片段，以便加载 mapboxgl JavaScript 模块。

<link href='https://api.mapbox.com/mapbox-gl-js/v2.10.0/mapbox-gl.css' rel='stylesheet' />
<script src="https://api.mapbox.com/mapbox-gl-js/v2.10.0/mapbox-gl.js"></script>

构建并运行您的应用程序。如果您是 Yew 用户，以下命令将自动构建并启动一个 web 服务器

trunk serve

支持的功能

• 地图
  • 选项
  • 交互处理程序
  • 控件
  • 地图约束
  • 点转换
  • 处理事件
  • 源
  • 图像
  • 层
  • 样式属性
  • 特征状态
  • 生命周期
  • 调试功能
  • 相机
• 事件
  • 交互
  • 移动
  • 生命周期
  • 数据加载
• 标记和控件
  • 标记
  • AttributionControl
  • FullscreenControl
  • GeolocateControl
  • NavigationControl
  • 弹出窗口
  • 缩放控件
• 地理和几何
  • 经纬度
  • 经纬度范围
  • 类似于经纬度范围
  • 类似于经纬度
  • 墨卡托坐标
  • 点
  • 类似于点
• 用户交互处理器
  • 框缩放处理器
  • 双击缩放处理器
  • 拖动平移处理器
  • 拖动旋转处理器
  • 键盘处理器
  • 滚动缩放处理器
  • 触摸俯仰处理器
  • 触摸缩放旋转处理器
• 源
  • 画布源
  • 画布源选项
  • GeoJSON源
  • 图像源
  • 矢量瓦片源
  • 视频源
• 事件和事件类型
  • MapBox缩放事件
  • 地图数据事件
  • 地图鼠标事件
  • 地图触摸事件
  • 地图滚轮事件

示例

• simple: Hello world
• on-load: 捕获地图加载事件
• popup: 显示弹出控制
• geojson-source: 加载GeoJSON源并显示线条
• set-data: 使用set-data实时更新路径
• add-image: 在地图上显示图像

许可证

本项目采用MIT许可证。