geopandas.read_file#
- geopandas.read_file(filename, bbox=None, mask=None, rows=None, **kwargs)#
从文件或URL返回GeoDataFrame。
0.7.0 新版功能: 遮罩，行
- 参数
- filename字符串、路径对象或类文件对象
要打开的文件或URL的绝对路径或相对路径，或任何具有Read()方法的对象(如打开的文件或StringIO)
- bboxTuple|GeoDataFrame或GeoSeries|Shapely Geometry，默认为无
按给定的边界框、GeoSeries、GeoDataFrame或形状良好的几何图形过滤要素。如果提供了GeoSeries或GeoDataFrame，则解决CRS不匹配问题。元组是(minx、miny、Maxx、Maxy)，以匹配形状良好的几何体对象的边界属性。不能与掩码一起使用。
- maskDict|GeoDataFrame或GeoSeries|Shapely Geometry，默认为无
过滤与给定的类似DICT的Geojson几何图形、GeoSeries、GeoDataFrame或Shapely几何图形相交的要素。如果提供了GeoSeries或GeoDataFrame，则解决CRS不匹配问题。不能与BBox一起使用。
- rowsInt或Slice，默认为无
通过传递整数(第一行)加载特定行 n 行)或Slice()对象。
- **kwargs
要传递给 open 或 BytesCollection 打开文件时，在Fiona库中使用。有关可能的关键字的详细信息，请键入：
import fiona; help(fiona.open)
- 退货
- :obj:`geopandas.GeoDataFrame` or : obj:pandas.DataFrame ：OBJ：
如果 ignore_geometry=True 一个
pandas.DataFrame将会被退还。
注意事项
格式驱动程序将尝试检测数据的编码，但可能会失败。在这种情况下，可以使用编码关键字参数显式指定正确的编码，例如
encoding='utf-8'。示例
>>> df = geopandas.read_file("nybb.shp")
指定GPKG的层：
>>> df = geopandas.read_file("file.gpkg", layer='cities')
仅读取前10行：
>>> df = geopandas.read_file("nybb.shp", rows=10)
仅读取相交的几何图形
mask：>>> df = geopandas.read_file("nybb.shp", mask=polygon)
仅读取相交的几何图形
bbox：>>> df = geopandas.read_file("nybb.shp", bbox=(0, 0, 10, 20))