Vue echarts@4.x中国地图及AMap相关API使用详解

 更新时间:2023年12月13日 09:16:01   作者:安语未  
这篇文章主要为大家介绍了Vue使用echarts@4.x中国地图及AMap相关API使用详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

一、此 demo 实现的基本功能

中国地图的显示

地图点击下钻的功能

地图相关组件的使用,例 tooltip...

二、实现思路

初始使用下载本地的中国 geo 格式的 json 数据来绘制地图,点击某一区划(例:山东省)时,以点击的区划名称使用 AMap.DistrictSearch(opts) 构造函数查询下一级的区划信息(例:青岛市区划 id 为 370200)和业务数据整合处理;然后以点击的区划 id 用AMapUI中的组件DistrictExplorer相关方法获取下一级的地图 json 数据,继而绘制下一级地图(例:青岛市),再点下同...

三、引入 echarts

因为 echarts 在 5.0 及之后版本因 包体积优化和法规规定 取消了内置 json 地图数据,但仍然可以下载之前版本的依赖包来使用或下载曾经内置的地图数据。
若要引地图 json 数据,建议下载 echarts@4.9.0 ,这是 echarts 取消内置前的最新版本地图 json 数据,之前的版本地图数据比如 3.x,2.x 或多或少在地图边界和岛屿精度部分有所不准,亲测~

  • 通过 npm 方式下载 echarts
    $ npm i echarts@4.9.0
  • 引入 echarts
    import echarts from 'echarts'

相关 api 说明

  • echarts.registerMap
    echarts 方法:在 echarts 5.0 及之后版本取消了registerMap 此方法,所以最新 echarts(v5.2.2)版本引用会报错,所以这里我使用 v4.9.0 来注册地图。
// registerMap 接收两个参数
// 第一个是地图名称,china 为显示右下角南海诸岛,china1 则不显示右下角南海诸岛
// 第二个参数是绘制地图所需的json数据,在这里我下载了两个版本的json数据放在本地引用来使用,见下文
echarts.registerMap('china', chinaJson)
  • echarts.init
    echarts 方法:创建一个 ECharts 实例,返回 echartsInstance,不能在单个容器上初始化多个 ECharts 实例。
// 创建实例,接收三个参数
// 参数dom:实例容器,一般是一个具有高宽的div元素
// 参数theme:可选,应用的主题。可以是一个主题的配置对象
// 参数opts:可选,附加参数
this.myChart = echarts.init(dom, theme, opts)
  • echartsInstance.on
    实例方法:绑定事件处理函数(对应 off:解绑事件处理函数)
// 创建实例,接收三个参数
// 参数eventName:事件名称,全小写,例如'click','mousemove', 'legendselected'
// 参数query:可选,过滤条件,能够只在指定的组件或者元素上进行响应。可为 string 或者 Object
// 参数handler:事件处理函数

this.myChart.on(eventName, query, handler)
  • echartsInstance.setOption
    实例方法:设置图表实例的配置项以及数据,万能接口,所有参数和数据的修改都可以通过 setOption 完成,ECharts 会合并新的参数和数据,然后刷新图表。

配置项部分用法见下文五、echarts 部分配置项。官方配置项手册

// 参数 option:配置项

this.myChart.setOption(option)

四、AMap 相关 api 使用说明

  • 引入 AMap
<!-- html文件 -->
<!--引入高德地图JSAPI,key值是在AMap官方申请的哦,plugin是项目中用到的插件 -->
<script src="//webapi.amap.com/maps?v=2.0&key=bb36205e1ab4869979c6505a3cc362ee&plugin=AMap.DistrictSearch"></script>
<!--引入UI组件库(1.1版本) -->
<script src="//webapi.amap.com/ui/1.1/main.js"></script>
  • AMap.DistrictSearch(opt)
    插件,行政区查询服务,提供行政区相关信息。官方文档
/** 
参数opts:对象,实例时的配置
opts:{
  level: String, 关键字对应的行政区级别或商圈,可选值
  showbiz: Boolean, 是否显示商圈,默认值true
  extensions: String,是否返回行政区边界坐标点。默认值:base,不返回行政区边界坐标点,取值:all,返回完整行政区边界坐标点
  subdistrict:Number,默认1,显示下级行政区级数(行政区级别包括:国家、省/直辖市、市、区/县4个级别),商圈为区/县下一级。0不返回下一级区划,1返回下一级区划,2...,3...。
}
**/
const districtSearch = new AMap.DistrictSearch(opts)
// 根据关键字查询行政区或商圈信息 关键字支持:行政区名、citycode、adcode、商圈名,默认值:“全国”
districtSearch.search(obj.data.name, (status, result) => {
  console.log('加载区划信息', status, result)
})
  • DistrictExplorer
    加载绘制地图所需的 geo 格式的 json 数据。(行政区划浏览) 提供了全国范围内到区县一级的行政区划数据(含边界),同时提供一些辅助功能,比如区划面绘制、事件监听,以及快速判断经纬度所属的子级区划等。官方文档
// 使用
AMapUI.loadUI(['geo/DistrictExplorer'], (DistrictExplorer) => {
  let districtExplorer = new DistrictExplorer({
    eventSupport: true, // 打开事件支持
    map: null, // 地图对象实例。仅仅获取数据,不涉及地图相关的操作时,可以不设置
  })
  districtExplorer.loadAreaNode(obj.data.cityCode, (error, areaNode) => {
    if (error) return
    const mapJson = {}
    // 返回该区域中全部的子级区划Feature数组
    mapJson.features = areaNode.getSubFeatures() || []
    console.log('绘制地图所需的json数据', mapJson)
  })
})

五、echarts 部分配置项

