brutile

项目地址： https://github.com/BruTile/BruTile

NuGet： BruTile 6.0.0 / BruTile.MbTiles 6.0.0（net8.0 / net9.0，截至 2026-10）

官方文档： https://github.com/BruTile/BruTile

许可证： Apache-2.0

概述

BruTile 是一个只管「瓦片」的 .NET 库：给定视口范围与分辨率，算出需要哪些瓦片，再去对应服务把瓦片字节取回来。它不做渲染、不含 UI，瓦片最终由 Mapsui、SharpMap、ArcBruTile 等地图组件显示。这种职责划分让 BruTile 可以同时支撑 WPF、MAUI、Blazor、ASP.NET 等多种宿主，也是它在 .NET 地图栈中长期作为底座的原因。

• 瓦片方案（schema）：Web 墨卡托全球网格、WMTS、TMS、WMS-C 等组织的分辨率与瓦片索引映射
• 瓦片源：HTTP 瓦片服务（XYZ/OSM、ArcGIS、Bing 等）、MBTiles 离线文件、文件系统瓦片缓存
• 视口计算：ITileSchema.GetTileInfos(extent, resolution) 求当前需要渲染的瓦片集合
• 缓存：内存缓存与持久化缓存（MBTiles、文件系统）可组合
• 坐标系约定：默认 Web 墨卡托（EPSG:3857），OSM 与 TMS 的 y 轴方向不同，需显式选择

版本提示：BruTile 6.0.0 只发布 net8.0 / net9.0 目标。需要 netstandard2.0 的场景（例如 .NET Framework、SharpMap 1.2）只能用 5.0.6 或更早版本，详见下方版本对照表。

---

环境准备

安装

# 在线瓦片（HTTP 服务）
dotnet add package BruTile --version 6.0.0

# 离线 MBTiles 需要额外的包
dotnet add package BruTile.MbTiles --version 6.0.0

# 需要挂在 Mapsui 上时
dotnet add package Mapsui --version 5.1.0

Install-Package BruTile -Version 6.0.0

验证

using BruTile;
using BruTile.Predefined;

var schema = new GlobalSphericalMercator();
Console.WriteLine(schema.Resolutions.Count);   // 默认 0..19 级共 20 个分辨率
var tileInfos = schema.GetTileInfos(
    new Extent(-20037508, -20037508, 20037508, 20037508), 156543.03392804097);
Console.WriteLine(tileInfos.Count());          // 0 级应只有 1 张

dotnet run

版本与目标框架对照

BruTile 版本	目标框架	说明
6.0.0	net8.0 / net9.0	当前版本；HttpTileSource.GetTileAsync 需要传入 HttpClient
5.0.6	net6.0 / netstandard2.0	兼容 .NET Framework 4.6.1+ 与 .NET 6/7
4.0.0 / 3.1.3	netstandard2.0 / netstandard1.1	老项目常用；BruTile.Desktop 在 4.0 起被删除，内容并入 BruTile

BruTile.Desktop、BruTile.Desktop.DbCache 这两个包名在 4.0 之后已不存在，旧代码里的 using BruTile.Desktop 需要改命名空间。

---

核心 API

TileSchema 与分辨率

using BruTile;
using BruTile.Predefined;

// 全球 Web 墨卡托，默认 0-19 级；y 轴默认 OSM 约定
var schema = new GlobalSphericalMercator(minZoomLevel: 0, maxZoomLevel: 18);

// 自定义瓦片方案
var custom = new TileSchema
{
    Name = "MyTiles",
    Srs = "EPSG:3857",
    Extent = new Extent(-20037508, -20037508, 20037508, 20037508),
    YAxis = YAxis.OSM,
    Format = "image/png",
};
custom.Resolutions.Add(0, new Resolution(0, 156543.03392804097, 256, 256));
custom.Resolutions.Add(1, new Resolution(1, 78271.51696402048, 256, 256));