彩云API参考链接：https://docs.caiyunapp.com/weather-api/v2/v2.6/1-realtime.html
本文为token版本，若需要Appkey&AppSecret认证版本请参考V3API认证与鉴权
一、引入 Maven 依赖
<!-- httpclient --> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.14</version> </dependency> <!-- json 解析 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.83</version> </dependency>二、完整 Java 代码
import com.alibaba.fastjson.JSONObject; import org.apache.http.HttpEntity; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import java.io.IOException; /** * 彩云天气 HttpClient 调用完整示例 * 官方文档：https://open.caiyunapp.com/ */ public class CaiYunWeatherDemo { // 1. 替换为你自己的 彩云天气 Token private static final String TOKEN = "你的彩云天气token"; /** * 调用彩云天气接口 获取实时天气 * @param longitude 经度 * @param latitude 纬度 * @return 天气json结果 */ public static String getWeather(double longitude, double latitude) { // 接口地址：实时天气 String url = String.format( "https://api.caiyunapp.com/v2.5/%s/%.6f,%.6f/realtime", TOKEN, longitude, latitude ); // 创建HttpClient try (CloseableHttpClient httpClient = HttpClients.createDefault()) { HttpGet httpGet = new HttpGet(url); // 设置请求头 httpGet.addHeader("Content-Type", "application/json;charset=UTF-8"); // 执行请求 try (CloseableHttpResponse response = httpClient.execute(httpGet)) { HttpEntity entity = response.getEntity(); if (entity != null) { // 读取响应内容 return EntityUtils.toString(entity, "UTF-8"); } } } catch (IOException e) { e.printStackTrace(); } return null; } public static void main(String[] args) { // 示例：北京 经纬度 double lon = 116.403874; double lat = 39.914885; // 调用接口 String result = getWeather(lon, lat); System.out.println("原始返回结果："); System.out.println(result); // 解析JSON if (result != null) { JSONObject json = JSONObject.parseObject(result); JSONObject realtime = json.getJSONObject("result").getJSONObject("realtime"); // 取出关键天气字段 String sky = realtime.getString("sky"); // 天气状况 double temp = realtime.getDouble("temperature");// 温度 double humidity = realtime.getDouble("humidity");// 湿度 System.out.println("\n===== 天气解析结果 ====="); System.out.println("天气：" + sky); System.out.println("温度：" + temp + " ℃"); System.out.println("湿度：" + humidity); } } }三、关键说明
获取 Token去彩云天气官网注册账号，申请开发者
token，替换代码中接口说明
- 实时天气：
/v2.6/token/经度,纬度/realtime - 逐日 / 小时预报、空气质量 可自行改接口路径
- 实时天气：
资源自动关闭使用
try-with-resources自动关闭HttpClient、Response，避免连接泄漏异常处理捕获 IO 异常，适合项目生产使用
四、拓展：POST 请求 / 带超时配置
如果需要设置超时，替换创建 Client 代码：
import org.apache.http.client.config.RequestConfig; RequestConfig config = RequestConfig.custom() .setConnectTimeout(5000) // 连接超时 .setSocketTimeout(10000) // 读取超时 .build(); CloseableHttpClient httpClient = HttpClients.custom() .setDefaultRequestConfig(config) .build();
