EN

Τεκμηρίωση API Μετεωρολογικών Δεδομένων

Αυτό το API παρέχει πρόσβαση σε δεδομένα από τον μετεωρολογικό σταθμό depos, έναν από τους σταθμούς που συντηρούνται από την Ομάδα MeteoKav. Τα δεδομένα ανακτώνται από ένα CKAN DataStore και είναι διαθέσιμα σε μορφές JSON και CSV.

Βασικό URL

Το βασικό URL για όλες τις αιτήσεις API προς τα MeteoKav Datastores είναι: https://data.kavala.open-autonomy.com/restful/meteokav

Endpoint

Ανάκτηση Μετεωρολογικών Δεδομένων

GET /depos

Ανακτά μετεωρολογικά δεδομένα για τον σταθμό depos, με επιλογές φιλτραρίσματος κατά εύρος ημερομηνιών/ώρας, επιλογής συγκεκριμένων πεδίων και επιλογής της μορφής εξόδου. Λάβετε υπόψη ότι το υποκείμενο ερώτημα SQL έχει μέγιστο όριο εγγραφών 50000.

Παράμετροι

Όνομα Τύπος Περιγραφή Απαιτείται
from string (YYYY-MM-DD HH:MM) Φιλτράρει τα δεδομένα ξεκινώντας από αυτήν την ημερομηνία και ώρα. Όχι
to string (YYYY-MM-DD HH:MM) Φιλτράρει τα δεδομένα μέχρι αυτήν την ημερομηνία και ώρα. Εάν παραλειφθεί, επιστρέφει δεδομένα μέχρι την πιο πρόσφατη διαθέσιμη εγγραφή. Όχι
fields string Μια λίστα πεδίων διαχωρισμένων με κόμμα για συμπερίληψη στην απόκριση. Εάν παραλειφθεί, επιστρέφονται όλα τα διαθέσιμα πεδία.
Διαθέσιμα πεδία για τον σταθμό:
  • DateAndTimeStamp
  • temperature
  • humidity
  • dewpoint
  • barometer
  • windspeed
  • gustspeed
  • direction
  • rainlastmin
  • dailyrain
  • monthlyrain
  • yearlyrain
  • heatindex
Το πεδίο DateAndTimeStamp περιλαμβάνεται πάντα στην απόκριση, ακόμη και αν δεν καθορίζεται ρητά εδώ. 		Όχι
format string Η μορφή της απόκρισης. Διαθέσιμες τιμές: json (προεπιλογή), csv. Όχι
limit integer Μέγιστος αριθμός εγγραφών που θα επιστραφούν. Η προεπιλογή είναι 0 (χωρίς όριο). Όχι
offset integer Αρχικός αριθμός εγγραφής. Η προεπιλογή είναι 0. Όχι

Απόκριση

Απόκριση JSON

Επιστρέφει ένα αντικείμενο JSON με την ακόλουθη δομή: 


{
    "records_truncated": true, // περιλαμβάνεται μόνο εάν το αποτέλεσμα έχει αποκοπεί στις 50000 εγγραφές
    "records": [
        {
            "DateAndTimeStamp": "2024-07-24T12:00:00",
            "temperature": 25.5,
            // ... άλλα πεδία δεδομένων
        },
        {
            "DateAndTimeStamp": "2024-07-24T13:00:00",
            "temperature": 26.2,
            // ... άλλα πεδία δεδομένων
        }
        // ... περισσότερες εγγραφές, έως 50000
    ],
    "fields": [
        {"id": "DateAndTimeStamp", "type": "timestamp without time zone"},
        {"id": "temperature", "type": "numeric"},
                // ... άλλα πεδία
    ]
}
Απόκριση CSV

Επιστρέφει ένα αρχείο CSV με τα καθορισμένα πεδία (ή όλα τα διαθέσιμα πεδία εάν δεν καθορίζεται κανένα).

Παραδείγματα Αιτημάτων

Σφάλματα

Το API ενδέχεται να επιστρέψει τους ακόλουθους κωδικούς κατάστασης HTTP: