Weather Data

Weather Data采集器

一个基本的 PHP 脚本，用于获取并输出 JSON 格式的Weather Data ，以便在其他 UCF 站点上使用。使用简单的缓存机制，保存以前抓取的结果，并在设置的缓存持续时间内发出另一个请求时引用该保存的文件。检索到的条件是相对于奥兰多地区的，但可以通过修改WEATHER_URL_CURRENT和WEATHER_URL_FORECAST常量来更新其他项目。

目前编写的脚本是为了接受和解析 NOAA XML 数据。图像的条件代码默认为字符串，但会转换为 Weather.com/Yahoo 条件代码标准（因为我们的大多数网站已经在使用它了）。由于默认情况下，这些条件代码也用于生成条件短语NOAA 条件短语非常冗长。

提要中提供了各种图标集的链接； img/weather-small/包含 ucf.edu 上使用的图标； img/weather-medium/包含 GMUCF 电子邮件中使用的图标； img/weather-large/包含 UCF Today 上使用的图标。

用法

当请求index.php 时，默认返回奥兰多地区的当前状况提要。使用GET参数data返回不同组数据：

• ?data=forecastToday：今天的预测；包括今天和今晚的条件/温度
• ?data=forecastExtended：5天预测，分为天（'days'，分组为'day1-5'）

当前状况和预测返回值

successFetch（字符串 - 以前在 v1.0.0 中为“successfulCache”）

要么“是”要么“否”；如果已从指定的外部源成功获取请求的数据，则该值设置为“yes”。如果任何一天外部源中缺少某些特定内容，则该值设置为“否”。

提供者（字符串）

Weather Data提供商的 URL。

日期（字符串）

给定天气条件组的日期。 （格式年-月-日）

条件（字符串）

天气状况短语。这些短语大致基于 Yahoo Weather API 代码描述：(http://developer.yahoo.com/weather/#codetable)

图像代码 (int)

状态条件代码，基于 NOAA 提供的状态代码。该代码被转换为 Weather.com/Yahoo 数字条件代码。

imgSmall、imgMedium、imgLarge（字符串）

相关天气图标的链接。 img/weather-small/包含 ucf.edu 上使用的图标； img/weather-medium/包含 GMUCF 电子邮件中使用的图标； img/weather-large/包含 UCF Today 上使用的图标。

缓存（字符串）

最后一次缓存这组Weather Data的时间戳。

feedUpdatedAt（字符串）

Feed 提供商 (NOAA) 上次更新其 Feed 内容的时间戳。

当前状况、今日预测返回值

温度（字符串）

当前温度读数。 （包括学位符号）

温度（整数）

当前温度读数。 （不包括学位符号）

扩展预测返回值（每“天”）

最大温度（字符串）

当天的最高预测温度。 （包括学位符号）

tempMaxN（整数）

当天的最高预测温度。 （不包括学位符号）

温度最小值（字符串）

当天的最低预测温度。 （包括度数符号。）请注意，NOAA 不提供“day7”tempMin。

tempMinN (int)

当天的最低预测温度。 （不包括学位符号。）

笔记

• 使用此服务的站点预计会在其端缓存结果。只能以设定的时间间隔从此脚本请求数据。重新请求此服务不会触发新内容的获取，除非已过了定义的缓存期限。
• 使用此服务的站点应在向用户显示提要数据之前检查合法的数据值。即使“successfulFetch”值设置为“no”，仍可能返回部分数据。自 v1.1.3 起，默认后备值已被删除。
• 仅当旧的缓存数据已过期且新抓取的数据集已成功抓取时，才会使用新数据刷新缓存。只要在同一天内检索到过时数据，此脚本将继续显示良好的过时数据，直到执行另一次成功的数据获取为止。
• 请注意，NOAA 每小时仅在（大约）整点后 45 分钟刷新一次当前状况数据。天气采集脚本设置为缓存数据 15 分钟。
• 从 v1.1.9 开始，该项目使用 cURL 来获取 NOAA 数据。运行此项目的环境必须安装 libcurl 以支持 PHP 的 cURL 功能。有关详细信息，请参阅有关 cURL 的 PHP 文档。