const option = {
  visualMap: {
    // 视觉映射组件配置
    type: 'continuous', // 定义为连续型 visualMap
    show: true,
    bottom: '5%',
    left: '2%',
    text: ['高', '低'], // 两端的文本
    min: 0, // 指定 visualMapContinuous 组件的允许的最小值
    max: 100, // 指定 visualMapContinuous 组件的允许的最大值
    inRange: {
      // 定义 在选中范围中 的视觉元素
      color: ['#fff', '#A0CFFF', '#409EFF'], // 图元的颜色
    },
    calculable: true, // 是否显示拖拽用的手柄(手柄能拖拽调整选中范围)
  },
  tooltip: {
    // 提示框组件
    trigger: 'item',
    formatter: function (item) {
      if (item.name == '南海诸岛') {
        return ''
      } else {
        return item.name + '<br>业务数据:' + (item.value || 0) + ' 个'
      }
    },
  },
  series: [
    // 系列列表。每个系列通过 type 决定自己的图表类型
    {
      type: 'map', // 系列列表。每个系列通过 type 决定自己的图表类型
      map: 'china', // 地图。china 为中国全国地图+右下角南海诸岛,china1 为中国全国地图
      name: '业务数据', // 系列名称,用于tooltip的显示,legend 的图例筛选,在 setOption 更新数据和配置项时用于指定对应的系列
      aspectScale: 0.75, // 用于 scale 地图的长宽比
      zoom: 1.2, // 地图缩放多少倍
      roam: true, // 允许缩放和平移
      mapType: '自定义地图',
      selectedMode: 'single', // 点击区域,会处于选中状态,single单选
      showLegendSymbol: false, // 在图例相应区域显示图例的颜色标识(系列标识的小圆点),存在 legend 组件时生效
      // center: [100.97, 35.71], // 初始化时的地图位置,可通过改变地图中心视角的经纬度来实现地图的平移
      itemStyle: {
        // 地图区域的多边形图形样式
        normal: {
          // 正常时的样式
          color: '#ccc', // 图形的颜色
          borderColor: '#303133', // 图形的描边颜色
          areaColor: '#d4f7fc', // 地图区域颜色
          borderWidth: 0.5, // 描边线宽。为 0 时无描边
          label: {
            // 设置地图区域名的文本样式,例如地名的字体大小等
            show: true, // 显示地区的文本名称,默认是不显示的,默认状态是hoverORclick才显示
            fontSize: 12,
            textStyle: {
              color: '#606266',
            },
          },
        },
        emphasis: {
          // 选中后的样式
          areaColor: '#4382F6',
          borderColor: '#fff',
          areaStyle: {
            color: '#fff',
          },
          label: {
            show: true,
            fontSize: 12,
            textStyle: {
              color: '#003767',
            },
          },
        },
      },
      data: this.mapData, // 地图系列中的数据内容数组。数组项可以为单个数值
    },
  ],
}

以上就是Vue echarts@4.x中国地图及AMap相关API使用详解的详细内容,更多关于Vue echarts中国地图的资料请关注脚本之家其它相关文章!

相关文章

  • Vue2中实现dialog的封装方式

    Vue2中实现dialog的封装方式

    这篇文章主要介绍了Vue2中实现dialog的封装方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-01-01
  • vue-route路由管理的安装与配置方法

    vue-route路由管理的安装与配置方法

    这篇文章主要介绍了vue-route路由管理的安装与配置,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-07-07
  • 修改Vue打包后的默认文件名操作

    修改Vue打包后的默认文件名操作

    这篇文章主要介绍了修改Vue打包后的默认文件名操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-08-08
  • 详解从零搭建 vue2 vue-router2 webpack3 工程

    详解从零搭建 vue2 vue-router2 webpack3 工程

    本篇文章主要介绍了详解从零搭建 vue2 vue-router2 webpack3 工程,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • uniapp中app与webview的通讯代码示例

    uniapp中app与webview的通讯代码示例

    这篇文章主要给大家介绍了关于uniapp中app与webview通讯的相关资料,这里的通信主要是打包APP端和web-view内嵌网页的双向通信,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-03-03
  • 简单了解Vue computed属性及watch区别

    简单了解Vue computed属性及watch区别

    这篇文章主要介绍了通过实例解析Vue computed属性及watch区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • webpack+vue-cli项目中引入外部非模块格式js的方法

    webpack+vue-cli项目中引入外部非模块格式js的方法

    今天小编就为大家分享一篇webpack+vue-cli项目中引入外部非模块格式js的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-09-09
  • Vue3实现文本差异对比器的具体方案

    Vue3实现文本差异对比器的具体方案

    本文将介绍本项目中 文本差异对比器 (Text Diff Checker) 工具的技术实现细节,该工具基于 Vue 3 框架开发,核心对比逻辑采用原生的 JavaScript 实现,通过动态加载的方式与 Vue 组件进行交互,需要的朋友可以参考下
    2026-02-02
  • Vue3中Axios的使用 附完整代码

    Vue3中Axios的使用 附完整代码

    Axios提供了简洁一致的API,使得发送HTTP请求变得非常容易,无论是GET、POST、PUT还是DELETE等请求,都可以通过简洁的语法轻松实现,这篇文章主要介绍了Vue3中Axios的使用附完整代码,需要的朋友可以参考下
    2025-06-06
  • 深入了解Vue3中侦听器watcher的实现原理

    深入了解Vue3中侦听器watcher的实现原理

    在平时的开发工作中,我们经常使用侦听器帮助我们去观察某个数据的变化然后去执行一段逻辑。在 Vue.js 2.x 中,你可以通过 watch 选项去初始化一个侦听器,称作 watcher。本文将详细为大家介绍一下侦听器的实现原理,需要的可以参考一下
    2022-04-04

最新评论