Java 集成百度海外天气 API 实现实时气象数据获取

Java 实战

前置准备

1. 注册百度地图开放平台账号，创建服务端应用并获取 AK 密钥。
2. 确认应用已开通天气接口权限（默认免费）。
3. 搭建 Java 项目，引入 HTTP 工具类依赖。

接口定义

为简化流程，避免引入重型 HTTP 客户端，我们使用轻量级工具类封装请求。核心代码如下：

package com.yelang.project.thridinterface;

import com.burukeyou.uniapi.http.annotation.HttpApi;
import com.burukeyou.uniapi.http.annotation.param.QueryPar;
import com.burukeyou.uniapi.http.annotation.request.GetHttpInterface;
import com.burukeyou.uniapi.http.core.response.HttpResponse;

/**
 * 百度海外天气服务
 */
@HttpApi(url = "https://api.map.baidu.com/weather_abroad/v1")
public interface BaiduWeatherAbroadService {

    /**
     * 查询实时天气及预报
     * @param district_id 海外城市行政区划编码
     * @param location 经纬度（经度，纬度）
     * @param ak 开发者密钥
     * @param data_type 请求数据类型
     * @param output 返回格式
     * @param language 语言类型
     * @param coordtype 坐标系类型
     * @return HTTP 响应体
     */
    @GetHttpInterface("/")
    HttpResponse<String> query(@QueryPar("district_id") String district_id,
                               @QueryPar("location") String location,
                               @QueryPar("ak") String ak,
                               @QueryPar("data_type") String data_type,
                               @QueryPar("output") String output,
                               @QueryPar("language") String language,
                               @QueryPar("coordtype") String coordtype);
}

实际调用

封装专属工具类后，通过 JUnit 测试验证功能。我们将 AK 和配置抽离，便于维护。以下演示两种查询方式：

package com.yelang.project.unihttp;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import com.google.gson.Gson;
import com.yelang.project.meteorology.domain.BdWeatherDTO;
import com.yelang.project.meteorology.domain.WeatherInfoDTO;
import com.yelang.project.thridinterface.BaiduWeatherAbroadService;

@SpringBootTest
@RunWith(SpringRunner.class)
public class BaiduWeatherAbroadServiceCase {

    private static final String BAIDU_DEFAULT_AK = "yourak";
    private static final String DATA_TYPE = "all";
    private static final String OUTPUT = "json";
    private static final String LANGUAGE = "cn";
    private static final String COORDTYPE = "wgs84";

    @Autowired
    private BaiduWeatherAbroadService bdWeatherAbroadService;

    /**
     * 根据行政区代号查询外国天气
     */
    @Test
    public void queryBydistrictId() {
        // IRN10001001001 代表德黑兰
        String district_id = "IRN10001001001";
        HttpResponse<String> result = bdWeatherAbroadService.query(
                district_id, null, BAIDU_DEFAULT_AK, DATA_TYPE, OUTPUT, LANGUAGE, COORDTYPE);
        
        System.out.println(result.getBodyResult());
        Gson gson = new Gson();
        BdWeatherDTO bdWeatherInfo = gson.fromJson(result.getBodyResult(), BdWeatherDTO.class);
        WeatherInfoDTO bdResult = bdWeatherInfo.getResult();
        
        System.out.println(bdResult.getWeatherNow());
        System.out.println(bdResult.getAlerts());
        System.out.println(bdResult.getIndexes());
        System.out.println(bdResult.getForecasts());
        System.out.println(bdResult.getForecastHours());
    }

    /**
     * 根据经纬度查外国天气
     */
    @Test
    public void queryLocation() {
        // 耶路撒冷坐标示例
        String location = "35.03705894,31.73021175";
        HttpResponse<String> result = bdWeatherAbroadService.query(
                null, location, BAIDU_DEFAULT_AK, DATA_TYPE, OUTPUT, LANGUAGE, COORDTYPE);
        
        System.out.println(result.getBodyResult());
        Gson gson = new Gson();
        BdWeatherDTO bdWeatherInfo = gson.fromJson(result.getBodyResult(), BdWeatherDTO.class);
        WeatherInfoDTO bdResult = bdWeatherInfo.getResult();
        
        System.out.println(bdResult.getWeatherNow());
        System.out.println(bdResult.getAlerts());
        System.out.println(bdResult.getIndexes());
        System.out.println(bdResult.getForecasts());
        System.out.println(bdResult.getForecastHours());
    }
}

成果展示

按编码检索

此方式适合固定城市配置化查询。只需提前获取目标城市的 district_id，即可快速获取精准数据。例如伊朗首都德黑兰，传入编码 IRN10001001001，控制台可返回城市名称、实时气温、湿度、风向等完整信息，无乱码、无缺失，适配后台定时同步。

按经纬度检索

GIS 地理信息系统和全球点位监控场景常需基于坐标查询。无需知晓城市名称，直接传入经纬度，接口会自动匹配所属城市。例如耶路撒冷（35.03705894,31.73021175），接口能快速定位并返回对应气象数据，完美适配地图点位叠加、跨境设备监控等需求。

总结

核心技术亮点

• 零依赖轻量实现：全程 JDK 原生代码配合轻量 HTTP 工具，兼容普通 Java 项目及 SpringBoot/SpringMvc 系统，无侵入性。
• 双查询模式全覆盖：支持行政区编码和经纬度坐标，兼顾普通业务与 GIS 专业场景。
• 低成本高稳定性：依托百度免费接口，额度充足，国内访问稳定，延迟低。

开发注意事项

• AK 密钥建议通过配置文件注入，避免硬编码。
• 海外城市行政区编码需通过官方渠道查询以确保准确。
• 经纬度坐标格式严格遵循'英文逗号分隔、无空格'规范。

这套方案平衡了开发成本与实用性，解决了跨境业务中海外气象数据获取的核心痛点，可直接落地于实际项目中。