五一去荣昌吃卤鹅？基于Java和天地图的寻找荣昌卤鹅店实践

目录

前言

1、卤鹅哥与甲亢哥的爆火事件

2、荣昌卤鹅产业的空间分布

3、使用Java 和天地图进行产业挖掘

一、地名检索简介

1、地名检索功能

2、地名检索API介绍

二、荣昌卤鹅检索实践

1、数据获取流程

2、天地图API请求构建

3、参数构建及调用

4、结果生成及本地保存

三、总结

---

前言

1、卤鹅哥与甲亢哥的爆火事件

        最近，重庆荣昌的卤鹅哥林江和美国顶流网红甲亢哥(IShowSpeed)的互动，让荣昌卤鹅成为网红美食。林江作为荣昌的助农主播，为宣传家乡美食，自费开启“五城追星”之旅，在成都、长沙等五座城市向甲亢哥投喂荣昌卤鹅，并用蹩脚英语反复强调“Rongchang Braised Goose”，成功将其推入国际视野。其真诚执着的态度赢得了甲亢哥团队和网友的认可，最终被邀请赴美作客。随着事件的发酵，荣昌卤鹅的网络曝光率暴增 105%，相关企业线上销量迅速增长，部分企业单日销量翻十倍，甚至出现订单爆满暂停接单的情况。卤鹅哥林江也成为了荣昌家喻户晓的人物，他的事迹还登上了微博、抖音等平台的热榜，全网话题阅读量超 5 亿。

2、荣昌卤鹅产业的空间分布

        从生产端来看，荣昌地处重庆西部和四川东部交界的丘陵地带，平均海拔 380 米，全区土壤质地良好，充足的水域、适宜的气候、肥沃的土壤，为荣昌白鹅的养殖提供了优越条件，而荣昌白鹅正是制作荣昌卤鹅的优质食材。目前，荣昌区已建成标准化荣昌鹅养殖示范基地 10 个，荣昌鹅年养殖量达 800 万只。从加工端来看，荣昌已培育卤鹅及配套加工企业 7 家，形成了“公司+合作社+家庭农场+农户”的养殖体系和“中央厨房+区域仓库+社区零售+电商销售”的销售体系。从销售端来看，荣昌卤鹅在线上线下均有销售，线上在各大电商平台活跃，线下则分布在重庆江北国际机场航站楼、成渝高铁站、商场超市等地。此外，荣昌还在城区和一些乡镇形成了卤鹅美食街或集中销售点，如荣昌夏布小镇附近就聚集了多家卤鹅企业进行网络直播带货。

3、使用Java 和天地图进行产业挖掘

        利用 Java 和天地图来挖掘荣昌卤鹅产业具有较高的可行性。首先，Java 是一种功能强大、应用广泛的编程语言，能够为数据处理、分析和应用开发提供强大的技术支持。通过 Java 编写爬虫程序，可以抓取电商平台、社交媒体等网站上的荣昌卤鹅销售数据、用户评价等信息，为产业分析提供数据基础。其次，天地图提供了详细的地理信息数据和地图服务接口，能够帮助我们获取荣昌地区的地理信息，包括卤鹅店的分布、交通路线等。结合 Java 和天地图，可以实现对荣昌卤鹅产业的空间分析，如绘制卤鹅店的分布地图、分析不同区域的销售热度等。此外，还可以开发基于天地图的手机应用程序，为游客提供荣昌卤鹅店的导航、推荐等功能，进一步推动荣昌卤鹅产业的发展。

        五一假期即将来临，相信今年这个五一应该有很多人会选择去荣昌游玩，品尝荣昌卤鹅。对很多外地的游客而言，想吃卤鹅可以在线上平台进行订购。当然，您也可以选择亲自自驾去荣昌品尝。那么怎么在当地找到卤鹅店呢？本人是一名GIS从业者和研究者，虽然这次五一不能去荣昌，但也想为大家把荣昌的卤鹅店找一找，从地理信息的角度帮大家寻找美味。文章首先介绍天地图的检索API，然后详细介绍如何使用Java来调用天地图的API获取所有的卤鹅位置信息，权当为大家做一个参考。

