Weather Data

Pengambil Weather Data

Skrip PHP dasar yang mengambil dan mengeluarkan Weather Data dalam JSON untuk digunakan di situs UCF lainnya. Menggunakan mekanisme caching sederhana yang menyimpan hasil yang diambil sebelumnya dan merujuk ke file yang disimpan jika permintaan lain dibuat dalam durasi cache yang ditetapkan. Kondisi yang diambil bersifat relatif terhadap area Orlando, namun dapat diperbarui untuk proyek lain dengan memodifikasi konstanta WEATHER_URL_CURRENT dan WEATHER_URL_FORECAST .

Skrip saat ini ditulis untuk menerima dan mengurai data XML NOAA. Kode ketentuan untuk gambar adalah string secara default namun dikonversi ke standar kode ketentuan Weather.com/Yahoo (karena sebagian besar situs kami sudah menggunakannya.) Kode ketentuan ini juga digunakan untuk menghasilkan frasa ketentuan, karena default Frase kondisi NOAA menjadi sangat bertele-tele.

Tautan ke berbagai kumpulan ikon disediakan dalam feed; img/weather-small/ berisi ikon yang digunakan di ucf.edu; img/weather-medium/ berisi ikon yang digunakan dalam email GMUCF; img/weather-large/ berisi ikon yang digunakan di UCF Today.

Penggunaan

Umpan kondisi saat ini di wilayah Orlando dikembalikan secara default ketika index.php diminta. Gunakan data parameter GET untuk mengembalikan kumpulan data yang berbeda:

• ?data=forecastToday: Prakiraan untuk hari ini; termasuk kondisi/suhu hari ini dan malam ini
• ?data=forecastExended: perkiraan 5 hari, dibagi menjadi beberapa hari ('hari', dikelompokkan menjadi 'hari1-5')

Kondisi Saat Ini & Perkiraan Nilai yang Dikembalikan

suksesFetch (string--sebelumnya 'successfulCache' di v1.0.0)

Entah 'ya' atau 'tidak'; jika data yang diminta berhasil diambil dari sumber eksternal yang ditentukan, nilai ini disetel ke 'ya'. Jika beberapa konten tertentu hilang dari sumber eksternal pada suatu hari, nilai ini ditetapkan ke 'tidak'.

penyedia (string)

URL penyedia Weather Data .

tanggal (string)

Tanggal untuk rangkaian kondisi cuaca tertentu. (Format YYYY-MM-DD)

kondisi (string)

Ungkapan kondisi cuaca. Frasa ini didasarkan secara longgar pada deskripsi kode Yahoo Weather API: (http://developer.yahoo.com/weather/#codetable)

Kode img (int)

Kode kondisi status, berdasarkan kode status yang disediakan oleh NOAA. Kode ini diterjemahkan ke dalam kode kondisi numerik Weather.com/Yahoo.

imgKecil, imgSedang, imgBesar (string)

Tautan ke ikon cuaca yang relevan. img/weather-small/ berisi ikon yang digunakan di ucf.edu; img/weather-medium/ berisi ikon yang digunakan dalam email GMUCF; img/weather-large/ berisi ikon yang digunakan di UCF Today.

di-cacheAt (string)

Stempel waktu saat kumpulan Weather Data ini terakhir kali di-cache.

feedUpdatedAt (string)

Stempel waktu saat penyedia feed (NOAA) terakhir kali memperbarui konten feed mereka.

Kondisi Saat Ini, Nilai Pengembalian Prakiraan Hari Ini

suhu (string)

Pembacaan suhu saat ini. (Termasuk simbol derajat)

suhu (int)

Pembacaan suhu saat ini. (Tidak termasuk simbol derajat)

Nilai Pengembalian Perkiraan yang Diperpanjang (per 'hari')

tempMax (string)

Perkiraan suhu maksimum untuk hari itu. (Termasuk simbol derajat)

tempMaxN (int)

Perkiraan suhu maksimum untuk hari itu. (Tidak termasuk simbol derajat)

tempMin (string)

Perkiraan suhu minimum untuk hari itu. (Termasuk simbol derajat.) Perhatikan bahwa tempMin 'day7' tidak disediakan oleh NOAA.

tempMinN (int)

Perkiraan suhu minimum untuk hari itu. (Tidak termasuk simbol derajat.)

Catatan

• Situs yang menggunakan layanan ini diharapkan menyimpan hasil dalam cache. Data hanya boleh diminta dari skrip ini pada interval yang ditentukan. Meminta ulang layanan ini tidak akan memicu pengambilan konten baru kecuali periode cache yang ditentukan telah berlalu.
• Situs yang menggunakan layanan ini harus memeriksa nilai data yang sah sebelum menampilkan data feed kepada pengguna. Meskipun nilai 'successfulFetch' disetel ke 'no', sebagian data masih dapat dikembalikan. Nilai cadangan default telah dihapus pada v1.1.3.
• Cache hanya disegarkan dengan data baru ketika data cache lama telah kedaluwarsa, DAN kumpulan data yang baru diambil berhasil diambil. Skrip ini akan terus menampilkan data lama yang baik hingga pengambilan data lain yang berhasil dilakukan, selama data lama tersebut diambil pada hari yang sama.
• Perhatikan bahwa NOAA hanya menyegarkan data kondisi saat ini satu kali dalam satu jam, pada (kira-kira) 45 menit setelah satu jam. Skrip pengambil cuaca diatur untuk menyimpan data dalam cache selama 15 menit.
• Mulai v1.1.9, proyek ini menggunakan cURL untuk mengambil data NOAA. Lingkungan yang menjalankan proyek ini harus memiliki libcurl yang terinstal untuk mendukung fungsionalitas cURL PHP. Lihat dokumentasi PHP di cURL untuk informasi lebih lanjut.