县域烟花禁燃监管 GIS 实践：Java 结合高德地图 API 盘点销售点

这里定义了 POI 检索的核心方法，通过注解映射高德 REST 接口。keywords 设定为'烟花'，types 对应烟花零售分类编码，region 限定为新晃县行政区域码，page_size 控制单次返回数量，show_fields 指定需要返回的详细字段如商业信息、导航等。

数据抓取

基于 UniHttp 实现 HTTP 请求，解析高德返回的 JSON 数据，提取销售点的核心信息（名称、地址、经纬度、联系方式）。实际开发中要注意处理分页逻辑和接口限流，避免请求过快导致被封禁。

关键逻辑如下

package com.yelang.project.unihttp;
import java.util.ArrayList;
import java.util.List;
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.common.utils.StringUtils;
import com.yelang.common.utils.poi.ExcelUtil;
import com.yelang.project.education.domain.amap.AmapPoi;
import com.yelang.project.education.domain.amap.AmapSearchVO;
import com.yelang.project.thridinterface.AmapSearchService;

@SpringBootTest
@RunWith(SpringRunner.class)
public class AmaPOISearchCase {
    private static final String AMAP_CLIENT_AK = "yourkey";
    @Autowired
    private AmapSearchService amapSearchService;

    /**
     * 查询烟花销售点
     */
    @Test
    public void searchChangshaFireworks() throws InterruptedException {
        String keywords = "烟花";
        String types = "060000";
        String page_size = "25";
        String region = "431227"; // 新晃县区域码
        String show_fields = "children,business,indoor,navi,photos";
        
        HttpResponse<String> result = null;
        Gson gson = new Gson();
        int scrapingIndex = 1;
        int dataCount = 0;
        List<AmapPoi> amapPoiData = new ArrayList<>();
        
        do {
            result = amapSearchService.getSearch(keywords, types, region, page_size, String.valueOf(scrapingIndex), show_fields, AMAP_CLIENT_AK);
            System.out.println(result.getBodyResult());
            if (StringUtils.isNotEmpty(result.getBodyResult())) {
                AmapSearchVO searchVO = gson.fromJson(result.getBodyResult(), AmapSearchVO.class);
                amapPoiData.addAll(searchVO.getPois());
                dataCount = searchVO.getCount();
                scrapingIndex++;
            }
            Thread.sleep(3000L); // 休眠防止触发限流
        } while (dataCount > 0);
        
        System.out.println("一共抓取数据页数：" + scrapingIndex);
        System.out.println(amapPoiData.size());
        
        if (amapPoiData.size() > 0) {
            ExcelUtil<AmapPoi> util = new ExcelUtil<>(AmapPoi.class);
            util.exportExcel(amapPoiData, "新晃侗族自治县烟花销售点列表");
            System.out.println("finished");
        }
    }
}

这段代码实现了分页循环抓取，每次请求后休眠 3 秒以保护接口资源。当总数据量大于 0 时继续下一页，直到抓完所有结果。最后调用 Excel 工具类将数据导出，方便后续核对。

数据结构说明

这里给出检索 POI 类的关键 JavaBean 结构，包含名称、唯一标识、经纬度、详细地址等字段，并使用了自定义注解以便直接导出 Excel。

package com.yelang.project.education.domain.amap;
import java.io.Serializable;
import java.util.List;
import com.yelang.framework.aspectj.lang.annotation.Excel;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;

@Data
@ToString
@AllArgsConstructor
@NoArgsConstructor
public class AmapPoi implements Serializable {
    private static final long serialVersionUID = 8477368531294599663L;
    @Excel(name = "名称")
    private String name;
    @Excel(name = "唯一标识")
    private String id;
    @Excel(name = "经纬度")
    private String location;
    @Excel(name = "所属类型")
    private String type;
    @Excel(name = "分类编码")
    private String typecode;
    @Excel(name = "所属省份")
    private String pname;
    @Excel(name = "所属城市")
    private String cityname;
    @Excel(name = "所属区县")
    private String adname;
    @Excel(name = "详细地址")
    private String address;
    @Excel(name = "所属省份编码")
    private String pcode;
    @Excel(name = "所属区域编码")
    private String adcode;
    @Excel(name = "所属城市编码")
    private String citycode;
    private List<AmapChildrenPoi> children;
    private AmapBusiness business;
    private AmapIndoor indoor;
    private AmapNavi navi;
    private List<AmapPhotos> photos;
}

成果展示

Excel 导出

将检索到的新晃县烟花爆竹销售点数据导出为 Excel，便于监管部门线下查看、核对和存档。基于自定义注解的实现快速导出，核心代码如下：

if (amapPoiData.size() > 0) {
    ExcelUtil<AmapPoi> util = new ExcelUtil<>(AmapPoi.class);
    util.exportExcel(amapPoiData, "新晃侗族自治县烟花销售点列表");
    System.out.println("finished");
}

导出结果如下：

表格预览

提取关键信息后，可以转为以下关键表格，具体如下：

总结

本方案以新晃县为例，通过 Java 调用高德地图 POI 检索接口，实现了烟花爆竹销售点的自动化盘点。相比传统人工方式，大幅提升了数据获取效率和准确性：

1. 技术层面：Java + 高德地图 API 的组合轻量化、易部署，无需搭建复杂的 GIS 服务器，适合县域基层监管部门的技术落地能力；解决了传统人工盘点效率低、可视化差的问题。
2. 业务层面：导出的 Excel 成果可直接对接监管工作，经纬度数据还可进一步导入高德地图 Web 端，实现销售点的可视化标注，辅助禁燃巡查路线规划；核心流程为「接口配置→数据检索→Excel 导出」，技术方案轻量化、易复用，适配县域基层监管的落地需求。
3. 拓展性：该方案可快速适配其他县域，仅需修改行政编码和检索关键词，即可复用至其他品类（如危化品、农资）的县域监管场景。

后续可进一步优化：增加销售点数据的增量更新（避免重复检索）、对接县域政务系统实现数据自动上报、增加违规销售点的位置对比分析等，让 GIS 技术更好地服务于县域基层治理。