一、前言

1.1 業(yè)務(wù)背景

隨著互聯(lián)網(wǎng)全球化、跨境業(yè)務(wù)常態(tài)化以及GIS地理信息系統(tǒng)的廣泛普及，海外城市實(shí)時(shí)氣象數(shù)據(jù)早已不再是單純的民生查詢需求，而是成為眾多后端業(yè)務(wù)系統(tǒng)、物聯(lián)網(wǎng)平臺(tái)、跨境服務(wù)應(yīng)用的核心基礎(chǔ)數(shù)據(jù)支撐，應(yīng)用場(chǎng)景覆蓋各行各業(yè)，剛需屬性極強(qiáng)。在跨境文旅與出行服務(wù)領(lǐng)域，海外出行APP、國(guó)際機(jī)票酒店預(yù)訂平臺(tái)，需要實(shí)時(shí)展示目的地城市的天氣狀況，幫助用戶規(guī)劃行程、規(guī)避惡劣天氣，提升用戶體驗(yàn)與平臺(tái)實(shí)用性；在國(guó)際物流與跨境電商場(chǎng)景中，物流調(diào)度系統(tǒng)、海外倉(cāng)儲(chǔ)管理平臺(tái)，需要依托海外天氣數(shù)據(jù)預(yù)判運(yùn)輸延誤、調(diào)整配送方案，保障跨境貨物運(yùn)輸效率；在GIS地理信息與物聯(lián)網(wǎng)行業(yè)，海外站點(diǎn)監(jiān)控、跨境水利監(jiān)測(cè)、全球點(diǎn)位氣象圖層疊加等業(yè)務(wù)，更是離不開(kāi)精準(zhǔn)的經(jīng)緯度對(duì)應(yīng)天氣數(shù)據(jù)，支撐系統(tǒng)實(shí)現(xiàn)時(shí)空數(shù)據(jù)與氣象數(shù)據(jù)的聯(lián)動(dòng)分析。

除此之外，海外留學(xué)服務(wù)平臺(tái)、跨國(guó)企業(yè)辦公系統(tǒng)、戶外跨境作業(yè)設(shè)備監(jiān)控等場(chǎng)景，也都對(duì)穩(wěn)定、免費(fèi)、易接入的海外天氣接口有強(qiáng)烈需求。對(duì)于Java后端開(kāi)發(fā)者而言，快速搭建一套輕量、穩(wěn)定的海外天氣獲取服務(wù)，既能滿足業(yè)務(wù)剛需，也能完善系統(tǒng)的基礎(chǔ)數(shù)據(jù)能力，是極具實(shí)用價(jià)值的技術(shù)落地場(chǎng)景。

1.2 現(xiàn)有服務(wù)的痛點(diǎn)

盡管國(guó)內(nèi)天氣接口資源豐富，但放眼海外氣象數(shù)據(jù)獲取領(lǐng)域，市面上的服務(wù)普遍存在諸多短板，導(dǎo)致開(kāi)發(fā)者在實(shí)際開(kāi)發(fā)中屢屢受阻，具體痛點(diǎn)主要集中在以下幾點(diǎn)：

• 服務(wù)覆蓋范圍受限：絕大多數(shù)免費(fèi)國(guó)內(nèi)天氣接口，僅支持國(guó)內(nèi)城市數(shù)據(jù)查詢，完全不覆蓋海外地區(qū)，無(wú)法滿足跨境業(yè)務(wù)的基礎(chǔ)需求；少數(shù)支持海外的接口，也僅覆蓋部分主流城市，小眾海外城市、偏遠(yuǎn)地區(qū)數(shù)據(jù)缺失嚴(yán)重。
• 成本與門檻過(guò)高：專業(yè)海外氣象商業(yè)接口，要么收費(fèi)高昂、按調(diào)用次數(shù)計(jì)費(fèi)，中小企業(yè)和個(gè)人開(kāi)發(fā)者難以承擔(dān)；要么需要企業(yè)資質(zhì)認(rèn)證、簽約審核，個(gè)人項(xiàng)目根本無(wú)法接入，開(kāi)發(fā)成本和準(zhǔn)入門檻雙高。
• 接口集成難度大：部分海外開(kāi)源氣象接口，協(xié)議復(fù)雜、鑒權(quán)繁瑣，部分接口還存在地域訪問(wèn)限制、國(guó)內(nèi)調(diào)用延遲高、數(shù)據(jù)格式不規(guī)范等問(wèn)題，Java后端集成需要額外處理網(wǎng)絡(luò)、編碼、異常等諸多問(wèn)題，開(kāi)發(fā)效率極低。
• 適配場(chǎng)景單一：現(xiàn)有接口大多僅支持城市名稱查詢，不支持GIS場(chǎng)景常用的經(jīng)緯度檢索，無(wú)法適配地理信息系統(tǒng)、全球點(diǎn)位監(jiān)控等專業(yè)化需求，實(shí)用性大打折扣。

