Excel/CSV转GIS：一键WKT转gdf、Shapefile等图层

Python数据处理：如何将Excel/CSV中的WKT文本转换为Shapefile/GeoJSON——tablegis库df_to_gdf详解

前言

在地理数据处理中，我们经常遇到一种尴尬的情况：
从数据库（PostGIS, MySQL, ClickHouse）导出的数据，或者别人发来的CSV/Excel文件，里面有一列长得像这样：

POINT (116.40 39.90)
POLYGON ((116.3 39.9, 116.4 39.9, ...))

这叫做WKT (Well-Known Text)格式。虽然它描述了地理形状，但对Python的普通DataFrame来说，它就是一串纯文本字符串，无法直接进行地图可视化或空间计算（如求面积、缓冲区）。

通常我们需要手动调用shapely.wkt.loads并配合geopandas进行转换，步骤繁琐且容易出错（比如坐标系问题）。

今天介绍tablegis库中的df_to_gdf方法，一行代码将包含WKT文本的普通表格转换为标准的 GeoDataFrame，方便导出为 Shapefile、GeoJSON 等格式。

1. 场景痛点

场景一：数据库导出数据
后端工程师丢给你一个 CSV，里面全是POINT(...)，你需要把它转换成shp文件给规划师画图。

场景二：数据可视化
你想用 Python 做地图分析，但pandas读取的数据无法直接 plot，必须转成geopandas对象。

2. 核心方法：df_to_gdf

这个方法专门用于“文本转几何对象”。

安装

pipinstalltablegis

函数签名

importtablegisastg gdf=tg.df_to_gdf(df,# 你的普通DataFramegeometry='geometry',# 包含WKT文本的那一列的列名crs='epsg:4326'# 坐标系，默认为 WGS84 (EPSG:4326))

它的作用：

自动解析指定列的 WKT 字符串。
将其转换为真实的 Shapely 几何对象。
自动设置坐标系（CRS）。
智能重命名：无论你原来的列名叫wkt_geom还是shape，转换后都会统一规范为geometry，方便后续兼容。

3. 实战案例

案例一：CSV 转 Shapefile (最常见需求)

假设你有一个data.csv：

id	name	wkt_shape
1	A区	POLYGON ((…))
2	B区	POLYGON ((…))

代码实现：

importpandasaspdimporttablegisastg# 1. 读取 CSVdf=pd.read_csv('data.csv')# 2. 一行转换！# 指定 'wkt_shape' 是存几何文本的列gdf=tg.df_to_gdf(df,geometry='wkt_shape')# 现在 gdf 已经是 GeoDataFrame 了，可以直接操作print(gdf.crs)# 输出: EPSG:4326print(type(gdf.geometry.iloc[0]))# 输出: <class 'shapely.geometry.polygon.Polygon'># 3. 导出为 Shapefilegdf.to_file('output_shapefile.shp',encoding='utf-8')# 或者导出为 GeoJSONgdf.to_file('output.geojson',driver='GeoJSON')

案例二：处理自定义坐标系

如果你的 WKT 数据不是经纬度（WGS84），而是投影坐标（比如 Web Mercator 3857 或 UTM），你可以通过crs参数指定。

# 假设数据是 Web Mercator 投影gdf=tg.df_to_gdf(df,geometry='geom',crs='epsg:3857')# 转换后直接进行重投影到经纬度gdf_wgs84=gdf.to_crs('epsg:4326')

案例三：结合 match_layer 使用

通常df_to_gdf是数据处理的第一步。转换成功后，你就可以用它来做空间分析了，比如上面介绍的match_layer。

# 1. 加载含 WKT 的 CSVdf_raw=pd.read_csv('zones.csv')# 2. 转为 GeoDataFrame (面数据)gdf_zones=tg.df_to_gdf(df_raw,geometry='the_geom')# 3. 此时它就可以作为 match_layer 的 layer 参数输入了# result = tg.match_layer(df_points, gdf_zones, ...)

4. 参数详解

参数	类型	默认值	说明
`df`	DataFrame	必填	包含 WKT 文本列的 pandas DataFrame。
`geometry`	str	‘geometry’	关键：指定哪一列包含 WKT 文本。转换后该列会被解析并重命名为`geometry`。
`crs`	str	‘epsg:4326’	指定结果的坐标参考系统。通常经纬度数据用 4326，高德/百度坐标可能需要先转码（tablegis也提供了坐标转换工具）。