# Geostream
**Geostream** is a Python tool to interact with OGC APIs with ease and download geospatial data to Geopandas GeoDataFrames.
**Status**: Currently only works with WFS API and is very experimental by nature. Use at own risk.
## Installation
`geostream` is available via PyPi and can be installed with:
- `pip install geostream`
## Basic usage
```python
from geostream import WFS
# Endpoint for WFS API of the City of Helsinki
endpoint = "https://kartta.hel.fi/ws/geoserver/avoindata/wfs"
# Initialize WFS reader
# Note: API version can vary between data providers (by default 1.0.0 is used)
wfs = WFS(endpoint, version="2.0.0")
# See all available layers
wfs.get_layers()
# Store the id of the first layer
first_layer = wfs.get_layers()[0]
# Find info for specific layer
wfs.get_layer_info(first_layer)
# Download a GeoDataFrame with Helsinki as the extent
helsinki_gdf = wfs.get_gdf_from_place("Helsinki")
# Download the data into GeoDataFrame from the Helsinki Region
data = wfs.load_wfs(layer_id=first_layer, bounding_box=helsinki_gdf)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/geostream-org/geostream",
"name": "geostream",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Henrikki Tenkanen",
"author_email": "henrikki.tenkanen@aalto.fi",
"download_url": "https://files.pythonhosted.org/packages/aa/15/43c91587136b201b90a92da11bd7a3cfabc41eccc55fade6a011ed102d0b/geostream-0.0.1.tar.gz",
"platform": null,
"description": "# Geostream\n\n**Geostream** is a Python tool to interact with OGC APIs with ease and download geospatial data to Geopandas GeoDataFrames. \n\n**Status**: Currently only works with WFS API and is very experimental by nature. Use at own risk. \n\n## Installation\n\n`geostream` is available via PyPi and can be installed with:\n\n- `pip install geostream`\n\n## Basic usage\n\n```python\nfrom geostream import WFS\n\n# Endpoint for WFS API of the City of Helsinki\nendpoint = \"https://kartta.hel.fi/ws/geoserver/avoindata/wfs\"\n\n# Initialize WFS reader \n# Note: API version can vary between data providers (by default 1.0.0 is used) \nwfs = WFS(endpoint, version=\"2.0.0\")\n\n# See all available layers\nwfs.get_layers()\n\n# Store the id of the first layer\nfirst_layer = wfs.get_layers()[0]\n\n# Find info for specific layer\nwfs.get_layer_info(first_layer)\n\n# Download a GeoDataFrame with Helsinki as the extent\nhelsinki_gdf = wfs.get_gdf_from_place(\"Helsinki\")\n\n# Download the data into GeoDataFrame from the Helsinki Region\ndata = wfs.load_wfs(layer_id=first_layer, bounding_box=helsinki_gdf)\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python tool to interact with OGC APIs with ease.",
"version": "0.0.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fd5313254b1f10fc973417483904ef8803db53a137d42803f510412139e88d23",
"md5": "c7d56e17967787e4d8c05fc52f1ab632",
"sha256": "84f804d6312cc99e6bbd4f37af20657c57362a110b8073bee8631ed6cb71ff90"
},
"downloads": -1,
"filename": "geostream-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c7d56e17967787e4d8c05fc52f1ab632",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5332,
"upload_time": "2023-01-24T21:12:18",
"upload_time_iso_8601": "2023-01-24T21:12:18.955884Z",
"url": "https://files.pythonhosted.org/packages/fd/53/13254b1f10fc973417483904ef8803db53a137d42803f510412139e88d23/geostream-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aa1543c91587136b201b90a92da11bd7a3cfabc41eccc55fade6a011ed102d0b",
"md5": "819728359ee5178cc6139a500621a9e9",
"sha256": "223506bda4a82b28a5ccdd261a92eb6ca65462ab4f98e8c60528e90b9167cbaf"
},
"downloads": -1,
"filename": "geostream-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "819728359ee5178cc6139a500621a9e9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 5095,
"upload_time": "2023-01-24T21:12:20",
"upload_time_iso_8601": "2023-01-24T21:12:20.684571Z",
"url": "https://files.pythonhosted.org/packages/aa/15/43c91587136b201b90a92da11bd7a3cfabc41eccc55fade6a011ed102d0b/geostream-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-24 21:12:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "geostream-org",
"github_project": "geostream",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "geostream"
}