針對(duì)以上痛點(diǎn)，本文選擇百度地圖開(kāi)放平臺(tái)海外天氣API作為數(shù)據(jù)來(lái)源，結(jié)合Java原生開(kāi)發(fā)，打造一套零額外依賴、輕量易集成、支持雙模式查詢的海外天氣獲取工具，免費(fèi)額度充足，接入流程簡(jiǎn)單，解決個(gè)人開(kāi)發(fā)者與中小企業(yè)的海外天氣數(shù)據(jù)獲取難題。

二、百度海外天氣API

2.1 API信息與請(qǐng)求參數(shù)

百度海外天氣API屬于百度地圖開(kāi)放平臺(tái)，采用HTTPS協(xié)議，支持GET請(qǐng)求方式，接口穩(wěn)定、響應(yīng)速度快，訪問(wèn)無(wú)延遲，核心支持海外城市行政區(qū)編碼和經(jīng)緯度坐標(biāo)兩種查詢方式，適配不同業(yè)務(wù)場(chǎng)景。關(guān)于百度天氣服務(wù)在之前的內(nèi)容中也曾經(jīng)重點(diǎn)詳細(xì)的講解過(guò)。

注意：如果district_id和location同時(shí)傳，默認(rèn)以district_id為準(zhǔn)；

2.2 返回參數(shù)解析

接口請(qǐng)求成功后返回標(biāo)準(zhǔn)JSON格式數(shù)據(jù)，核心返回字段清晰易懂，無(wú)需復(fù)雜解析，關(guān)鍵參數(shù)分為三大模塊：

• 狀態(tài)標(biāo)識(shí)：status字段，0表示請(qǐng)求成功，非0為對(duì)應(yīng)錯(cuò)誤碼，方便快速判斷接口調(diào)用結(jié)果；
• 位置信息：result.location下包含城市名稱、國(guó)家、經(jīng)緯度、行政區(qū)劃編碼等基礎(chǔ)地理信息，確認(rèn)查詢目標(biāo)準(zhǔn)確性；
• 實(shí)時(shí)天氣數(shù)據(jù)：result.now為核心業(yè)務(wù)數(shù)據(jù)，包含實(shí)時(shí)溫度、體感溫度、濕度、風(fēng)向、風(fēng)力、天氣現(xiàn)象（晴、雨、雪等）、氣壓等完整氣象數(shù)據(jù)；
• 更新時(shí)間：result.update_time標(biāo)記氣象數(shù)據(jù)的最新更新時(shí)間，確保數(shù)據(jù)時(shí)效性。

關(guān)于天氣的返回參數(shù)，見(jiàn)：GSON 框架下百度天氣 JSON 數(shù)據(jù)轉(zhuǎn) JavaBean 的實(shí)戰(zhàn)攻略。

三、Java實(shí)戰(zhàn)

3.1 前置準(zhǔn)備工作

注冊(cè)百度地圖開(kāi)放平臺(tái)賬號(hào)，進(jìn)入控制臺(tái)創(chuàng)建應(yīng)用，選擇服務(wù)端應(yīng)用類型，獲取AK密鑰；

確認(rèn)應(yīng)用開(kāi)通天氣接口權(quán)限（免費(fèi)默認(rèn)開(kāi)通）；

搭建基礎(chǔ)Java項(xiàng)目，引入U(xiǎn)niHttp依賴，SpringBoot項(xiàng)目也可直接復(fù)用。

3.2 UniHttp接口定義

為了簡(jiǎn)化HTTP請(qǐng)求流程，避免引入HttpClient、OkHttp等第三方依賴，本文使用UniHttp工具類，實(shí)現(xiàn)GET請(qǐng)求功能，代碼簡(jiǎn)潔、無(wú)冗余，適配所有Java項(xiàng)目，兼容性極強(qiáng)。核心代碼如下：

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;
/**
 * -百度海外天氣服務(wù)
 * @author 夜郎king
 */
