Weather Data

Captador Weather Data

Um script PHP básico que captura e gera Weather Data em JSON para uso em outros sites UCF. Usa um mecanismo de cache simples que salva os resultados obtidos anteriormente e faz referência a esse arquivo salvo se outra solicitação for feita dentro da duração do cache definida. As condições recuperadas são relativas à área de Orlando, mas podem ser atualizadas para outros projetos modificando as constantes WEATHER_URL_CURRENT e WEATHER_URL_FORECAST .

O script está atualmente escrito para aceitar e analisar dados XML NOAA. Os códigos de condição para imagens são strings por padrão, mas são convertidos para o padrão de código de condição Weather.com/Yahoo (já que a maioria de nossos sites já o usa de qualquer maneira). Esses códigos de condição também são usados ​​para gerar uma frase de condição, devido ao padrão As frases de condição NOAA são muito detalhadas.

Links para vários conjuntos de ícones são fornecidos no feed; img/weather-small/ contém ícones usados ​​em ucf.edu; img/weather-medium/ contém ícones usados ​​nos e-mails do GMUCF; img/weather-large/ contém ícones usados ​​no UCF Today.

Uso

O feed de condições atuais da área de Orlando é retornado por padrão quando index.php é solicitado. Use os data do parâmetro GET para retornar diferentes conjuntos de dados:

• ?data=forecastToday: Previsão para hoje; inclui condições/temperaturas para hoje e esta noite
• ?data=forecastExtended: previsão de 5 dias, dividida em dias ('dias', agrupados em 'dia1-5')

Condições Atuais e Previsões Valores Retornados

sucessoFetch (string - anteriormente 'successfulCache' na v1.0.0)

Ou 'sim' ou 'não'; se os dados solicitados foram obtidos com êxito da fonte externa especificada, esse valor será definido como 'sim'. Se algum conteúdo específico estiver faltando na fonte externa em algum dia, esse valor será definido como 'não'.

provedor (string)

A URL do provedor Weather Data .

data (sequência)

A data para um determinado conjunto de condições meteorológicas. (Formato AAAA-MM-DD)

condição (string)

Uma frase sobre condições climáticas. Essas frases são baseadas vagamente nas descrições de código da API do Yahoo Weather: (http://developer.yahoo.com/weather/#codetable)

imgCode (int)

Um código de condição de status, baseado no código de status fornecido pela NOAA. Este código é traduzido em um código de condição numérica Weather.com/Yahoo.

imgSmall, imgMedium, imgLarge (string)

Links para ícones meteorológicos relevantes. img/weather-small/ contém ícones usados ​​em ucf.edu; img/weather-medium/ contém ícones usados ​​nos e-mails do GMUCF; img/weather-large/ contém ícones usados ​​no UCF Today.

cachedAt (string)

O carimbo de data/hora em que esse conjunto de Weather Data foi armazenado em cache pela última vez.

feedUpdatedAt (string)

O carimbo de data/hora em que o provedor de feed (NOAA) atualizou pela última vez o conteúdo do feed.

Condições Atuais, Valores Retornados da Previsão de Hoje

temp (string)

Leitura da temperatura atual. (Inclui símbolo de grau)

tempN (int)

Leitura da temperatura atual. (Não inclui símbolo de grau)

Valores retornados da previsão estendida (por 'dia')

tempMax (string)

Temperatura máxima prevista para esse dia. (Inclui símbolo de grau)

tempMaxN (int)

Temperatura máxima prevista para esse dia. (Não inclui símbolo de grau)

tempMin (string)

Temperatura mínima prevista para esse dia. (Inclui símbolo de grau.) Observe que um tempMin 'day7' não é fornecido pela NOAA.

tempMinN (int)

Temperatura mínima prevista para esse dia. (Não inclui símbolo de grau.)

Notas

• Espera-se que os sites que usam este serviço armazenem em cache os resultados. Os dados só devem ser solicitados deste script em um intervalo definido. A nova solicitação deste serviço não acionará uma busca de novo conteúdo, a menos que o período de cache definido tenha passado.
• Os sites que usam esse serviço devem verificar valores de dados legítimos antes de exibir os dados do feed ao usuário. Mesmo que o valor 'successfulFetch' esteja definido como 'no', dados parciais ainda poderão ser retornados. Os valores de fallback padrão foram removidos a partir da v1.1.3.
• O cache só é atualizado com novos dados quando os dados antigos em cache expiram E um conjunto de dados recém-capturado foi capturado com sucesso. Este script continuará a exibir dados obsoletos válidos até que outra busca de dados bem-sucedida seja realizada, desde que esses dados obsoletos tenham sido recuperados no mesmo dia.
• Observe que a NOAA atualiza seus dados de condição atual apenas uma vez por hora, (aproximadamente) 45 minutos após a hora. O script de captura de clima está configurado para armazenar dados em cache por 15 minutos.
• A partir da v1.1.9, este projeto utiliza cURL para buscar dados NOAA. Os ambientes que executam este projeto devem ter libcurl instalado para suportar a funcionalidade cURL do PHP. Consulte a documentação do PHP sobre cURL para obter mais informações.