一、地名检索简介

        本节将重点介绍天地图的地名检索API，主要分为两部分。第一部分对地名检索功能进行一个简单的梳理，第二部分是对地名检索API进行一个详细的介绍，尤其是本次需要使用的行政区划的检索。                

1、地名检索功能

        地名搜索服务V2.0是一类简单的HTTP/HTTPS接口，包括普通搜索、视野内搜索、周边搜索、多边形搜索、行政区域搜索、分类搜索、统计搜索。大家可以在天地图的官方API出查找具体的介绍文档， 天地图WEB服务API介绍。

2、地名检索API介绍

        想要查询荣昌的卤鹅店位置，首先需要明确数据查询流程。我们需要采用的是行政区划区域搜索服务。即在指定的行政区划范围内寻找指定的关键词位置信息。因此需要使用的是第一个服务，这里也以第一个服务为例，详细来介绍这个服务。

        输入参数说明：

参数值	参数说明	参数类型	是否必备	备注(值域)
keyWord	搜索的关键字	String	必填	无
specify	指定行政区的国标码(行政区划编码表)严格按照行政区划编码表中的(名称，gb码)	String	必填	下载 行政区划编码表。9位国标码，如：北京：156110000或北京。
queryType	服务查询类型参数	String	必填	12：行政区划区域搜索服务。
start	返回结果起始位(用于分页和缓存)默认0	String	必填	0-300，表示返回结果的起始位置。
count	返回的结果数量(用于分页和缓存)	String	必填	1-300，返回结果的条数。
dataTypes	数据分类(分类编码表)	String	可选	下载 分类编码表，参数可以分类名称或分类编码。多个分类用","隔开(英文逗号)。
show	返回poi结果信息类别	String	可选	取值为1，则返回基本poi信息； 取值为2，则返回详细poi信息

        返回参数说明

参数值			参数说明	参数类型	返回条件	备注(值域)
resultType			返回结果类型	Int	必返回	取值1-5，对应不同的响应类型： 1(普通POI)，2(统计)，3(行政区)，4(建议词搜索)，5(线路结果)
count			返回总条数	Int	必返回
keyword			搜索关键词	String	必返回	搜索的关键字。
pois			针对点(类型1)集合返回	Pois Json数组		resultType=1
	name		Poi点名称	String	必返回
	phone		电话	String
	address		地址	String
	lonlat		坐标	String	必返回	坐标 x，y
	poiType		poi类型	Int	必返回	101:POI数据 102:公交站点
	eaddress		英文地址	String
	ename		poi点英文名称	String
	hotPointID		poi热点ID	String	必返回	热点id
	province		所属省名称	String
	provinceCode		省行政区编码	String
	city		所属城市名称	String
	cityCode		市行政区编码	String
	county		所属区县名称	String
	countyCode		区县行政区编码	String
	source		数据信息来源	String	必返回
	typeCode		分类编码	String
	typeName		分类名称	String
	stationData		车站信息结构体 数据	Json 数组		poiType=102
		lineName	线路名称	String	必返回
		uuid	线路的id	String	必返回
		stationUuid	公交站uuid	String	必返回
statistics			针对统计(类型2)集合返回	Json 数组		resultType=2
	count		本次统计POI总数量	Int	必返回
	adminCount		行政区数量	Int	必返回
	priorityCitys		推荐行政区名称	Json数组	必返回
		name	行政区名称	String	必返回
		count	城市数量	Int	必返回
		lonlat	行政区经纬度	String	必返回	坐标 x，y
		ename	英文行政名称	String	必返回
		adminCode	城市国标码	Int	必返回	9位国标码。
	allAdmins		各省包含信息集合	Json数组	必返回
		name	行政名称	String	必返回
		count	包含数量	Int	必返回
		lonlat	行政区经纬度	String	必返回	坐标x,y
		adminCode	省国标码	String	必返回
		ename	英文行政名称	String	必返回
		isleaf	有无下一级行政区	boolean	必返回	有则false，无则true
