Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hiveeyes/apicast

Apicast acquires bee flight forecast information published by Deutscher Wetterdienst (DWD)
https://github.com/hiveeyes/apicast

apis-mellifera bee bee-flight data dwd forecast honeybee opendata

Last synced: about 2 months ago
JSON representation

Apicast acquires bee flight forecast information published by Deutscher Wetterdienst (DWD)

Awesome Lists containing this project

README

        

#######
Apicast
#######

|

.. start-badges

|ci-tests| |ci-coverage| |license| |pypi-downloads|
|python-versions| |status| |pypi-version|

.. |ci-tests| image:: https://github.com/hiveeyes/apicast/workflows/Tests/badge.svg
:target: https://github.com/hiveeyes/apicast/actions?workflow=Tests

.. |ci-coverage| image:: https://codecov.io/gh/hiveeyes/apicast/branch/main/graph/badge.svg
:target: https://codecov.io/gh/hiveeyes/apicast
:alt: Test suite code coverage

.. |python-versions| image:: https://img.shields.io/pypi/pyversions/apicast.svg
:target: https://python.org

.. |pypi-version| image:: https://img.shields.io/pypi/v/apicast.svg
:target: https://pypi.org/project/apicast/

.. |status| image:: https://img.shields.io/pypi/status/apicast.svg
:target: https://pypi.org/project/apicast/

.. |license| image:: https://img.shields.io/pypi/l/apicast.svg
:target: https://pypi.org/project/apicast/

.. |pypi-downloads| image:: https://static.pepy.tech/badge/apicast/month
:target: https://pepy.tech/project/apicast

.. end-badges

*****
About
*****

Apicast acquires bee flight forecast information published by Deutscher Wetterdienst (DWD).

- **Development**: `Hiveeyes » DWD-Prognose Bienenflug`_
- **Live API**: https://apicast.hiveeyes.org/ (also on HTTP)

*****
Setup
*****

CLI version::

pip install apicast

HTTP API::

pip install apicast[service]

********
Synopsis
********

Display list of states and sites::

apicast beeflight stations

Display list of location slugs::

apicast beeflight stations --slugs

Acquire information for given location slug ``brandenburg/potsdam``::

apicast beeflight forecast --station=brandenburg/potsdam

Acquire information for given location slug ``brandenburg/potsdam``, output as table in Markdown format::

apicast beeflight forecast --station=brandenburg/potsdam --format=table-markdown

Output as table in JSON machine readable format::

apicast beeflight forecast --station=brandenburg/potsdam --format=json-machine

********
HTTP API
********

Start HTTP API service::

apicast service

Start HTTP service with dynamic code reloading::

apicast service --reload

Then navigate to::

open http://localhost:24640/

*******
Example
*******

::

apicast beeflight forecast --station=brandenburg/potsdam

::

[
{
"Datum": "Mo 01.06.",
"morgens": "stark",
"mittags": "intensiv",
"abends": "stark"
},
{
"Datum": "Di 02.06.",
"morgens": "stark",
"mittags": "intensiv",
"abends": "intensiv"
},
{
"Datum": "Mi 03.06.",
"morgens": "intensiv",
"mittags": "intensiv",
"abends": "intensiv"
}
]

*****
Tests
*****

::

make test

********************
Content attributions
********************

The copyright of data, particular images and pictograms are held by their respective owners, unless otherwise noted.

Data
====

- **Source**:

- https://www.dwd.de/DE/leistungen/biene_flug/bienenflug.html
- https://www.dwd.de/DE/fachnutzer/freizeitgaertner/1_gartenwetter/_node.html

- **Documentation**:

- https://www.dwd.de/DE/fachnutzer/landwirtschaft/dokumentationen/allgemein/bienenflug_doku.html
- https://www.dwd.de/DE/fachnutzer/landwirtschaft/dokumentationen/isabel/meinagrar_bienenflug.html
- https://www.dwd.de/DE/klimaumwelt/ku_beratung/landwirtschaft/agrar_modelle/Bienenflug.pdf?__blob=publicationFile

- **Data copyright**: © Deutscher Wetterdienst (DWD), Agricultural Meteorology Department

Logo picture
============

- **Description**: A bee swarm on an oak tree in Plymouth, UK
- **Date**: 21 June 2009
- **Source**: Own work
- **Author**: Nilfanion
- **Camera location**: 50° 24′ 38.3″ N, 4° 09′ 28.2″ W
- **License**: Creative Commons Attribution-Share Alike 3.0 Unported
- **URL**: https://commons.wikimedia.org/wiki/File:Bee_swarm_in_Plymouth.jpg

.. _Hiveeyes » DWD-Prognose Bienenflug: https://community.hiveeyes.org/t/dwd-prognose-bienenflug/787