我开发的开源 JS 地图引擎 maptalks.js, 请大家不吝赐教!

嗨! 今天总算把 maptalks 的示例与文档整理得七七八八, 打算正式发布了.

算一算, 从写下 maptalks 的第一行代码到现在, 已经在这个开源库上花了 4 年时间.

我是个自由职业者, 4 年前因为接了个地图外包项目, 因缘际会开始自己造轮子写引擎, 没想到一写就是 4 年 : P

项目地址是:

项目是一个 HTML5 的地图引擎, 基于原生 ES6 Javascript 开发:

二三维一体化地图, 通过二维地图的旋转 /倾斜增加三维视角
插件化设计, 能与其他图形库结合, 开发各种二三维效果, 例如 echarts/d3/THREE 等
很认真的优化了绘制性能
很重视测试, 有接近 1.5K 个单元测试用例, 所以稳定性还不错, 已经应用在很多大大小小的系统上了

以下是一段 maptalks 的 HELLO WORLD:

const map = new maptalks.Map('map', {
    center: [0, 0],
    zoom: 3,
    attribution: {
      content: '&copy; <a href="http://osm.org">OpenStreetMap</a> contributors'
    },
    baseLayer: new maptalks.TileLayer('base', {
      'urlTemplate' : 'http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',
      'subdomains'  : ['a','b','c']
    })
});

我的目标是把它做成世界上最好的开源地图引擎产品 : ), 目前主要竞争对手有leafletjs和openlayers.

回想开发 maptalks 的过程还是挺唏嘘的, 掉进过一个又一个坑, 不得不一次又一次的重写重构, 总算熬到了现在. 即将发布, 丑媳妇要见公婆, 心情很忐忑 : P

都说 V2EX 是个做第一次分享的好地方, 看官们都很友善, 所以首先发在这里, 请大家提提意见, 不吝赐教.

另外, 既然是开源软件, 如果有同学感兴趣, 想参与开发的, 请随时联系我(fuzhen at maptalks.org)

最后按惯例求个 STAR~

aleung

2017-11-18 11:22:11 +08:00

不错的项目！

这两天尝试将一个原来用 leaflet 的工具移植到 maptalks，发现文档上还是有些不够理想的地方：
* API document 的描述不够详细，特别是 options 的 type 只是 Object，不知道里面可以放什么，允许取值是什么
* Class 的方法、属性列表没有排序，找起来很费劲

Example 比较丰富，一定程度对 API 文档是补充，文档没有描述的就靠样例来猜了。

大部分 API 组织形式跟 leaflet 很类似，但又都有一点不一样，改起来好费劲啊，想放弃了。（当然这不算 maptalks 缺点）

fuzhenn

2017-11-24 01:05:02 +08:00

@aleung 谢谢建议！
Class 的方法和属性是按照在源代码中的定义顺序组织的，我再收集一下其他用户的意见，如果大家都觉得按字母排序更好，我就改成按首字母来排序。

关于构造函数的 options 里的设置和取值范围，文档中其实是有的，但定义在了累的 options 成员属性上的，比如[Map.#options]( https://maptalks.org/maptalks.js/api/0.x/Map.html#options), 不过你说的确实有道理，还是挪到构造函数的参数列表里更直观一些，我晚点会改一下。

以后欢迎在新项目里使用 maptalks，随时来提 ISSUE 和 PR，参与 maptalks 的开发 ^___^

fuzhenn

2018-06-26 13:23:34 +08:00

@cuipeng
感谢你的回复！
边缘虚化范围是可以配置的，maptalks 中可以通过 maxVisualPitch 来调整虚化的角度，把它设成和 maxPitch 一样时，就和 mapbox-gl-js 一样的了。

默认情况下 maxVisualPitch 是 60，maxPitch 是 80，主要是因为 maptalks 的最大倾斜角度比 mapbox-gl-js 更大(目前最大到 60 度），角度很大时会有瓦片载入量过大的问题，为了优化性能，maptalks 有个很独特的 cascadeTile 优化功能，就是远处的瓦片改用上一级的，可以在保证视觉效果的前提下，有效减少瓦片数量（能够减少 50%）