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

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

一、背景与目标

春节期间烟花爆竹禁燃禁放是保障公共安全、改善空气质量的重要举措。然而，禁燃政策落地的核心环节之一，是对县域范围内烟花爆竹销售点的精准盘点与动态监管。传统的人工排查方式存在效率低、数据更新不及时、空间位置可视化差等问题，难以满足县域精细化监管的需求。

地理信息系统（GIS）技术能够将空间位置与业务数据深度融合。结合 Java 语言的跨平台、高稳定性特性，以及高德地图 API 提供的成熟地理编码和 POI 检索能力，我们可以快速搭建一套轻量化的县域烟花销售点盘点系统，实现销售点位置检索、数据整合、成果输出的全流程自动化。

本次实践以湖南省怀化市新晃侗族自治县为研究对象。该县地处湘黔边界，乡镇分布分散、地形复杂，烟花爆竹销售点多分布于乡镇集市、村级小卖部等场景。通过技术手段验证 GIS 在基层监管中的实用性，能为同类县域的烟花禁燃监管提供可复用的技术方案。

二、Java 实现高德检索

1. 接口定义

在高德开放平台注册开发者账号并申请 Web 服务 API Key（注意区分「Web 服务」与「前端 JS」Key）。本次核心使用高德的 POI 搜索接口（/v5/place/text），用于检索指定区域内的烟花爆竹销售点。

我们定义了一个接口来封装 HTTP 请求参数，包括关键词、类型、区域范围、分页大小及返回字段等。

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 = "https://restapi.amap.com/v5")
public interface AmapSearchService {
    @GetHttpInterface("/place/text")
    public HttpResponse<String> getSearch(
        @QueryPar("keywords") String keywords,
        @QueryPar("types") String types,
        @QueryPar("region") String region,
        @QueryPar("page_size") String page_size,
        @QueryPar("page_num") String page_num,
        @QueryPar("show_fields") String show_fields,
        @QueryPar("key") String key);
}

2. 数据获取与处理

基于 UniHttp 实现 HTTP 请求，解析高德返回的 JSON 数据，提取销售点的核心信息（名称、地址、经纬度、联系方式）。这里需要注意控制请求频率，避免触发平台的限流机制。

核心逻辑如下：设置关键词为'烟花'，类型为'060000'（零售店），区域为新晃县行政代码，循环抓取直到数据获取完毕。

 com.yelang.project.unihttp;
 java.util.ArrayList;
 java.util.List;
 org.junit.Test;
 org.junit.runner.RunWith;
 org.springframework.beans.factory.annotation.Autowired;
 org.springframework.boot.test.context.SpringBootTest;
 org.springframework.test.context.junit4.SpringRunner;
 com.burukeyou.uniapi.http.core.response.HttpResponse;
 com.google.gson.Gson;
 com.yelang.common.utils.StringUtils;
 com.yelang.common.utils.poi.ExcelUtil;
 com.yelang.project.education.domain.amap.AmapPoi;
 com.yelang.project.education.domain.amap.AmapSearchVO;
 com.yelang.project.thridinterface.AmapSearchService;



   {
          ;
    
     AmapSearchService amapSearchService;

    
    
        InterruptedException {
           ;
           ;
           ;
           ; 
           ;
        
        HttpResponse<String> result = ;
            ();
           ;
           ;
        List<AmapPoi> amapPoiData =  <>();

         {
            result = amapSearchService.getSearch(keywords, types, region, page_size, String.valueOf(scrapingIndex), show_fields, AMAP_CLIENT_AK);
            System.out.println(result.getBodyResult());
             (StringUtils.isNotEmpty(result.getBodyResult())) {
                   gson.fromJson(result.getBodyResult(), AmapSearchVO.class);
                amapPoiData.addAll(searchVO.getPois());
                dataCount = searchVO.getCount();
                scrapingIndex++;
            }
            Thread.sleep(); 
        }  (dataCount > );

        System.out.println( + scrapingIndex);
        System.out.println(amapPoiData.size());

         (amapPoiData.size() > ) {
            ExcelUtil<AmapPoi> util =  <>(AmapPoi.class);
            util.exportExcel(amapPoiData, );
            System.out.println();
        }
    }
}