area			针对行政区省(类型3)集合点	Json 数组		resultType=3
	name		名称	String	必返回
	bound		定位范围(“minx,miny,maxx,maxy”)	String	返回
	lonlat		定位中心点坐标	String	必返回
	adminCode		行政区编码	Int	必返回
	level		显示级别	Int	必返回	1-18级
lineData			线路结果	Json 数组		resultType=5
	stationNum		站数量	String	必返回
	poiType		类型为“103”	String	必返回
	name		线路名称	String	必返回
	uuid		线路id	String	必返回
status			返回状态信息	Json 数组	必返回	结果提示信息
	infocode		信息码	Int	必返回	服务状态码表
	cndesc		返回中文描述	String	必返回	服务状态码表

        这里需要说明的是，我们预期返回的都是POI数据，因此我们在后续的内容中都是以POI数据为例来展开。这里之所以要把输入参数和输出参数都进行详细的介绍，就是为了后续的信息抓取过程做准备。 这里有一个信息是需要先确定的，就是按照行政区划检索的话，一定要先在天地图上下载行政区划代码，在文档的连接处有详细的连接，点击后即可进行下载。打开文档可以看到如下信息：

        上图红线框中的就是荣昌的行政编码，在接口检索的时候，可以传入行政区划名称或者编码都是可以的。

二、荣昌卤鹅检索实践

        在了解和掌握了天地图的行政区划检索服务之后，本节我们将重点介绍如何在Java中调用天地图的行政区划接口API来检索相应的数据。主要介绍数据的获取流程，然后介绍如何使用Java来构建天地图的API、参数的构建以及实际调用，最后介绍请求的结果生成以及如何将生成结果保存成本地的Excel文档。

1、数据获取流程

        以上就是数据获取的完整流程，第一步是从下载的行政区划中设置待检索的行政区划，这里为荣昌，第二步设置查询关键字,即卤鹅，第三步是构建参数并发送请求， 第四步是将服务器返回的数据转换为Gson，第五步是将List数据转为Excel，第六步将Excel数据回写到本地即可。

2、天地图API请求构建

        首先我们需要在后台创建一个天地图的访问接口文件，关键代码如下：

登录后复制

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 = "http://api.tianditu.gov.cn/")
public interface TdtOptionService {

	@GetHttpInterface("v2/search")
	public HttpResponse<String> searchV2(@QueryPar("postStr") String postStr,@QueryPar("type") String type,@QueryPar("tk") String tk);
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.

        请注意 ：这里我们为了简化相关接口的调用，使用Unihttp来进行接口请求的调用。

3、参数构建及调用

        按照前面介绍过的文档，我们来进行查询参数的构建，这里需要设置的参数有keyWord、specify等，查询参数构建如下：

登录后复制

String keyWord = "卤鹅";
String specify = "156500153";//荣昌区
String excelTitle  = "重庆荣昌卤鹅POI信息列表";
String postStr = "%7B'keyWord':'" + keyWord + "','specify':'" + specify + "','queryType':'12','start':'0','count':'100','show':'2' %7D" ;

• 1.
• 2.
• 3.
• 4.

