首页 前端知识 高德地图JS API加载行政区边界AMap.Polygon

高德地图JS API加载行政区边界AMap.Polygon

2024-09-21 21:09:12 前端知识 前端哥 592 267 我要收藏

在这里插入图片描述

🤖 作者简介:水煮白菜王 ,一位资深前端劝退师 👻
👀 文章专栏: 高德AMap专栏 ,记录一下平时在博客写作中,总结出的一些开发技巧✍。
感谢支持💕💕💕

关联文章:
高德地图JS API DistrictExplore区划浏览r
高德地图JS API AMap.MouseTool绘制

目录

  • 高德地图API加载行政区边界AMap.Polygon
    • 前言
    • AMap.Polygon
      • 参数说明
    • AMap.DistrictSearch
    • 运行示例
    • 实现步骤
      • 1.调用AMap.DistrictSearch获取边界数据
      • 2.调用AMap.Polygon加载行政区边界
    • 完整代码
    • 更多

高德地图API加载行政区边界AMap.Polygon

前言

在使用高德地图JS API开发过程中,对其地图所呈现的地区加上边界及区域面,一般来讲采用AMap.Polygon进行渲染,对API可谓是即拿即用,快速开发。

AMap.Polygon

在AMap文档说明中,AMap.Polygon属于矢量图形,用于在地图上绘制线、面等矢量地图要素的类型,AMap.Polygon构造多边形对象,通过PolygonOptions指定多边形样式。AMap的矢量图形相关的API可以呈现很多图形体的绘制和编辑。

new AMap.Polygon(opts: PolygonOptions)

参数说明

opts (PolygonOptions)

属性类型描述
opts.pathArray<LngLat> I Array<Array<LngLat>> I Array<Array<Array<LngLat>>>多多边形轮廓线的节点坐标数组。 支持 单个普通多边形({Array }),单个带孔多边形({Array}),多个带孔多边形({Array<Array>})
opts.zIndexnumber多边形覆盖物的叠加顺序。地图上存在多个多边形覆盖物叠加时,通过该属性使级别较高的多边形覆盖物在上层显示。默认值为 10
opts.bubbleboolean是否将覆盖物的鼠标或 touch 事件冒泡到地图上(自v1.3 新增)。默认值为 false
opts.cursorstring?指定鼠标悬停时的鼠标样式, 自定义cursor,IE仅支持cur/ani/ico格式,Opera不支持自定义cursor
opts.strokeColorstring线条颜色,使用 16 进制颜色代码赋值。默认值为 #00D3FC
opts.strokeOpacitynumber轮廓线透明度,取值范围 [0,1] ,0表示完全透明,1表示不透明。默认为0.9
opts.strokeWeightnumber轮廓线宽度。默认值为 2
opts.fillColorstring多边形填充颜色,使用 16 进制颜色代码赋值。默认值为 #00B2D5
opts.fillOpacitynumber多边形填充透明度,取值范围 [0,1] ,0表示完全透明,1表示不透明。默认为0.5
opts.draggableboolean设置多边形是否可拖拽移动,默认为 false
opts.heightnumber设置 polygon 是否离地绘制,默认值为0 。大于0时离地绘制,此时平面高度等于 height 属性值加 polygon 质心点绝对海拔高度值,可以通过getPlaneHeight() 方法获取当前平面高度值(此属性适用于 JSAPI v2.1Beta及以上的版本)。,默认值为 0
opts.extrusionHeightnumber设置多边形是否拉伸为的立面体高度值,默认值为 0
opts.wallColor(Array<String> I String)polygon 立面体侧面颜色,支持 rgba、rgb、十六进制等。默认值为 #00D3FC
opts.roofColor(Array<String> I String)polygon 立面体侧面颜色,支持 rgba、rgb、十六进制等。默认值为 #00B2D5
opts.extDataobject?用户自定义属性,支持JavaScript API任意数据类型,如Polygon的id等。
opts.strokeStyle("solid" I "dashed")轮廓线样式,实线:solid,虚线:dashed
opts.strokeDasharrayArray<number>?勾勒形状轮廓的虚线和间隙的样式,此属性在strokeStyle 为dashed 时有效, 此属性在ie9+浏览器有效 取值: 实线: [0,0,0] 虚线: [10,10] , [10,10] 表示10个像素的实线和10个像素的空白(如此反复)组成的虚线 点画线: [10,2,10] , [10,2,10] 表示10个像素的实线和2个像素的空白 + 10个像素的实线和10个像素的空白 (如此反复)组成的虚线

