mirror of
https://github.com/wassname/geopandas.git
synced 2026-09-20 12:50:47 +08:00
Ardie Orden
030febcab2
* Add docs for using read_file on a ZIP file * Add docs for opening ZIP files with folders and multiple datasets * Fix wording of docs
65 lines
2.6 KiB
ReStructuredText
65 lines
2.6 KiB
ReStructuredText
.. _io:
|
|
|
|
Reading and Writing Files
|
|
=========================================
|
|
|
|
|
|
|
|
Reading Spatial Data
|
|
---------------------
|
|
|
|
*geopandas* can read almost any vector-based spatial data format including ESRI shapefile, GeoJSON files and more using the command::
|
|
|
|
geopandas.read_file()
|
|
|
|
which returns a GeoDataFrame object. (This is possible because *geopandas* makes use of the great `fiona <http://fiona.readthedocs.io/en/latest/manual.html>`_ library, which in turn makes use of a massive open-source program called `GDAL/OGR <http://www.gdal.org/>`_ designed to facilitate spatial data transformations).
|
|
|
|
Any arguments passed to ``read_file()`` after the file name will be passed directly to ``fiona.open``, which does the actual data importation. In general, ``read_file`` is pretty smart and should do what you want without extra arguments, but for more help, type::
|
|
|
|
import fiona; help(fiona.open)
|
|
|
|
Among other things, one can explicitly set the driver (shapefile, GeoJSON) with the ``driver`` keyword, or pick a single layer from a multi-layered file with the ``layer`` keyword::
|
|
|
|
countries_gdf = geopandas.read_file("package.gpkg", layer='countries')
|
|
|
|
Where supported in ``fiona``, *geopandas* can also load resources directly from
|
|
a web URL, for example for GeoJSON files from `geojson.xyz <http://geojson.xyz/>`_::
|
|
|
|
url = "http://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_110m_land.geojson"
|
|
df = geopandas.read_file(url)
|
|
|
|
You can also load ZIP files that contain your data::
|
|
|
|
zipfile = "zip:///Users/name/Downloads/cb_2017_us_state_500k.zip"
|
|
states = geopandas.read_file(zipfile)
|
|
|
|
If the dataset is in a folder in the ZIP file, you have to append its name::
|
|
|
|
zipfile = "zip:///Users/name/Downloads/gadm36_AFG_shp.zip!data"
|
|
|
|
If there are multiple datasets in a folder in the ZIP file, you also have to specify the filename::
|
|
|
|
zipfile = "zip:///Users/name/Downloads/gadm36_AFG_shp.zip!data/gadm36_AFG_1.shp"
|
|
|
|
|
|
*geopandas* can also get data from a PostGIS database using the ``read_postgis()`` command.
|
|
|
|
|
|
Writing Spatial Data
|
|
---------------------
|
|
|
|
GeoDataFrames can be exported to many different standard formats using the ``GeoDataFrame.to_file()`` method. For a full list of supported formats, type ``import fiona; fiona.supported_drivers``.
|
|
|
|
**Writing to Shapefile**::
|
|
|
|
countries_gdf.to_file("countries.shp")
|
|
|
|
**Writing to GeoJSON**::
|
|
|
|
countries_gdf.to_file("countries.geojson", driver='GeoJSON')
|
|
|
|
**Writing to GeoPackage**::
|
|
|
|
countries_gdf.to_file("package.gpkg", layer='countries', driver="GPKG")
|
|
cities_gdf.to_file("package.gpkg", layer='cities', driver="GPKG")
|