         然后使用Java来调用天地图的检索接口获取具体的卤鹅位置信息，检索方法如下：

登录后复制

/**
* - 行政区划区域搜索示例
*/
@Test
public void searchByAdminCode() {
	String keyWord = "卤鹅";
	String specify = "156500153";//荣昌区
	String excelTitle  = "重庆荣昌卤鹅POI信息列表";
	String postStr = "%7B'keyWord':'" + keyWord + "','specify':'" + specify + "','queryType':'12','start':'0','count':'100','show':'2' %7D" ;
	HttpResponse<String> resp = tdtOptService.searchV2(postStr,QUERY, TDT_SERVER_KEY);
	Gson gson = new Gson();
	System.out.println(resp.getBodyResult());
	if(StringUtils.isNotEmpty(resp.getBodyResult())) {
		TdtSearchVo tdtSearchVo = gson.fromJson(resp.getBodyResult(), TdtSearchVo.class);
		if(tdtSearchVo.getCount() > 0) {
		// excel工具包
		ExcelUtil<TdtPoi> util = new ExcelUtil<TdtPoi>(TdtPoi.class);
		 	util.exportExcel(tdtSearchVo.getPois(), excelTitle);
		}
	}else {
		System.out.println("内容为空");
	}
	System.out.println("检索并本地化完成");
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.

4、结果生成及本地保存

        为了方便将请求获取的数据转换成Excel，我们首先需要定义个POI的实体类，其属性和方法都严格跟接口中的对象一一对应，关键代码如下：

登录后复制

package com.yelang.project.education.domain.tdt;
import java.io.Serializable;
import com.yelang.framework.aspectj.lang.annotation.Excel;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;
/**
 * -天地图POI对象
 * @author 夜郎king
 */
@Data
@ToString
@AllArgsConstructor
@NoArgsConstructor
public class TdtPoi implements Serializable{
	private static final long serialVersionUID = 7428718362374078869L;
	@Excel(name = "Poi点名称")
	private String name;//Poi点名称
	@Excel(name = "英文地址")
	private String eaddress;//英文地址	
	@Excel(name = "电话")
	private String phone;//电话	
	@Excel(name = "地址")
	private String address;//地址	
	@Excel(name = "所属城市名称")
	private String city;//	所属城市名称
	@Excel(name = "省行政区编码")
	private String provinceCode;//	省行政区编码
	@Excel(name = "市行政区编码")
	private String cityCode;//	市行政区编码	
	@Excel(name = "所属区县名称")
	private String county;//	所属区县名称
	@Excel(name = "区县行政区编码")
	private String countyCode;//	区县行政区编码
	@Excel(name = "分类名称")
	private String typeName;//	分类名称	
	@Excel(name = "数据信息来源")
	private String source;//	数据信息来源
	@Excel(name = "分类编码")
	private String typeCode;//	分类编码	
	@Excel(name = "坐标 x，y")
	private String lonlat;//	坐标		必返回	坐标 x，y
	@Excel(name = "poi点英文名称")
	private String ename;//	poi点英文名称		
	@Excel(name = "所属省名称")
	private String province;//	所属省名称	
	@Excel(name = "poi类型")
	private Integer poiType;//	poi类型	Int	必返回	101:POI数据 102:公交站点
	@Excel(name = "poi热点ID	")
	private String hotPointID;//	poi热点ID		必返回	热点id
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.
• 36.
• 37.
• 38.
• 39.
• 40.
• 41.
• 42.
• 43.
• 44.
• 45.
• 46.
• 47.
• 48.
• 49.
• 50.
• 51.
• 52.

        在具体的POI对象之上还有一个父级对象，用来封装上面的POI数据列表，其代码如下：

登录后复制

package com.yelang.project.education.domain;
import java.io.Serializable;
import java.util.List;
import com.yelang.project.education.domain.tdt.TdtPoi;
import lombok.Data;
import lombok.ToString;
@Data
@ToString
public class TdtSearchVo implements Serializable{
	private static final long serialVersionUID = 5596022814458900285L;
	private int count = 0;
	private int resultType;
	private List<TdtPoi> pois;
	private String keyWord;
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.

        在前面的代码中我们使用了ExcelUtil的一个工具类来实现对集合数据的Excle生成。运行上面的代码后可以在本地磁盘中看到如下的Excel文件和控制台命令行：

        为了方便大家来进行查看，这里将关键几个属性字段的信息直接贴出来。根据查询检索的接口可以看到，荣昌卤鹅的食品店大约有70余条。 

        以上就是从天地图中给大家获取下来的卤鹅店，提前祝大家接入愉快并且能享受到美食。数据完全来源于天地图，如果于实际情况有出入，还请谅解，最后祝大家旅游快乐。

三、总结

        以上就是本文的主要内容，文章首先介绍天地图的检索API，然后详细介绍如何使用Java来调用天地图的API获取所有的卤鹅位置信息，权当为大家做一个参考。文章详细的介绍了天地图的地图检索API以及其具体的参数，同时基于API开发了一个荣昌卤鹅的实例，希望可以帮到大家。行文仓促，定有不足之处，欢迎各位朋友在评论区批评指正，不胜感激。