首先使用AMap.Polygon之前需要先获取其行政区划边界,调用行政区查询服务(AMap.DistrictSearch)的API。

AMap.DistrictSearch

AMap.DistrictSearch提供行政区信息的查询, 使用该服务可以获取到行政区域的区号、城市编码、中心点、边界、下辖区域等详细信息,为基于行政区域的地图功能提供支持。在这里我们只实现区域边界,关于AMap.DistrictSearch的其他参数、成员函数先不过多阐述。可以先移步阅读AMap.DistrictSearch官方文档👀

官方示例

AMap.plugin('AMap.DistrictSearch', function () {
  var districtSearch = new AMap.DistrictSearch({
    // 关键字对应的行政区级别,country表示国家
    level: 'country',
    //  显示下级行政区级数,1表示返回下一级行政区
    subdistrict: 1
  })
  // 搜索所有省/直辖市信息
  districtSearch.search('中国', function(status, result) {
    // 查询成功时,result即为对应的行政区信息
  })
})
// 除了获取所有省份/直辖市信息外,您可以通过修改level和subdistrict并配合search传入对应keyword查询对应信息。

运行示例

实现步骤

1.调用AMap.DistrictSearch获取边界数据

注意使用AMap.DistrictSearch前,检查是否已经引入AMap.DistrictSearch插件 ,并且AMap.DistrictSearch必须配置高德密钥securityJsCode才能成功调用。

调用AMap.DistrictSearch创建其实例,并查询其区划编码,查询接口支持区划名称(北京、南京),编码(110000、320100)。注意这里的区划编码是6位,如果要加载市级,则在构建DistrictSearch实例配置参数level: "city",对其进行查询传入区划信息(编码或名称),对查询结果result获取多边形数据boundaries
所以在拿到边界数据之前,我们只需要关注传入查询的参数。即行政区级别的类型 和 所传区划主键

<!-- Vue 2 Code -->
// 加载DistrictSearch
district = new window.AMap.DistrictSearch({
    subdistrict: 0, //获取边界不需要返回下级行政区
    extensions: "all", //返回行政区边界坐标组等具体信息
    level: "city", //查询行政级别为 国country 市city 区县district 商圈biz_area
});
// district.setLevel("district"); //  设置级别 即同上level
let code = "320100"; // 你需要加入的区划编码或地区名称
//行政区查询
district.search(code, (status, result) => {
    console.log(result);
    var bounds = result.districtList[0].boundaries;
    if (bounds) {
        // 这里处理多边形的数据
    }
});

2.调用AMap.Polygon加载行政区边界

拿到边界数据后,调用AMap.Polygon,其调整指定的多边形样式。
对于AMap.Polygon更多指定多边形样式的配置其他成员函数,可以先移步阅读AMap.Polygon官方文档👀

这里注意要成功拿到多边形数据,再对其执行加载AMap.Polygon

<!-- Vue 2 Code -->
//行政区查询
district.search(code, (status, result) => {
  console.log(result);
  if(result.info == 'OK') console.log('查询成功:'+result);
  var bounds = result.districtList[0].boundaries;
  if (bounds) {
    //生成行政区划polygon
    for (var i = 0; i < bounds.length; i += 1) {
      //构造MultiPolygon的path
      bounds[i] = [bounds[i]];
    }
    polygon = new window.AMap.Polygon({
      path: bounds, // 多边形轮廓线的节点坐标数据
      strokeWeight: 2, // 轮廓线宽度
      strokeColor: "#0091ea", // 线条颜色
      strokeOpacity: "1", // 轮廓线透明度
      fillOpacity: 0.1, // 多边形填充透明度
      fillColor: "#80d8ff", // 多边形填充颜色
    });
    map.add(polygon);
    map.setFitView(polygon); //视口自适应
  }
});

在这里插入图片描述

完整代码

<!-- Vue 2 Code -->
<!--
 * @Author: baicaiKing
 * @Date: 2024-09-10 18:04:31
 * @LastEditors: Do not edit
 * @LastEditTime: 2024-09-10 20:16:44
 * @FilePath: \code2.0\src\views\components\district.vue
 * @Description: Fill in the instructions here
