目录

前言

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);
}

        请注意 :这里我们为了简化相关接口的调用,使用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" ;

         然后使用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("检索并本地化完成");
}

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
}

        在具体的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;
}

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

 

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

Poi点名称 电话 地址 坐标 x,y
李氏卤鹅 18716232760 荣滨南路东段11号附28附近 105.590250,29.416870
李氏卤鹅 18716232760 海棠一支路51 105.601969,29.408174
黄氏卤鹅 13667699039 向阳路164号附1号 105.610380,29.413330
黄氏卤鹅 13883747879 国泰路22号附109号 105.619230,29.419920
志强卤鹅 13452100263 滨河东路199 105.598171,29.406096
刘氏卤鹅 15213495612 学院路启昌·财富广场内 105.580590,29.401687
小李卤鹅 18223580972 海棠一支路35 105.601510,29.408171
小刘卤鹅 15111864106 棠香北街12号附17号 105.602570,29.419980
刘记卤鹅 小康路74号附32号东南方向40米 105.598810,29.412160
刘记卤鹅 15025495776 恒荣路61号附42 105.580350,29.412990
小曹卤鹅 18716237165 迎宾大道27号附88号 105.603160,29.417968
郭记卤鹅 15808034359 兴发路14号西南方向10米 105.466663,29.359522
林勇卤鹅 13883688855 安富镇安陶路99号西北方向30米 105.465750,29.360990
李姐卤鹅 13372659875 棠香北街73号 105.601950,29.423070
小罗卤鹅 023-46761006 玉屏街116 105.595290,29.409930
棠香卤鹅 13637773266 小康路137 105.598200,29.412993
刘记卤鹅 仁和一路412 105.617110,29.401070
刘师傅卤鹅 17783015200 小康路74号附32号东南方向40米 105.598833,29.412210
刘记卤鹅 重庆市荣昌区 105.584088,29.408142
绝味卤鹅 13618309813 迎宾大道29号附103 105.603740,29.418866
刘记卤鹅 后西一街5 105.589364,29.407575
蓝氏卤鹅 13696427391 古昌镇街道永丰路70号东北方向50米 105.589570,29.488270
刘记卤鹅 国泰路35 105.615933,29.420912
小周卤鹅 13452978356 颐和街62 105.608644,29.410932
小罗卤鹅 棠香北街8号附15号 105.602590,29.418450
小蒋卤鹅 15213235048 重庆市荣昌区 105.585332,29.404571
小周卤鹅 学院支路37 105.582256,29.402380
黄记卤鹅 双河镇荣泸北路4号正东方向180米 105.569520,29.321250
安子卤鹅 13527458567 兴隆街17 105.590850,29.409790
小周卤鹅 海棠二支路15 105.600870,29.408750
家乐卤鹅 滨河西路2 105.585580,29.407030
黄二姐卤鹅 13372697555 棠香北街9号附1附近 105.602092,29.418753
王三妹卤鹅

13648367955

13452927073

向阳北路37 105.609858,29.423937
唐二姐卤鹅 13983033139 海棠五支路46 105.595362,29.413425
曾三姐卤鹅 15902373368 国泰路65 105.616490,29.421240
小李卤鹅分店

18223580972

15025420635

广场路406 105.590411,29.409533
曾三姐卤鹅 15902373368 海棠四支路27号附1 105.598220,29.411840
唐二妹卤鹅 13618315289 中科路3 105.581230,29.407800
郑氏卤鹅 18623130348 莲花路43 105.591990,29.404650
陈氏卤鹅 18883009317 国泰路26 105.617380,29.421210
大双卤鹅 15998998705 向阳路180号附13号 105.610360,29.418520
广顺小蒋卤鹅 13883055909 荣滨南路西段81 105.582410,29.408970
马老七卤鹅

13527597939

13101396129

国泰路38号 105.617365,29.421319
陈氏卤鹅 学院路43 105.580823,29.401070
陈氏卤鹅 18328560692 国泰路13-附10号西北方向200米 105.609858,29.423897
黄永记卤鹅 富安南路27 105.602619,29.413278
黄记卤鹅NO.2 东大街165 105.596870,29.406940
陈老五卤鹅 13372622813 玉屏街104 105.594950,29.409740
小罗卤鹅NO.16 023-46761006 广场路41正东方向120米 105.594180,29.403140
小有天卤鹅

15923172079

13983165502

桂花园街15 105.599129,29.405079
陈老五卤鹅 15111662268 重庆市荣昌区 105.598197,29.408449
广顺姜三妹卤鹅

13883976066

13996481845

棠香南街63 105.602530,29.413337
小罗卤鹅NO.2 023-46761006 滨河中路283 105.586760,29.405180
小薛卤鹅NO.2 15923227029 昌龙大道166号附4附近 105.602114,29.416036
荣昌三惠卤鹅 黄金大道荣昌北站内 105.631714,29.435601
荣昌三惠卤鹅 海棠大道80东南方向30米 105.597744,29.411606
莫氏卤鹅北门店 15823147600 兴隆街96 105.592000,29.411200
黄二姐卤鹅总店

023-46786647

13228672592

昌龙大道122 105.597320,29.416230
黄记卤鹅后西店 后西街4 105.587490,29.405450
安富林记卤鹅 17723656348 东大街414 105.599980,29.408590
小罗卤鹅莲花广场店 023-46761006 广场路85 105.592163,29.407062
广顺陈胖子卤鹅NO.3 18983824002 中科路19 105.580960,29.407530
安富小李卤鹅NO.8 13018338038 仁北新城B区附2号 105.477500,29.511130
亮嘴卤鹅连锁寰宇店 向阳路166号附4号 105.610300,29.413750
小罗卤鹅瑞尔戴斯店 023-46761006 重庆市荣昌区 105.604045,29.416857
陈老五卤鹅上海公馆店 13372622813 棠香北街95东南方向60米 105.602550,29.423370
亮嘴卤鹅休闲食品旗舰店 东大街20 105.593828,29.406398
陈老五卤鹅西门桥店 13372622813 滨河中路270 105.587472,29.405266
小罗卤鹅高速路直营店 重庆市荣昌区 105.639837,29.415633
小薛卤鹅敖凉粉东大街总店 023-61480536 东大街204 105.596530,29.406240

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

三、总结

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

Logo

助力广东及东莞地区开发者,代码托管、在线学习与竞赛、技术交流与分享、资源共享、职业发展,成为松山湖开发者首选的工作与学习平台

更多推荐