BAYSICS Webportal

BAYSICS-API Dokumentation

Inhalt

Attribute der Beobachtungen
Schnittstellen für Informations-Abfragen
- Beispiele

Attribute der Beobachtungen

Attribute einer Baumgrenzen-Beobachtung:

id:
- Die eindeutige Identifikationsnummer des Baumgrenzen-Eintrages
- Datentyp: Number
TreeSpecies:
- Die Art des Baums
- Datentyp: String
Certainty:
- Aussage darüber, ob sich der Beobachter sicher oder unsicher mit der Beobachtung ist
- Datentyp: String
- Werte: "Sicher" oder "Unsicher"
TreeHeight:
- Die approximierte Höhe des Baumes
- Datentyp: String
- Werte: "< 1m", "1-3m" oder "> 3m"
Distance_m:
- Die Entfernung von welcher die Beobachtung gemacht wurde
- Datentyp: Number
Lat:
- Der Breitengrad der Beobachtung
- Datentyp: String
Lon:
- Der Längengrad der Beobachtung
- Datentyp: String
AltitudeMeasured_m:
- Die gemessene Höhe über NN des Baumes
- Datentyp: Number
Municipal:
- Der Landkreis, in welcher sich die Beobachtung befindet
- Datentyp: String
ObservationDate:
- Das Datum der Beobachtung
- Datentyp: String
- Format: "JJJJ-MM-TT"
Photo:
- Die URL zum dazugehörenden Fotos
- Datentyp: String

Attribute einer Pflanzen-Beobachtung:

id:
- Die eindeutige Identifikationsnummer des Pflanzen-Eintrages
- Datentyp: Number
VegSpecies:
- Die Art der Pflanze
- Datentyp: String
Certainty:
- Aussage darüber, ob sich der Beobachter sicher oder unsicher mit der Beobachtung ist
- Datentyp: String
- Werte: "Sicher" oder "Unsicher"
Amount:
- Aussage darüber, wie viele Exemplare der Pflanze beobachtet wurden
- Datentyp: String
- Werte: "einzeln stehende Pflanze", "mehrere Pflanzen" oder "groessere Flaeche"
Flower:
- Aussage darüber, ob die Pflanze Blüten trägt
- Datentyp: String
- Werte: "Ja" oder "Nein"
FlowerOpen:
- Aussage darüber, ob die Blüten der Pflanze offen sind
- Datentyp: String
- Werte: "Ja" oder "Nein"
FlowerFaded:
- Aussage darüber, ob die Blüten der Pflanze verwelkt sind
- Datentyp: String
- Werte: "Ja" oder "Nein"
StartOfBudding:
- Aussage darüber, ob die Pflanze im Beginn des Aus- oder Maitriebs ist
- Datentyp: String
- Werte: "Ja" oder "Nein"
StartOfNeedleLeafDevelopment:
- Aussage darüber, ob die Pflanze im Beginn der Nadel- oder Blattentfaltung ist
- Datentyp: String
- Werte: "Ja" oder "Nein"
LeafFall_pct:
- Prozentangabe des Blattfalls der Pflanze
- Datentyp: Number
- Werte: Eine Zahl zwischen 0 und 100
LeafColoring_pct:
- Prozentangabe der Blattverfärbung der Pflanze
- Datentyp: Number
- Werte: Eine Zahl zwischen 0 und 100
Event:
- Aussage über eine Besonderheit der Beobachtung
- Datentyp: String
- Werte: "keine", "Spaetfrost", "Duerre", "Johannistrieb" oder "Rosskastanien-Miniermotte"
Lat:
- Der Breitengrad der Beobachtung
- Datentyp: String
Lon:
- Der Längengrad der Beobachtung
- Datentyp: String
Municipal:
- Der Landkreis, in welcher sich die Beobachtung befindet
- Datentyp: String
ObservationDate:
- Das Datum der Beobachtung
- Datentyp: String
- Format: "JJJJ-MM-TT"
Photo:
- Die URL zum dazugehörenden Fotos
- Datentyp: String

Attribute einer Allergene-Arten-Beobachtung:

id:
- Die eindeutige Identifikationsnummer des Pflanzen-Eintrages
- Datentyp: Number
VegSpecies:
- Die Art der Pflanze
- Datentyp: String
Certainty:
- Aussage darüber, ob sich der Beobachter sicher oder unsicher mit der Beobachtung ist
- Datentyp: String
- Werte: "Sicher" oder "Unsicher"
Flower:
- Aussage darüber, ob die Pflanze Blüten trägt
- Datentyp: String
- Werte: "Ja" oder "Nein"
FlowerOpen:
- Aussage darüber, ob die Blüten der Pflanze offen sind
- Datentyp: String
- Werte: "Ja" oder "Nein"
FlowerFaded:
- Aussage darüber, ob die Blüten der Pflanze verwelkt sind
- Datentyp: String
- Werte: "Ja" oder "Nein"
Lat:
- Der Breitengrad der Beobachtung
- Datentyp: String
Lon:
- Der Längengrad der Beobachtung
- Datentyp: String
Municipal:
- Der Landkreis, in welcher sich die Beobachtung befindet
- Datentyp: String
ObservationDate:
- Das Datum der Beobachtung
- Datentyp: String
- Format: "JJJJ-MM-TT"
Photo:
- Die URL zum dazugehörenden Fotos
- Datentyp: String

