Add to_geopandas() method

ci/environment-dev-3.6.yml

@@ -37,5 +37,6 @@ dependencies:
   - xarray
   - rasterio
   - ipywidgets
+  - geopandas
   - pip:
     - sphinx_copybutton

ci/environment-dev-3.7-upstream.yml

@@ -33,6 +33,7 @@ dependencies:
   - xarray
   - rasterio
   - ipywidgets
+  - geopandas
   - pip:
     - sphinx_copybutton
     - git+https://github.com/sat-utils/sat-stac.git

ci/environment-dev-3.7.yml

@@ -37,5 +37,6 @@ dependencies:
   - xarray
   - rasterio
   - ipywidgets
+  - geopandas
   - pip:
     - sphinx_copybutton

intake_stac/catalog.py

@@ -4,6 +4,7 @@
 import yaml
 from intake.catalog import Catalog
 from intake.catalog.local import LocalCatalogEntry
+import tempfile
 
 from . import __version__
 
@@ -152,6 +153,25 @@ def _load(self):
     def _get_metadata(self, **kwargs):
         return kwargs
 
+    def to_geopandas(self):
+        """
+        Load the STAC Item Collection into a geopandas GeoDataFrame
+        """
+        try:
+            import geopandas as gpd
+        except ImportError:
+            raise ImportError(
+                "Using to_geopandas requires the `geopandas` package"
+            )
+
+        with tempfile.NamedTemporaryFile(suffix=".geojson") as f:
+            self._stac_obj.save(f.name)
+            gf = gpd.read_file(f.name)
+        return gf
+
+    def from_geopandas(self):
+        ...
+
 
 class StacCollection(AbstractStacCatalog):
     """

intake_stac/tests/test_catalog.py

@@ -215,6 +215,14 @@ def test_stac_entry_constructor():
     assert d["metadata"] == item
 
 
+def test_cat_to_geopandas(stac_item_collection_obj):
+    import geopandas as gpd
+
+    cat = StacItemCollection(stac_item_collection_obj)
+    df = cat.to_geopandas()
+    assert isinstance(df, gpd.GeoDataFrame)
+
+
 # TODO - Add tests for:
 # StacEntry._get_driver()
 # StacEntryy._get_args()

requirements-dev.txt

@@ -1,2 +1,3 @@
 pytest>=4.5.0
 pytest-cov>=2.7.1
+geopandas