SpringBoot整合高德地圖天氣查詢的全過程

更新時(shí)間：2021年12月15日 10:30:38 作者：DY丶老周

這篇文章主要給大家介紹了關(guān)于SpringBoot整合高德地圖天氣查詢的相關(guān)資料,文中通過圖文介紹的非常詳細(xì),對大家學(xué)習(xí)或者使用springboot具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下

申請key

登錄高德，注冊，添加應(yīng)用，創(chuàng)建key

官網(wǎng)api：

https://lbs.amap.com/api/webservice/guide/api/weatherinfo

調(diào)用步驟:

第一步，申請”web服務(wù) API”密鑰（Key）；

第二步，拼接HTTP請求URL，第一步申請的Key需作為必填參數(shù)一同發(fā)送；

第三步，接收HTTP請求返回的數(shù)據(jù)（JSON或XML格式），解析數(shù)據(jù)。

如無特殊聲明，接口的輸入?yún)?shù)和輸出數(shù)據(jù)編碼全部統(tǒng)一為UTF-8。

最主要的也是獲取到key

相關(guān)代碼

pom.xml

<!--httpclient-->
        <dependency>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpclient</artifactId>
            <version>4.4</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.78</version>
        </dependency>

        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.4</version>
        </dependency>

application.properties

server.port=2080

#The config for HttpClient
http.maxTotal=300
http.defaultMaxPerRoute=50
http.connectTimeout=1000
http.connectionRequestTimeout=500
http.socketTimeout=5000
http.staleConnectionCheckEnabled=true


gaode.key = 申請的key

HttpClientConfig

package com.zjy.map.config;

import lombok.Data;
import org.apache.http.client.HttpClient;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.conn.HttpClientConnectionManager;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.ClientHttpRequestFactory;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.StringHttpMessageConverter;
import org.springframework.web.client.RestTemplate;

import java.nio.charset.Charset;
import java.util.List;

@Data
@Configuration
@ConfigurationProperties(prefix = "http", ignoreUnknownFields = true)
public class HttpClientConfig {

    private Integer maxTotal;// 最大連接

    private Integer defaultMaxPerRoute;// 每個(gè)host的最大連接

    private Integer connectTimeout;// 連接超時(shí)時(shí)間

    private Integer connectionRequestTimeout;// 請求超時(shí)時(shí)間

    private Integer socketTimeout;// 響應(yīng)超時(shí)時(shí)間

    /**
     * HttpClient連接池
     * @return
     */
    @Bean
    public HttpClientConnectionManager httpClientConnectionManager() {
        PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager();
        connectionManager.setMaxTotal(maxTotal);
        connectionManager.setDefaultMaxPerRoute(defaultMaxPerRoute);
        return connectionManager;
    }

    /**
     * 注冊RequestConfig
     * @return
     */
    @Bean
    public RequestConfig requestConfig() {
        return RequestConfig.custom().setConnectTimeout(connectTimeout)
                .setConnectionRequestTimeout(connectionRequestTimeout).setSocketTimeout(socketTimeout)
                .build();
    }

    /**
     * 注冊HttpClient
     * @param manager
     * @param config
     * @return
     */
    @Bean
    public HttpClient httpClient(HttpClientConnectionManager manager, RequestConfig config) {
        return HttpClientBuilder.create().setConnectionManager(manager).setDefaultRequestConfig(config)
                .build();
    }

    @Bean
    public ClientHttpRequestFactory requestFactory(HttpClient httpClient) {
        return new HttpComponentsClientHttpRequestFactory(httpClient);
    }
    /**
     * 使用HttpClient來初始化一個(gè)RestTemplate
     * @param requestFactory
     * @return
     */
    @Bean
    public RestTemplate restTemplate(ClientHttpRequestFactory requestFactory) {
        RestTemplate template = new RestTemplate(requestFactory);

        List<HttpMessageConverter<?>> list = template.getMessageConverters();
        for (HttpMessageConverter<?> mc : list) {
            if (mc instanceof StringHttpMessageConverter) {
                ((StringHttpMessageConverter) mc).setDefaultCharset(Charset.forName("UTF-8"));
            }
        }
        return template;
    }
}

WeatherUtils

package com.zjy.map.utils;

import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

