OpenWeatherMap 3天日预报:正确获取每日最高/最低温度的完整教程

老瑶大大_4316

老瑶大大_4316

2026-11-18

900人浏览

原创

OpenWeatherMap 3天日预报:正确获取每日最高/最低温度的完整教程

本文详解如何通过 OpenWeatherMap 的 forecast/daily API 获取未来3天的每日最高与最低温度,并避免使用错误的 3 小时粒度接口,附完整 PHP 示例与关键注意事项。

本文详解如何通过 openweathermap 的 `forecast/daily` api 获取未来3天的每日最高与最低温度,并避免使用错误的 3 小时粒度接口,附完整 php 示例与关键注意事项。

OpenWeatherMap 提供两类主流天气预报接口:/forecast(每3小时一次,共5天40条记录)和 /forecast/daily(按天聚合,含日均温、日极值等)。题中问题的根本原因在于误用了 /forecast 接口——该接口中 temp_max 和 temp_min 并非当日极值,而是未来3小时内预测的最高/最低温度(即滚动窗口值),因此无法直接用于“每日最高温/最低温”展示。

要实现如 Thursday 15.09: Max: 25°C / Min: 20°C 这类标准日预报,必须切换至已正式支持(且文档明确标注为“Deprecated but still available”的过渡期稳定接口)的 /data/2.5/forecast/daily 端点。该接口返回结构清晰的每日聚合数据,每个 list 元素代表一天,其 temp.day、temp.min、temp.max 字段即为当日白天均温、全天最低温、全天最高温(单位:°C,当 units=metric 时无需手动转换)。

以下是推荐的完整实现方案:

<?php $api_key = 'YOUR_API_KEY';
$maxDays = 3;
$query = http_build_query([
    'q'     => 'Berlin,DE',
    'cnt'   => $maxDays,
    'units' => 'metric',  // 自动返回摄氏度,无需 -273.15 转换
    'lang'  => 'de',
    'appid' => $api_key
]);

$url = 'https://api.openweathermap.org/data/2.5/forecast/daily?' . $query;
$json = file_get_contents($url);
$data = json_decode($json, true);

if (json_last_error() !== JSON_ERROR_NONE || !isset($data['list'])) {
    die('API 请求失败或响应格式异常');
}

echo '
'; foreach ($data['list'] as $day) { $date = date('l d.m', $day['dt']); // e.g. "Thursday 15.09" $max_temp = round($day['temp']['max'], 1) . '°C'; $min_temp = round($day['temp']['min'], 1) . '°C'; echo ""; } echo '
{$date}: Max: {$max_temp} /Min: {$min_temp}

'; ?>

✅ 关键要点说明:

  • ✅ 使用 forecast/daily 而非 forecast,确保数据按“自然日”聚合;
  • ✅ 设置 units=metric 后,所有温度字段(temp.max/temp.min)直接为摄氏度,无需再减 273.15;
  • ✅ cnt=3 精确控制返回天数(最多16天),避免冗余解析;
  • ⚠️ 注意:forecast/daily 接口虽仍可用,但 OpenWeatherMap 已在文档中建议迁移到 /weather + geocoding + onecall 组合方案(适用于长期项目);若需更长周期或分钟级降水,应评估 onecall(需经纬度);
  • ⚠️ 城市参数建议精简为 'Berlin,DE',重复国家码(如 Berlin,DE,DE)可能引发解析异常;
  • ? 增强健壮性:务必检查 json_decode 结果及 list 键是否存在,避免空响应导致 PHP 警告。

通过以上调整,即可稳定输出符合业务需求的、语义准确的3天日温度预报,代码简洁、逻辑清晰、维护成本低。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

2025.11.26

584

16

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2375

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3942

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1296

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4579

7

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习