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

水煮白菜王 2024-09-19 13:05:04 阅读 88

在这里插入图片描述

🤖 作者简介:水煮白菜王 ,一位资深前端劝退师 👻

👀 文章专栏: 高德AMap专栏 ,记录一下平时在博客写作中,总结出的一些开发技巧✍。

感谢支持💕💕💕

关联文章:

高德地图JS API 开发——区划浏览DistrictExplorer

目录

高德地图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可以呈现很多图形体的绘制和编辑。

<code>new AMap.Polygon(opts: PolygonOptions)

参数说明

opts (PolygonOptions)

属性 类型 描述
opts.path Array<LngLat> I Array<Array<LngLat>> I Array<Array<Array<LngLat>>> 多多边形轮廓线的节点坐标数组。 支持 单个普通多边形({Array }),单个带孔多边形({Array}),多个带孔多边形({Array<Array>})
opts.zIndex number 多边形覆盖物的叠加顺序。地图上存在多个多边形覆盖物叠加时,通过该属性使级别较高的多边形覆盖物在上层显示。默认值为 10
opts.bubble boolean 是否将覆盖物的鼠标或 touch 事件冒泡到地图上(自v1.3 新增)。默认值为 false
opts.cursor string? 指定鼠标悬停时的鼠标样式, 自定义cursor,IE仅支持cur/ani/ico格式,Opera不支持自定义cursor
opts.strokeColor string 线条颜色,使用 16 进制颜色代码赋值。默认值为 #00D3FC
opts.strokeOpacity number 轮廓线透明度,取值范围 [0,1] ,0表示完全透明,1表示不透明。默认为0.9
opts.strokeWeight number 轮廓线宽度。默认值为 2
opts.fillColor string 多边形填充颜色,使用 16 进制颜色代码赋值。默认值为 #00B2D5
opts.fillOpacity number 多边形填充透明度,取值范围 [0,1] ,0表示完全透明,1表示不透明。默认为0.5
opts.draggable boolean 设置多边形是否可拖拽移动,默认为 false
opts.height number 设置 polygon 是否离地绘制,默认值为0 。大于0时离地绘制,此时平面高度等于 height 属性值加 polygon 质心点绝对海拔高度值,可以通过getPlaneHeight() 方法获取当前平面高度值(此属性适用于 JSAPI v2.1Beta及以上的版本)。,默认值为 0
opts.extrusionHeight number 设置多边形是否拉伸为的立面体高度值,默认值为 0
opts.wallColor (Array<String> I String) polygon 立面体侧面颜色,支持 rgba、rgb、十六进制等。默认值为 #00D3FC
opts.roofColor (Array<String> I String) polygon 立面体侧面颜色,支持 rgba、rgb、十六进制等。默认值为 #00B2D5
opts.extData object? 用户自定义属性,支持JavaScript API任意数据类型,如Polygon的id等。
opts.strokeStyle ("solid" I "dashed") 轮廓线样式,实线:solid,虚线:dashed
opts.strokeDasharray Array<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实例配置参数<code>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); //视口自适应

}

});

在这里插入图片描述

完整代码

<code><!-- 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">code>

<!-- 地图 -->

<div id="container" ref="mapRef"></div>code>

</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>code>

#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)

在这里插入图片描述

如果你觉得这篇文章对你有帮助,请点赞 👍、收藏 👏 并关注我!👀

在这里插入图片描述



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。