xuqingkuang / better-echarts-maps

Better ECharts geojson maps than built-in.

Better ECharts Maps

更好的 ECharts **地图，主要有以下扩展：

1. 所有地图的坐标都是明文，可以使用 Geojson.io 进行编辑。
2. 对地图内超长地名进行了缩减，方便进行显示，目前最长的是**部分地区五个字符长度（这会造成与官方原版地图不兼容）。
3. 对地图进行整体打包，不用再单个引用，方便通过 webpack 进行地图注册。

同时，还提供了两份新的地图和数据：

1. china-regions **区域地图
2. china-cities-coordinate 包含了 435 个全国城市坐标，官方范例只有 190 个城市坐标。

目前包含了全国的省市和地区地图两种，39个省份和直辖市地图（包含直辖市边界图）。

安装方法

npm install --save better-echarts-maps

使用方法

因为 npm package 限制，一次只能导出一个 module，所以默认导出的是所有地图， 这有可能会导致程序体积膨胀，建议配合 Webpack 2 的 Tree shaking 特性将不用的地图去掉，

目前程序导出的四种地图类型如下：

名称	说明
China	全国省份地图
ChinaRegions	全国区域地图
ChinaProvinces	所有单个省份地图
ChinaCitiesCoordinate	全国430个城市坐标
all	除了坐标以外的所有全国、和省市地图

所有数据都为数组结构，以全部地图（all）为例，可以通过下面命令进行注册：

var betterEChartsMap = require('better-echarts-map');
betterEChartsMap.all.forEach(map => echarts.registerMap(map[0], map[1]));

推荐使用 ES6 的 import 语法进行单个引用，例如

import { ChinaCitiesCoordinate } from 'better-echarts-map';

在 ECharts 中使用注册的新地图

地图具体参数可以参考 http://echarts.baidu.com/examples.html

地图坐标具体使用方法可以参考 http://echarts.baidu.com/demo.html#effectScatter-map

也可以参考项目的 Demo http://xuqingkuang.github.io/better-echarts-maps

所有地图的名称对照

地图 mapType	地图
china	全国省份地图
china-regions	全国地区地图
anhui	安徽省地图
beijing	北京市地图
beijing-contour	北京市边界图
chongqing	重庆市地图
chongqing-contour	重庆市边界图
fujian	福建省地图
gansu	甘肃省地图
guangdong	广东省地图
guangxi	广西省地图
guizhou	贵州省地图
hainan	海南省地图
hebei	河北省地图
heilongjiang	黑龙江省地图
henan	河南省地图
hongkong	香港特别行政区地图
hubei	湖北省地图
hunan	湖南省地图
jiangsu	江苏省地图
jiangxi	江西省地图
jilin	吉林省地图
liaoning	辽宁省地图
macao	澳门特别行政区地图
neimenggu	内蒙古藏族自治区地图
ningxia	宁夏自治区地图
qinghai	青海省地图
shandong	山东省地图
shanghai	上海市地图
shanghai-contour	上海市边界图
shanxi	山西省地图
shanxi2	陕西省地图
sichuan	四川省地图
taiwan	**省地图
tianjin	天津市地图
tianjin-contour	天津市边界图
xinjiang	**维吾尔自治区地图
xizang	西藏藏族自治区地图
yunnan	云南省地图
zhejiang	浙江省地图

已知问题

1. 香港、澳门、**三个地区地图有问题，待后期修复了。
2. 城市坐标有个别城市数据为空，仍需要补齐。

better-echarts-maps's Issues

广东省地图不精确

在湛江市和珠三角地区的地图与愿地图有出入，而且差异明显