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")