geopandas.GeoDataFrame.to_file#

GeoDataFrame.to_file(filename, driver=None, schema=None, index=None, **kwargs)#

写下 GeoDataFrame 保存到文件中。

默认情况下,会写入ESRI shapefile,但可以写入Fiona支持的任何OGR数据源。支持的OGR提供程序词典可通过以下方式获得:

>>> import fiona
>>> fiona.supported_drivers  
参数
filename字符串

要写入的文件路径或文件句柄。

driver字符串,默认为无

用于写入向量文件的OGR格式驱动程序。如果未指定,它会尝试从文件扩展名推断它。如果未指定扩展名,则会将ESRI shapefile保存到文件夹中。

schema字典,默认:无

如果指定,则将架构字典传递给Fiona,以便更好地控制如何写入文件。

index布尔默认为无

如果为True,则将索引写入一个或多个列(对于MultiIndex)。仅当索引已命名、为多索引或具有非整型数据类型时,默认无才会将索引写入一个或多个列。如果为False,则不写入任何索引。

0.7 新版功能: 此前,该指数并未写入。

参见

GeoSeries.to_file
GeoDataFrame.to_postgis

将GeoDataFrame写入PostGIS数据库

GeoDataFrame.to_parquet

将GeoDataFrame写入拼花地板

GeoDataFrame.to_feather

将GeoDataFrame写入羽化

注意事项

额外的关键字参数 **kwargs 传递给fiona.open,可用于写入多层数据、在归档(Zip文件)中存储数据等。

格式驱动程序将尝试检测数据的编码,但可能会失败。在这种情况下,可以使用编码关键字参数显式指定正确的编码,例如 encoding='utf-8'

示例

>>> gdf.to_file('dataframe.shp')  
>>> gdf.to_file('dataframe.gpkg', driver='GPKG', layer='name')  
>>> gdf.to_file('dataframe.geojson', driver='GeoJSON')  

对于选定的驱动程序,还可以使用以下命令将其追加到文件 mode="a"

>>> gdf.to_file('dataframe.shp', mode="a")