利用Openfeign远程调用第三方接口（案例：百度地图逆地理编码接口，实现通过经纬度坐标获取详细地址）

1、注册百度地图账号

https://lbsyun.baidu.com/apiconsole/key

获取AK(COPY出来，以后要用)

查看百度地图逆地理解析接口文档：

PI服务地址
https://api.map.baidu.com/reverse_geocoding/v3/?ak=您的ak&extensions_poi=1&entire_poi=1&sort_strategy=distance&output=json&coordtype=bd09ll&location=39.951335108535, 116.51484487905
//GET请求

请求地址:

get: https://api.map.baidu.com/reverse_geocoding/v3/

请求参数如下：

参数说明：

ak：百度地图 API Key（需要自己申请）

output：输出格式（json/xml）

extensions_poi 是一个 扩展参数，用于返回周边的 POI（兴趣点，Points of Interest） 信息，例如餐馆、商店、学校等。

location：经纬度（格式 lat,lng）

2、编写代码

2.1、添加openfeign依赖

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

2.2、主启动类加注解@EnableFeignClients

@EnableFeignClients
//@EnableDiscoveryClient //核心注解
@SpringBootApplication
public class OrderMainApplication {

    public static void main(String[] args) {
        SpringApplication.run(OrderMainApplication.class, args);
    }
}

2.3、写远程调用的OpenFeign接口

package com.tigerhhzz.order.openfeign;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * @Author tigerhhzz
 * @Date 2025 03 25 13 00
 **/
@FeignClient(value = "baidumap-client",url = "http://api.map.baidu.com")
public interface BaiduMapOpenfeign {

    @GetMapping("/reverse_geocoding/v3")
    String getLocationByLonLat(@RequestParam String ak, @RequestParam String output, @RequestParam String extensionsPoi, @RequestParam String location);

}

3、测试&响应结果

package com.tigerhhzz.order;

import com.tigerhhzz.order.openfeign.BaiduMapOpenfeign;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

/**
 * @Author tigerhhzz
 * @Date 2025 03 25 13 07
 **/
@SpringBootTest
public class BaidumapTest {

    @Autowired
    BaiduMapOpenfeign baiduMapOpenfeign;

    @Test
    void test01(){
        String location = baiduMapOpenfeign.getLocationByLonLat("PRyu1SQEdG4rihxxxxxxS8NIcsc", "json", "1", "31.225696563611,121.49884033194");
        System.out.println(location);
    }
}

响应结果（包含 POI 信息）：

{
	"status": 0,
	"result": {
		"location": {
			"lng": 121.49884033193993,
			"lat": 31.225696429417988
		},
		"formatted_address": "上海市黄浦区净土街31弄-4号",
		"edz": {
			"name": "陆家嘴金融贸易区"
		},
		"business": "老西门,城隍庙,西藏南路",
		"business_info": [
			{
				"name": "老西门",
				"location": {
					"lng": 121.49270784559798,
					"lat": 31.22284211295233
				},
				"adcode": 310101,
				"distance": 0,
				"direction": "内"
			},
			{
				"name": "城隍庙",
				"location": {
					"lng": 121.49754405297205,
					"lat": 31.231853482990294
				},
				"adcode": 310101,
				"distance": 394,
				"direction": "南"
			},
			{
				"name": "西藏南路",
				"location": {
					"lng": 121.49155262471214,
					"lat": 31.219955867050826
				},
				"adcode": 310101,
				"distance": 629,
				"direction": "东北"
			}
		],
		"addressComponent": {
			"country": "中国",
			"country_code": 0,
			"country_code_iso": "CHN",
			"country_code_iso2": "CN",
			"province": "上海市",
			"city": "上海市",
			"city_level": 2,
			"district": "黄浦区",
			"town": "老西门街道",
			"town_code": "310101019",
			"distance": "58",
			"direction": "北",
			"adcode": "310101",
			"street": "净土街",
			"street_number": "31弄-4号"
		},
		"pois": [],
		"roads": [],
		"poiRegions": [],
		"sematic_description": "",
		"formatted_address_poi": "",
		"cityCode": 289
	}
}

formatted_address：地址信息

pois：POI 兴趣点列表

name：兴趣点名称

addr：兴趣点地址

point：兴趣点坐标

distance：距离查询点的距离（单位：米）

tag：类别（如景点、商场、餐厅等）

4、添加feign日志&注意事项

4.1、添加日志

在配置文件application.yml中添加：

logging:
  level:
    com.tigerhhzz.order.openfeign: debug

然后新建如下配置类：

package com.tigerhhzz.order.config;

import feign.Logger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;


@Configuration
public class OrderServiceConfig {


    @Bean
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }

    @Bean
    Logger.Level feignLoggerLevel(){
        return Logger.Level.FULL;
    }
}

日志输出：

4.2、注意事项

在百度地图控制台，相应的api接口中加上发送请求主机的ip白名单；否则会提示如下检验失败的信息：

真正的强大不是忘记，而是接受