@HttpApi(url = "https://api.map.baidu.com/weather_abroad/v1")
public interface BaiduWeatherAbroadService {
	/**
	 * -通過(guò)行政區(qū)劃代碼查詢實(shí)時(shí)天氣信息及未來(lái)7天天氣預(yù)報(bào)。（注意：如果district_id和location同時(shí)傳，默認(rèn)以district_id為準(zhǔn)；）
	 * @param district_id 海外城市行政區(qū)劃編碼海外城市行政區(qū)劃編碼為自定義，只支持海外天氣查詢服務(wù)使用），和location二選一
	 * @param location 經(jīng)緯度，經(jīng)度在前緯度在后，逗號(hào)分隔。支持類型：bd09mc/bd09ll/wgs84/gcj02。這里官網(wǎng)定義的數(shù)據(jù)類型為Double，應(yīng)該是標(biāo)注有誤
	 * @param ak 開(kāi)發(fā)者密鑰
	 * @param data_type 請(qǐng)求數(shù)據(jù)類型。類型有：now/fc/index/alert/fc_hour/all，控制返回內(nèi)容
	 * @param output 返回格式，目前支持json/xml
	 * @param language 語(yǔ)言類型。語(yǔ)言類型有: cn/en，分別表示中文和英文， 默認(rèn)中文。
	 * @param coordtype 支持類型:wgs84/bd09ll/bd09mc/gcj02
	 * @return
	 */
	@GetHttpInterface("/")
	public 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);

}

3.3 實(shí)際調(diào)用

封裝專屬天氣查詢工具類，整合兩種查詢方式，將AK和接口地址抽離為演示示例，便于后期維護(hù)，代碼結(jié)構(gòu)清晰，直接調(diào)用對(duì)應(yīng)方法即可獲取海外天氣數(shù)據(jù)，新手也能快速上手。這里使用Junit的測(cè)試集成方式進(jìn)行演示。核心代碼如下：

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.burukeyou.uniapi.http.core.response.HttpResponse;
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;
/**
 * - 百度海外天氣測(cè)試類
 * @author 夜郎king
 *
 */
@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;
	
	/**
	 * - 根據(jù)行政區(qū)代號(hào)查詢外國(guó)天氣
	 */
	@Test
	public void queryBydistrictId() {
		String district_id = "IRN10001001001";//表示具體的國(guó)家行政代號(hào)，見(jiàn)百度的海外城市信息,這里代表德黑蘭
		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());
	}
	/**
	 * - 根據(jù)經(jīng)緯度查外國(guó)天氣
	 */
	@Test
	public void queryLocation() {
		String location = "35.03705894,31.73021175";//表示具體的國(guó)家行政代號(hào)，見(jiàn)百度的海外城市信息,這里代表以色列
		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());
	} 
}

四、成果展示

4.1 按編碼檢索

該查詢方式適合固定海外城市、業(yè)務(wù)系統(tǒng)配置化查詢場(chǎng)景，只需提前獲取目標(biāo)海外城市的district_id，傳入方法即可快速獲取精準(zhǔn)天氣數(shù)據(jù)，數(shù)據(jù)穩(wěn)定無(wú)延遲。海外城市的行政區(qū)劃id百度提供了完整的列表，大家下載到本地即可，這里以伊朗首都德黑蘭為例，在Excel表格中查找到具體的區(qū)劃編碼，如下：

測(cè)試效果：傳入對(duì)應(yīng)行政區(qū)編碼：IRN10001001001，控制臺(tái)成功返回城市名稱、實(shí)時(shí)氣溫、濕度、風(fēng)向、天氣狀況、數(shù)據(jù)更新時(shí)間等完整信息，數(shù)據(jù)精準(zhǔn)匹配當(dāng)?shù)貙?shí)時(shí)氣象，無(wú)亂碼、無(wú)數(shù)據(jù)缺失，適配后臺(tái)定時(shí)同步、固定城市天氣展示等業(yè)務(wù)。

4.2 按經(jīng)緯度檢索

