Weather Data

Сбор Weather Data

Базовый PHP-скрипт, который собирает и выводит Weather Data в формате JSON для использования на других сайтах UCF. Использует простой механизм кэширования, который сохраняет ранее полученные результаты и обращается к этому сохраненному файлу, если в течение установленного периода кэширования выполняется другой запрос. Полученные условия относятся к району Орландо, но их можно обновить для других проектов, изменив константы WEATHER_URL_CURRENT и WEATHER_URL_FORECAST .

В настоящее время написан сценарий для приема и анализа XML-данных NOAA. Коды условий для изображений по умолчанию представляют собой строки, но преобразуются в стандарт кодов условий Weather.com/Yahoo (поскольку большинство наших сайтов все равно его используют). Эти коды условий также используются для создания фразы условия, поскольку по умолчанию Условные фразы NOAA очень многословны.

В ленте представлены ссылки на различные наборы значков; img/weather-small/ содержит значки, используемые на ucf.edu; img/weather-medium/ содержит значки, используемые в электронных письмах GMUCF; img/weather-large/ содержит значки, используемые в UCF Today.

Использование

Фид текущих условий в районе Орландо возвращается по умолчанию при запросе index.php. Используйте data параметра GET для возврата различных наборов данных:

• ?data=forecastToday: прогноз на сегодня; включает условия/температуру на сегодня и сегодня вечером
• ?data=forecastExtended: прогноз на 5 дней, разделенный на дни («дни», сгруппированные в «день1–5»).

Текущие условия и прогнозы Возвращаемые значения

успешная выборка (строка — ранее «successfulCache» в версии 1.0.0)

Либо «да», либо «нет»; если запрошенные данные были успешно получены из указанного внешнего источника, для этого значения устанавливается значение «да». Если какой-либо конкретный контент отсутствует во внешнем источнике в какой-либо день, для этого значения устанавливается значение «нет».

провайдер (строка)

URL-адрес поставщика Weather Data .

дата (строка)

Дата для данного набора погодных условий. (Формат ГГГГ-ММ-ДД)

условие (строка)

Фраза о погодных условиях. Эти фразы во многом основаны на описаниях кода Yahoo Weather API: (http://developer.yahoo.com/weather/#codetable).

imgКод (целое)

Код состояния состояния, основанный на коде состояния, предоставленном NOAA. Этот код преобразуется в числовой код состояния Weather.com/Yahoo.

imgSmall, imgMedium, imgLarge (строка)

Ссылки на соответствующие значки погоды. img/weather-small/ содержит значки, используемые на ucf.edu; img/weather-medium/ содержит значки, используемые в электронных письмах GMUCF; img/weather-large/ содержит значки, используемые в UCF Today.

кэшированAt (строка)

Временная метка последнего кэширования этого набора Weather Data .

фидUpdatedAt (строка)

Временная метка, когда поставщик каналов (NOAA) в последний раз обновлял содержимое своего канала.

Текущие условия, возвращаемые значения прогноза на сегодняшний день

температура (строка)

Текущее показание температуры. (Включает символ градуса)

темпN (целое)

Текущее показание температуры. (Не включает символ градуса)

Возвращаемые значения расширенного прогноза (за «день»)

tempMax (строка)

Максимальная прогнозируемая температура в этот день. (Включает символ градуса)

темпМаксN (целое)

Максимальная прогнозируемая температура в этот день. (Не включает символ градуса)

темпМин (строка)

Минимальная прогнозируемая температура в этот день. (Включает символ градуса.) Обратите внимание, что значение tempMin «day7» не предоставляется NOAA.

темпМинН (целое)

Минимальная прогнозируемая температура в этот день. (Не включает символ градуса.)

Примечания

• Ожидается, что сайты, использующие эту службу, будут кэшировать результаты на своей стороне. Данные следует запрашивать из этого сценария только через заданный интервал. Повторный запрос этой услуги не приведет к получению нового контента, пока не пройдет определенный период кэширования.
• Сайты, использующие эту службу, должны проверять достоверность значений данных, прежде чем отображать данные канала пользователю. Даже если для параметра «successfulFetch» ​​установлено значение «нет», частичные данные все равно могут быть возвращены. Начиная с версии 1.1.3, резервные значения по умолчанию удалены.
• Кэш обновляется новыми данными только тогда, когда срок действия старых кэшированных данных истек, И новый набор данных был успешно получен. Этот сценарий будет продолжать отображать хорошие устаревшие данные до тех пор, пока не будет выполнена еще одна успешная выборка данных, при условии, что эти устаревшие данные были получены в течение того же дня.
• Обратите внимание, что NOAA обновляет данные о текущем состоянии только один раз в час, примерно через 45 минут после часа. Скрипт граббера погоды настроен на кэширование данных в течение 15 минут.
• Начиная с версии 1.1.9, этот проект использует cURL для получения данных NOAA. В средах, в которых выполняется этот проект, должна быть установлена ​​библиотека libcurl для поддержки функциональности PHP cURL. Дополнительную информацию см. в документации PHP по cURL.