[![GitHub release (latest by date)](https://img.shields.io/github/v/release/Geospatial-AI-DE/geodisasters-py)](https://pypi.org/project/geodisasters)
![GitHub License](https://img.shields.io/github/license/Geospatial-AI-DE/geodisasters-py)
[![Read the Docs](https://img.shields.io/readthedocs/geodisasters)](https://geodisasters.readthedocs.io/en/latest)
[![Tweet Me](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FGeospatial-AI-DE%geodisasters-py)](https://twitter.com/intent/tweet?text=Outstanding:&url=https%3A%2F%2Fgithub.com%2FGeospatial-AI-DE%geodisasters-py)
# Geospatial Disasters API Service
Query broadcasted news related to natural disasters and visualize them using spatial aggregations.
Broadcasted news serves as a valuable source of information for identifying natural disasters globally. Geospatial features represent extracted locations from broadcasted news to identify the locations of these events. Natural disasters such as hurricanes, floods, wildfires, and others are captured and represented as geospatial features.
The service filters thousands of online news sources mentioning occurred natural disasters. We constructed a web mercator spatial grid having a grid size being optimized for geographic visualization. Each grid cell is enriched with a count attribute representing the number of news article related to locations of the corresponding grid cell.
The service uses the impressive data source provided by the [Global Database of Events, Language and Tone (GDELT) Project](https://www.gdeltproject.org/).
Every geospatial result support the GeoJSON and Esri FeatureSet format out of the box. For best performance, the serverless cloud-backend calculate the geospatial aggregations of the last 24 hours between midnight and 1 AM UTC. The serverless functions save these geospatial features since 24th May 2023 and yesterday should be the latest available date.
## Terms of use
We designed the geospatial intelligence API services for research and analysis of geospatial knowledge worldwide. The geospatial datasets and any result being generated by these API services are available for unrestricted use for academic, commercial, or governmental use of any kind.
Redistribution
You may redistribute, republish, and mirror the geospatial datasets in any form. However, any use or redistribution of the geospatial datasets and results must include a citation to GEOINT API services and a link to our website https://geospatial-ai.de.
### Query the news related to natural disasters occurred the last 365 days
![image](https://github.com/user-attachments/assets/d836fc8e-199e-4009-ab68-dd02807d2f2b)
![image](https://github.com/user-attachments/assets/31e6a33d-8381-4956-8d16-e3108547ccac)
Raw data
{
"_id": null,
"home_page": null,
"name": "geodisasters",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "geospatial, intelligence, urban, digital twin, natural disasters, knowledge",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/9e/a8/e188d87d396740756ba74b2f35e309c4f4aca96a300b80db11f64270d67a/geodisasters-0.1.1.tar.gz",
"platform": null,
"description": "[![GitHub release (latest by date)](https://img.shields.io/github/v/release/Geospatial-AI-DE/geodisasters-py)](https://pypi.org/project/geodisasters)\n![GitHub License](https://img.shields.io/github/license/Geospatial-AI-DE/geodisasters-py)\n[![Read the Docs](https://img.shields.io/readthedocs/geodisasters)](https://geodisasters.readthedocs.io/en/latest)\n[![Tweet Me](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FGeospatial-AI-DE%geodisasters-py)](https://twitter.com/intent/tweet?text=Outstanding:&url=https%3A%2F%2Fgithub.com%2FGeospatial-AI-DE%geodisasters-py)\n\n# Geospatial Disasters API Service\nQuery broadcasted news related to natural disasters and visualize them using spatial aggregations.\n\nBroadcasted news serves as a valuable source of information for identifying natural disasters globally. Geospatial features represent extracted locations from broadcasted news to identify the locations of these events. Natural disasters such as hurricanes, floods, wildfires, and others are captured and represented as geospatial features.\n\nThe service filters thousands of online news sources mentioning occurred natural disasters. We constructed a web mercator spatial grid having a grid size being optimized for geographic visualization. Each grid cell is enriched with a count attribute representing the number of news article related to locations of the corresponding grid cell.\n\nThe service uses the impressive data source provided by the [Global Database of Events, Language and Tone (GDELT) Project](https://www.gdeltproject.org/).\n\nEvery geospatial result support the GeoJSON and Esri FeatureSet format out of the box. For best performance, the serverless cloud-backend calculate the geospatial aggregations of the last 24 hours between midnight and 1 AM UTC. The serverless functions save these geospatial features since 24th May 2023 and yesterday should be the latest available date.\n\n## Terms of use\n\nWe designed the geospatial intelligence API services for research and analysis of geospatial knowledge worldwide. The geospatial datasets and any result being generated by these API services are available for unrestricted use for academic, commercial, or governmental use of any kind.\nRedistribution\n\nYou may redistribute, republish, and mirror the geospatial datasets in any form. However, any use or redistribution of the geospatial datasets and results must include a citation to GEOINT API services and a link to our website https://geospatial-ai.de.\n\n### Query the news related to natural disasters occurred the last 365 days\n\n![image](https://github.com/user-attachments/assets/d836fc8e-199e-4009-ab68-dd02807d2f2b)\n\n![image](https://github.com/user-attachments/assets/31e6a33d-8381-4956-8d16-e3108547ccac)\n",
"bugtrack_url": null,
"license": null,
"summary": "Query broadcasted news related to natural disasters and visualize them using spatial aggregations.",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://geodisasters.readthedocs.io/en/latest",
"GitHub": "https://github.com/Geospatial-AI-DE/geodisasters-py",
"Homepage": "https://geospatial-ai.de"
},
"split_keywords": [
"geospatial",
" intelligence",
" urban",
" digital twin",
" natural disasters",
" knowledge"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "49c75d6ea3f07bbf04ad5924f021e2814cb0b311c72b00ff25eec8af0df0a732",
"md5": "99788b2c063a0a157c23c837aef834bd",
"sha256": "8fb6a1e08dd8c38e8ea399c9d5834304f195cf97e00e9c289636c19dea0ec6c7"
},
"downloads": -1,
"filename": "geodisasters-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "99788b2c063a0a157c23c837aef834bd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8071,
"upload_time": "2024-08-13T18:33:43",
"upload_time_iso_8601": "2024-08-13T18:33:43.645360Z",
"url": "https://files.pythonhosted.org/packages/49/c7/5d6ea3f07bbf04ad5924f021e2814cb0b311c72b00ff25eec8af0df0a732/geodisasters-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9ea8e188d87d396740756ba74b2f35e309c4f4aca96a300b80db11f64270d67a",
"md5": "8606fec8ce53b2df85d40b3091bb547a",
"sha256": "d18a693b1051213175e0bb1fb3f473cfdbb310f50539ead5e75371f25af5b546"
},
"downloads": -1,
"filename": "geodisasters-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "8606fec8ce53b2df85d40b3091bb547a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 22579,
"upload_time": "2024-08-13T18:33:45",
"upload_time_iso_8601": "2024-08-13T18:33:45.524150Z",
"url": "https://files.pythonhosted.org/packages/9e/a8/e188d87d396740756ba74b2f35e309c4f4aca96a300b80db11f64270d67a/geodisasters-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-13 18:33:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Geospatial-AI-DE",
"github_project": "geodisasters-py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "geodisasters"
}