import java.net.URI;
import java.util.Map;

@Component
public class WeatherUtils {

    /**日志對象*/
    private static final Logger logger = LoggerFactory.getLogger(WeatherUtils.class);

    @Value("${gaode.key}")
    private String KEY;

    public final String WEATHER_URL = "https://restapi.amap.com/v3/weather/weatherInfo?";

    /**
     * 發(fā)送get請求
     * @return
     */
    public JSONObject getCurrent(Map<String, String> params){

        JSONObject jsonObject = null;
        CloseableHttpClient httpclient = HttpClients.createDefault();

        // 創(chuàng)建URI對象，并且設(shè)置請求參數(shù)
        try {
            URI uri = getBuilderCurrent(WEATHER_URL, params);
            // 創(chuàng)建http GET請求
            HttpGet httpGet = new HttpGet(uri);
            CloseableHttpResponse response = httpclient.execute(httpGet);

            // 判斷返回狀態(tài)是否為200
            jsonObject = getRouteCurrent(response);
            httpclient.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

        return jsonObject;
    }

    /**
     * 根據(jù)不同的路徑規(guī)劃獲取距離
     * @param response
     * @return
     */
    private static JSONObject getRouteCurrent(CloseableHttpResponse response) throws Exception{
        JSONObject live = null;
        // 判斷返回狀態(tài)是否為200
        if (response.getStatusLine().getStatusCode() == 200) {
            String content = EntityUtils.toString(response.getEntity(), "UTF-8");
            logger.info("調(diào)用高德地圖接口返回的結(jié)果為:{}",content);
            JSONObject jsonObject = (JSONObject) JSONObject.parse(content);
            JSONArray lives = (JSONArray) jsonObject.get("lives");
            live = (JSONObject) lives.get(0);

            logger.info("返回的結(jié)果為:{}",JSONObject.toJSONString(live));
        }
        return live;
    }

    /**
     * 封裝URI
     * @param url
     * @param params
     * @return
     * @throws Exception
     */
    private URI getBuilderCurrent(String url, Map<String, String> params) throws Exception{
        // 城市編碼，高德地圖提供
        String adcode = params.get("adcode");

        URIBuilder uriBuilder = new URIBuilder(url);
        // 公共參數(shù)
        uriBuilder.setParameter("key", KEY);
        uriBuilder.setParameter("city", adcode);

        logger.info("請求的參數(shù)key為:{}, cityCode為:{}", KEY, adcode);
        URI uri = uriBuilder.build();
        return uri;
    }

    /**
     * 查詢未來的
     * 發(fā)送get請求
     * @return
     */
    public JSONObject sendGetFuture(Map<String, String> params){

        JSONObject jsonObject = null;
        CloseableHttpClient httpclient = HttpClients.createDefault();

        // 創(chuàng)建URI對象，并且設(shè)置請求參數(shù)
        try {
            URI uri = getBuilderFuture(WEATHER_URL, params);
            // 創(chuàng)建http GET請求
            HttpGet httpGet = new HttpGet(uri);
            CloseableHttpResponse response = httpclient.execute(httpGet);

            // 判斷返回狀態(tài)是否為200
            jsonObject = getRouteFuture(response);
            httpclient.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

        return jsonObject;
    }

    /**
     * 封裝URI
     * @param url
     * @param params
     * @return
     * @throws Exception
     */
    private URI getBuilderFuture(String url, Map<String, String> params) throws Exception{
        // 城市編碼，高德地圖提供
        String adcode = params.get("adcode");

        URIBuilder uriBuilder = new URIBuilder(url);
        // 公共參數(shù)
        uriBuilder.setParameter("key", KEY);
        uriBuilder.setParameter("city", adcode);
        uriBuilder.setParameter("extensions", "all");

        logger.info("請求的參數(shù)key為:{}, cityCode為:{}", KEY, adcode);
        URI uri = uriBuilder.build();
        return uri;
    }

    /**
     * 根據(jù)不同的路徑規(guī)劃獲取距離
     * @param response
     * @return
     */
    private static JSONObject getRouteFuture(CloseableHttpResponse response) throws Exception{
        JSONObject live = null;
        // 判斷返回狀態(tài)是否為200
        if (response.getStatusLine().getStatusCode() == 200) {
            String content = EntityUtils.toString(response.getEntity(), "UTF-8");
            logger.info("調(diào)用高德地圖接口返回的結(jié)果為:{}",content);
            JSONObject jsonObject = (JSONObject) JSONObject.parse(content);
            JSONArray forecast = (JSONArray) jsonObject.get("forecasts");
            live = (JSONObject) forecast.get(0);

            logger.info("返回的結(jié)果為:{}",JSONObject.toJSONString(live));
        }
        return live;
    }
}

WeatherController

package com.zjy.map.controller;

import com.alibaba.fastjson.JSONObject;
import com.zjy.map.utils.WeatherUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;

/**
 * 高德天氣
 */
@RestController
@RequestMapping("/weather")
public class WeatherController {

    @Autowired
    private WeatherUtils weatherUtils;

    /**日志對象*/
    private static final Logger logger = LoggerFactory.getLogger(WeatherController.class);

    /**
     * http://localhost:2080/weather/getCurrent?adcode=140200
     * 獲取當(dāng)前的天氣預(yù)報(bào)
     * @param adcode
     * @return
     */
    @GetMapping("/getCurrent")
    public JSONObject getWeather(@RequestParam String adcode){

        Map<String, String> params = new HashMap<>();
        params.put("adcode", adcode);
        logger.info("獲取當(dāng)前的天氣預(yù)報(bào),請求的參數(shù)為:{}", params);
        JSONObject map = weatherUtils.getCurrent(params);
        logger.info("獲取當(dāng)前的天氣預(yù)報(bào),返回的請求結(jié)果為:{}", map);
        return map;
    }

    /**
     * http://localhost:2080/weather/getFuture?adcode=140200
     * 獲取未來的天氣預(yù)報(bào)
     * @param adcode
     * @return
     */
    @GetMapping("/getFuture")
    public JSONObject getFuture(@RequestParam String adcode){

        Map<String, String> params = new HashMap<>();
        params.put("adcode", adcode);
        logger.info("獲取未來的天氣預(yù)報(bào),請求的參數(shù)為:{}", params);
        JSONObject map = weatherUtils.sendGetFuture(params);
        logger.info("獲取未來的天氣預(yù)報(bào),返回的請求結(jié)果為:{}", map);
        return map;
    }
}

代碼貼完了。開始測試

啟動(dòng)服務(wù)

城市編號

官網(wǎng)提供下載地址：

https://lbs.amap.com/api/webservice/download

這里獲取當(dāng)前時(shí)間的天氣情況與未來天氣情況返回?cái)?shù)據(jù)不一樣，所在寫了2個(gè)方法，參數(shù)只有一個(gè)，城市編碼.