Attribute einer Tier-Beobachtung:

id:
- Die eindeutige Identifikationsnummer des Tier-Eintrages
- Datentyp: Number
AnimalSpecies:
- Die Tierart
- Datentyp: String
Certainty:
- Aussage darüber, ob sich der Beobachter sicher oder unsicher mit der Beobachtung ist
- Datentyp: String
- Werte: "Sicher" oder "Unsicher"
Number:
- Die Anzahl der beobachteten Tiere
- Datentyp: Number
- Werte: Eine positive Nummer
Observation:
- Information über den Zustand der beobachteten Tiere
- Datentyp: String
- Werte: "fressen", "laufen", "sitzen", "schlafen", "tot" oder "Sonstiges"
PlaceInfo:
- Information über den Ort der Beobachtung
- Datentyp: String
ObservationMethod:
- Information darüber, wie die Beobachtung wahrgenommen wurde
- Datentyp: String
- Werte: "Sicht", "gehoert", "Spuren"
Lat:
- Der Breitengrad der Beobachtung
- Datentyp: String
Lon:
- Der Längengrad der Beobachtung
- Datentyp: String
Municipal:
- Der Landkreis, in welcher sich die Beobachtung befindet
- Datentyp: String
ObservationDate:
- Das Datum der Beobachtung
- Datentyp: String
- Format: "JJJJ-MM-TT"
ObservationTime:
- Das Tageszeit der Beobachtung
- Datentyp: String
- Format: "HH-MM-SS"
Photo:
- Die URL zum dazugehörenden Fotos
- Datentyp: String

Schnittstellen für Informations-Abfragen

Die Schnittstellen für Informations-Abfragen stellen einen Dienst bereit, der es ermöglich im übersichtlichen JSON-Format an Informationen über alle Beobachtungen zu erhalten.
Die Antwort der API-Schnittstellen erfolgt dabei immer als Liste von JSON-Objekten, welche alle Attribute der Beobachtungen enthalten. Dabei können bestimmte Anfragen auch mithilfe von Query-Parametern gefiltert werden.

Beispiele

Beispiel 1: Alle Baumgrenzen-Beobachtungen ausgeben.
Anfrage: GET https://www.portal.baysics.de/api/observations/trees
Antwort:

                
                [
                    {
                        "id": 1,
                        "TreeSpecies": "Berg-Ahorn",
                        "Certainty": "Sicher",
                        "TreeHeight": "1-3m",
                        "Distance_m": 23,
                        "ObservationDate": "2021-03-01",
                        "Photo": "...",
                        "Lat": "49.028882",
                        "Lon": "11.416262",
                        "AltitudeMeasured_m": 1400,
                        "Municipal": "Haunstetter Forst",
                        
                    },
                    ...
                ]

Beispiel 2: Alle Baumgrenzen-Beobachtungen einer Berg-Ulme ausgeben, welche in dem Landkreis Roding getätigt wurde.
Anfrage: GET https://www.portal.baysics.de/api/observations/trees?TreeSpecies=Berg-Ulme&Municipal=Roding
Antwort:

                
                [
                    {
                        "id": 2,
                        "TreeSpecies": "Berg-Ulme",
                        "Certainty": "Sicher",
                        "TreeHeight": "1-3m",
                        "Distance_m": 12,
                        "ObservationDate": "2021-03-01",
                        "Photo": "...",
                        "Lat": "49.151260",
                        "Lon": "12.526134",
                        "AltitudeMeasured_m": 1000,
                        "Municipal": "Roding",
                        
                    },
                    ...
                ]

Beispiel 3: Alle Baumgrenzen-Beobachtungen ausgeben, welche am 24.12.2020 getätigt wurden.
Anfrage: GET https://www.portal.baysics.de/api/observations/trees?ObservationDate=2020-12-24
Antwort:

                
                [
                    {
                        "id": 14,
                        "TreeSpecies": "Berg-Ulme",
                        "Certainty": "Sicher",
                        "TreeHeight": "1-3m",
                        "Distance_m": 40,
                        "ObservationDate": "2020-12-24",
                        "Photo": "...",
                        "Lat": "49.151260",
                        "Lon": "12.526134",
                        "AltitudeMeasured_m": 1234,
                        "Municipal": "Roding",
                        
                    },
                    ...
                ]

Beispiel 4: Alle Pflanzen-Beobachtungen ausgeben, welche am zum Beobachtungszeitpunkt im Mai-Austrieb waren.
Anfrage: GET https://www.portal.baysics.de/api/observations/phenology?StartOfBudding=Ja
Antwort:

                
                [
                    {
                        "id": 6,
                        "VegSpecies": "Loewenzahn",
                        "Certainty": "Sicher",
                        "Amount": "groessere Flaeche",
                        "Flower": "Nein",
                        "FlowerOpen": "Ja",
                        "FlowerFaded": "Nein",
                        "Fruit": "Ja",
                        "LeafFall_pct": 46,
                        "LeafColoring_pct": 44,
                        "StartOfBudding": "Ja",
                        "StartOfNeedleLeafDevelopment": "Nein",
                        "Event": "Duerre",
                        "Lat": "48.942316",
                        "Lon": "11.838595",
                        "Municipal": "Ihrlerstein",
                        "ObservationDate": "2021-03-12",
                        "Photo": null,
                        
                    },
                    ...
                ]