-->
<template>
  <!-- 行政区边界-->
  <div id="index" ref="appRef">
    <!-- 地图 -->
    <div id="container" ref="mapRef"></div>
  </div>
</template>
  <script>
var map; // 地图加载
var district = null;
var polygon;
export default {
  name: "componentsMap",
  data() {
    return {
      timing: null,
      adcode: 100000,
    };
  },
  created() {},
  mounted() {
    this.$nextTick(() => this.initMap());
  },
  beforeDestroy() {
    map?.destroy();
    map = null;
  },
  methods: {
    // 初始化地图
    initMap() {
      map = new window.AMap.Map("container", {
        terrain: false, //关闭地形图
        showBuildingBlock: false, // 不显示3D楼块
        // showLabel: false, // 取消地图层标注
        scrollWheel: true, // 开启缩放
        dragEnable: true, // 开启鼠标拖动
        showIndoorMap: false,
        doubleClickZoom: false, // 禁止双击
        // resizeEnable: true, //是否监控地图容器尺寸变化
      });
      this.setDistrict();
    },
    // 加载行政区边界
    setDistrict() {
      // 加载DistrictSearch
      district = new window.AMap.DistrictSearch({
        subdistrict: 0, //获取边界不需要返回下级行政区
        extensions: "all", //返回行政区边界坐标组等具体信息
        level: "city", //查询行政级别为 国country 市city 区县district 商圈biz_area
      });
      // district.setLevel("district"); //  设置级别 即同上level
      let code = "320100"; // 你需要加入的区划编码或地区名称
      //行政区查询
      district.search(code, (status, result) => {
        console.log(result);
        if(result.info == 'OK') console.log('查询成功:'+result);
        var bounds = result.districtList[0].boundaries;
        if (bounds) {
          //生成行政区划polygon
          for (var i = 0; i < bounds.length; i += 1) {
            //构造MultiPolygon的path
            bounds[i] = [bounds[i]];
          }
          polygon = new window.AMap.Polygon({
            path: bounds, // 多边形轮廓线的节点坐标数据
            strokeWeight: 2, // 轮廓线宽度
            strokeColor: "#0091ea", // 线条颜色
            strokeOpacity: "1", // 轮廓线透明度
            fillOpacity: 0.1, // 多边形填充透明度
            fillColor: "#80d8ff", // 多边形填充颜色
          });
          map.add(polygon);
          map.setFitView(polygon); //视口自适应
        }
      });
    },
  },
};
</script>
  <style lang="scss"  scoped>
#index {
  width: 1920px;
  height: 1080px;
  color: #ffffff;
  overflow: hidden;
  #container {
    width: 1920px;
    height: 1080px;
    z-index: 100;
  }
}
</style>
      
      

更多

在AMap.Polygon构造多边形对象的其他成员函数,还有很多, 比如移入移出等
如果想要深入层级实现关于polygon效果,AMap的矢量图形相关的API可以呈现很多图形体的绘制和编辑👀,

//鼠标移入事件
polygon.on("mouseover", () => {
  polygon.setOptions({
    //修改多边形属性的方法
    fillOpacity: 0.7, //多边形填充透明度
    fillColor: "#80d8ff",
  });
});
//鼠标移出事件
polygon.on("mouseout", () => {
  polygon.setOptions({
    fillOpacity: 0.1,
    fillColor: "#80d8ff",
  });
});

如果对加载其行政区边界包含其下子边界这种,可以考虑采用geojson数据,使用Map.GeoJSON函数,最终也是通过AMap.Polygon进行呈现的,注意这里的json数据源要有丰富度存在子级边界数据。

new AMap.GeoJSON(opts: GeoJSONOptions)

在这里插入图片描述
如果你觉得这篇文章对你有帮助,请点赞 👍、收藏 👏 并关注我!👀
在这里插入图片描述

转载请注明出处或者链接地址:https://www.qianduange.cn//article/18464.html
标签
评论
发布的文章

Excel-to-JSON开源项目指南

2024-10-27 22:10:41

json字符串, string转json

2024-10-27 22:10:16

【开源】APIJSON 框架

2024-10-27 22:10:15

大家推荐的文章
会员中心 联系我 留言建议 回顶部
复制成功!