1.獲取當(dāng)前天氣

http://localhost:2080/weather/getCurrent?adcode=140200

2.獲取未來天氣

http://localhost:2080/weather/getFuture?adcode=140200

{
    "province": "山西",
    "casts": [
        {
            "date": "2021-12-13",
            "dayweather": "晴",
            "daywind": "西南",
            "week": "1",
            "daypower": "4",
            "daytemp": "2",
            "nightwind": "西南",
            "nighttemp": "-18",
            "nightweather": "晴",
            "nightpower": "4"
        },
        {
            "date": "2021-12-14",
            "dayweather": "晴",
            "daywind": "西",
            "week": "2",
            "daypower": "≤3",
            "daytemp": "2",
            "nightwind": "西",
            "nighttemp": "-13",
            "nightweather": "晴",
            "nightpower": "≤3"
        },
        {
            "date": "2021-12-15",
            "dayweather": "多云",
            "daywind": "西南",
            "week": "3",
            "daypower": "4",
            "daytemp": "5",
            "nightwind": "西南",
            "nighttemp": "-12",
            "nightweather": "多云",
            "nightpower": "4"
        },
        {
            "date": "2021-12-16",
            "dayweather": "多云",
            "daywind": "西北",
            "week": "4",
            "daypower": "4",
            "daytemp": "-1",
            "nightwind": "西北",
            "nighttemp": "-18",
            "nightweather": "晴",
            "nightpower": "4"
        }
    ],
    "city": "大同市",
    "adcode": "140200",
    "reporttime": "2021-12-13 18:04:08"
}