Weather Data

Captador Weather Data

Un script PHP básico que captura y genera Weather Data en JSON para usar en otros sitios UCF. Utiliza un mecanismo de almacenamiento en caché simple que guarda los resultados obtenidos previamente y hace referencia a ese archivo guardado si se realiza otra solicitud dentro de la duración de la caché establecida. Las condiciones recuperadas son relativas al área de Orlando, pero se pueden actualizar para otros proyectos modificando las constantes WEATHER_URL_CURRENT y WEATHER_URL_FORECAST .

El script está actualmente escrito para aceptar y analizar datos XML de NOAA. Los códigos de condición para imágenes son cadenas de forma predeterminada, pero se convierten al código de condición estándar de Weather.com/Yahoo (ya que la mayoría de nuestros sitios ya lo usan de todos modos). Estos códigos de condición también se usan para generar una frase de condición, debido a la configuración predeterminada. Las frases de condición de la NOAA son muy detalladas.

Dentro del feed se proporcionan enlaces a varios conjuntos de iconos; img/weather-small/ contiene iconos utilizados en ucf.edu; img/weather-medium/ contiene iconos utilizados en los correos electrónicos de GMUCF; img/weather-large/ contiene íconos utilizados en UCF Today.

Uso

El feed de condiciones actuales del área de Orlando se devuelve de forma predeterminada cuando se solicita index.php. Utilice los data del parámetro GET para devolver diferentes conjuntos de datos:

• ?data=forecastToday: Pronóstico para hoy; incluye condiciones/temperaturas para hoy y esta noche
• ?data=forecastExtended: pronóstico de 5 días, dividido en días ('días', agrupados en 'días 1-5')

Condiciones actuales y pronósticos Valores devueltos

SuccessfulFetch (cadena: anteriormente 'successfulCache' en v1.0.0)

O 'sí' o 'no'; Si los datos solicitados se obtuvieron correctamente de la fuente externa especificada, este valor se establece en "sí". Si algún contenido particular falta en la fuente externa para algún día, este valor se establece en "no".

proveedor (cadena)

La URL del proveedor Weather Data .

fecha (cadena)

La fecha para el conjunto dado de condiciones climáticas. (Formato AAAA-MM-DD)

condición (cadena)

Una frase sobre condiciones climáticas. Estas frases se basan libremente en las descripciones del código de Yahoo Weather API: (http://developer.yahoo.com/weather/#codetable)

código img (int)

Un código de condición de estado, basado en el código de estado proporcionado por la NOAA. Este código se traduce a un código de condición numérico de Weather.com/Yahoo.

imgSmall, imgMedium, imgLarge (cadena)

Enlaces a iconos meteorológicos relevantes. img/weather-small/ contiene iconos utilizados en ucf.edu; img/weather-medium/ contiene iconos utilizados en los correos electrónicos de GMUCF; img/weather-large/ contiene íconos utilizados en UCF Today.

almacenado en caché en (cadena)

La marca de tiempo en la que este conjunto de Weather Data se almacenó por última vez en caché.

feedUpdatedAt (cadena)

La marca de tiempo en la que el proveedor de feeds (NOAA) actualizó por última vez el contenido de su feed.

Condiciones actuales, pronóstico de hoy valores devueltos

temperatura (cadena)

Lectura de temperatura actual. (Incluye símbolo de grado)

temperaturaN (int)

Lectura de temperatura actual. (No incluye símbolo de grado)

Valores devueltos del pronóstico extendido (por 'día')

tempMax (cadena)

Temperatura máxima prevista para ese día. (Incluye símbolo de grado)

tempMaxN (int)

Temperatura máxima prevista para ese día. (No incluye símbolo de grado)

tempMin (cadena)

Temperatura mínima prevista para ese día. (Incluye símbolo de grado). Tenga en cuenta que la NOAA no proporciona una tempMin de 'día7'.

tempMinN (int)

Temperatura mínima prevista para ese día. (No incluye símbolo de grado).

Notas

• Se espera que los sitios que utilizan este servicio almacenen en caché los resultados. Los datos solo deben solicitarse desde este script en un intervalo establecido. Volver a solicitar este servicio no activará la recuperación de contenido nuevo a menos que haya transcurrido el período de caché definido.
• Los sitios que utilizan este servicio deben verificar si hay valores de datos legítimos antes de mostrar datos de feeds al usuario. Incluso si el valor 'successfulFetch' se establece en 'no', aún se pueden devolver datos parciales. Los valores de reserva predeterminados se eliminaron a partir de la versión 1.1.3.
• El caché solo se actualiza con datos nuevos cuando los datos antiguos almacenados en caché han caducado Y un conjunto de datos recién capturado se obtuvo con éxito. Este script continuará mostrando datos obsoletos en buen estado hasta que se realice otra recuperación de datos exitosa, siempre y cuando esos datos obsoletos se hayan recuperado el mismo día.
• Tenga en cuenta que la NOAA solo actualiza sus datos de condición actual una vez por hora, aproximadamente 45 minutos después de la hora. El script Weather Grabber está configurado para almacenar en caché los datos durante 15 minutos.
• A partir de la versión 1.1.9, este proyecto utiliza cURL para recuperar datos de la NOAA. Los entornos que ejecutan este proyecto deben tener instalado libcurl para admitir la funcionalidad cURL de PHP. Consulte la documentación de PHP sobre cURL para obtener más información.