海外天氣服務(wù)除了支持按照行政區(qū)劃來(lái)查詢外，還支持按照經(jīng)緯度來(lái)進(jìn)行查詢。該模式是GIS地理信息系統(tǒng)、全球點(diǎn)位監(jiān)控場(chǎng)景的核心適配方式，無(wú)需提前知曉城市名稱，只需傳入目標(biāo)點(diǎn)位的經(jīng)緯度坐標(biāo)，接口會(huì)自動(dòng)匹配所屬海外城市，返回對(duì)應(yīng)實(shí)時(shí)天氣數(shù)據(jù)。這里以耶路撒冷為例：

測(cè)試效果：傳入耶路撒冷經(jīng)緯度坐標(biāo)（35.03705894,31.73021175），接口快速定位對(duì)應(yīng)城市，返回完整氣象數(shù)據(jù)，完美適配地圖點(diǎn)位氣象疊加、跨境設(shè)備監(jiān)控、戶外作業(yè)預(yù)警等專業(yè)化需求，解決了傳統(tǒng)接口不支持GIS坐標(biāo)查詢的痛點(diǎn)，實(shí)用性拉滿。

五、總結(jié)

以上就是本文的主要內(nèi)容。本篇實(shí)戰(zhàn)文章圍繞Java后端開(kāi)發(fā)者的實(shí)際業(yè)務(wù)痛點(diǎn)，完整落地了基于百度天氣API的海外城市實(shí)時(shí)天氣獲取功能，從業(yè)務(wù)背景分析、接口講解、代碼封裝到成果驗(yàn)證，全程覆蓋開(kāi)發(fā)全流程，代碼可直接復(fù)制運(yùn)行。

5.1 核心技術(shù)亮點(diǎn)總結(jié)

• 零依賴輕量實(shí)現(xiàn)：全程采用JDK原生代碼開(kāi)發(fā)，未引入任何第三方框架和依賴包，無(wú)論是普通Java項(xiàng)目、SpringBoot/SpringMvc項(xiàng)目，還是老舊Java后端系統(tǒng)，都能無(wú)縫接入、直接復(fù)用，兼容性拉滿，不會(huì)對(duì)原有項(xiàng)目造成任何侵入。
• 雙查詢模式全覆蓋：同時(shí)支持海外城市行政區(qū)編碼和經(jīng)緯度坐標(biāo)查詢，兼顧普通業(yè)務(wù)系統(tǒng)和GIS地理信息專業(yè)場(chǎng)景，解決了市面上大部分接口場(chǎng)景單一的短板，適用范圍極廣。
• 低成本高穩(wěn)定性：依托百度地圖開(kāi)放平臺(tái)免費(fèi)接口，個(gè)人開(kāi)發(fā)者和中小企業(yè)均可免費(fèi)使用，免費(fèi)調(diào)用額度完全滿足日常開(kāi)發(fā)和小規(guī)模業(yè)務(wù)需求，規(guī)避商業(yè)接口高額成本；接口國(guó)內(nèi)訪問(wèn)穩(wěn)定、延遲低，數(shù)據(jù)實(shí)時(shí)性強(qiáng)，無(wú)地域訪問(wèn)限制。

5.2 開(kāi)發(fā)注意事項(xiàng)

• 百度AK密鑰需妥善保管，建議在項(xiàng)目中通過(guò)配置文件注入，不要硬編碼到工具類中；
• 海外城市行政區(qū)編碼需通過(guò)百度地圖開(kāi)放平臺(tái)官方渠道查詢，確保編碼準(zhǔn)確，避免查詢失敗；
• 經(jīng)緯度坐標(biāo)格式需嚴(yán)格遵循“英文逗號(hào)分隔、無(wú)空格”規(guī)范，防止格式錯(cuò)誤導(dǎo)致接口調(diào)用失敗。

整體而言，這套Java海外天氣獲取方案，完美平衡了開(kāi)發(fā)成本、接入難度和實(shí)用性，精準(zhǔn)解決了跨境業(yè)務(wù)、GIS系統(tǒng)中海外氣象數(shù)據(jù)獲取的核心痛點(diǎn)，非常適合Java后端新手學(xué)習(xí)實(shí)戰(zhàn)，也能直接落地到實(shí)際項(xiàng)目中，是一款高效實(shí)用的后端工具類實(shí)現(xiàn)。

以上就是Java基于百度天氣API實(shí)現(xiàn)天氣實(shí)時(shí)獲取的詳細(xì)內(nèi)容，更多關(guān)于Java實(shí)時(shí)獲取天氣的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！