EF Core如何使用空间数据类型 EF Core NetTopologySuite地理信息教程

EF Core 使用空间数据需三步：安装对应数据库的 NetTopologySuite 扩展包并引用 NetTopologySuite 基础包；在 DbContext 配置中调用 UseNetTopologySuite()；实体属性使用 NTS 几何类型并显式设置 SRID 4326，注意坐标顺序为经度优先。

EF Core 使用空间数据，核心是靠 NetTopologySuite（NTS） 提供几何类型支持，并配合数据库提供者的空间扩展包完成映射与查询。它不是开箱即用的功能，需要显式启用、正确配置类型和 SRID，否则会报错或行为异常。

安装对应数据库的 NetTopologySuite 扩展包

不同数据库需引用不同的空间扩展包，不能混用：

• SQL Server：`Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite`
• PostgreSQL（PostGIS）：`Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite`
• SQLite（SpatiaLite）：`Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite` + `sqlite3` 原生库（macOS/Linux 需设 DYLD_LIBRARY_PATH）
• MySQL（Pomelo）：`Pomelo.EntityFrameworkCore.MySql.NetTopologySuite`

同时必须安装基础 NTS 包：NetTopologySuite，它是所有几何类型（Point、Polygon、LineString 等）的来源。

在 DbContext 中启用 NetTopologySuite

配置连接时，必须显式调用 UseNetTopologySuite() 方法：

// SQL Server 示例
options.UseSqlServer(connectionString, x => x.UseNetTopologySuite());
// PostgreSQL 示例
options.UseNpgsql(connectionString, x => x.UseNetTopologySuite());
// SQLite 示例
options.UseSqlite(connectionString, x => x.UseNetTopologySuite());

注意：不加这一步，即使模型里用了 Point，EF Core 也会忽略空间能力，生成普通 BLOB 或字符串字段，查询也完全无法使用空间函数。

定义实体中的空间属性并指定 SRID

NTS 类型默认 SRID 为 0，但绝大多数地理场景（如 GPS、地图 API）要求明确使用 SRID 4326（WGS 84）：

剪小映

记录美好智能成片，AI智能视频剪辑

902

查看详情

• 在模型中用 Fluent API 显式声明：

modelBuilder.Entity<Store>()
    .Property(e => e.Location)
    .HasSrid(4326); // 必须设置，否则距离计算、索引等可能出错

• 属性类型推荐使用 NTS 原生类：

public class Store
{
    public int Id { get; set; }
    public string Name { get; set; }
    public NetTopologySuite.Geometries.Point Location { get; set; } // 不要用 string 或 byte[]
}

注意：坐标顺序是 X（经度）、Y（纬度），例如 new Point(113.4667, 22.2723) { SRID = 4326 } —— 这和前端常写的 [lat, lng] 顺序相反，容易填反。

执行空间查询（如“附近5公里的门店”）

EF Core 会把 NTS 方法自动翻译成数据库原生空间函数（如 SQL Server 的 STDistance、PostGIS 的 ST_DWithin）：

var current = new NetTopologySuite.Geometries.Point(113.4667, 22.2723) { SRID = 4326 };

var nearby = await context.Stores
    .Where(s => s.Location.Distance(current) < 0.05) // 单位是“度”，非米！
    .OrderBy(s => s.Location.Distance(current))
    .Take(10)
    .ToListAsync();

⚠️ 注意：Distance() 返回单位取决于 SRID 和数据库。对 4326，SQL Server 返回“米”，PostgreSQL 默认返回“米”（若用 ST_DWithin），但 SQLite/SpatiaLite 返回“度”——建议生产环境统一用 STDistance + 索引，或在数据库层做单位转换。

更安全的做法是用数据库原生函数封装（如 SQL Server 的 STDistance）：

.Where(s => EF.Functions.STDistance(s.Location, current) < 5000) // 明确单位：米

基本上就这些。关键点就三个：装对包、启用 UseNetTopologySuite、设好 SRID 和坐标顺序。不复杂但容易忽略细节。

以上就是EF Core如何使用空间数据类型 EF Core NetTopologySuite地理信息教程的详细内容，更多请关注php中文网其它相关文章！