示例中心
功能在线体验
控制台

高德 开发 数据可视化 JS API 参考手册 Loca 升级指南

更新时间:2018年11月21日

本文主要内容是介绍 Loca 新老版本功能差异,以及指导开发者如何进行版本升级。如果在新版版本升级过程中有任何问题,请在页面下方通过提交工单的方式与我们联系,我们会及时处理您的反馈。


版本说明

  1. 本次升级后,在引用 Loca 时需要显示指定版本号 v=x.x.x
  2. 之前没有显式指定版本号的情况,我们会将版本指向到 1.1.3。
  3. 1.1.3 版本稳定且绘制性能有大幅提升,我们将在此之前的版本统一升级至 1.1.3,以保证更好的体验。
  4. 我们强烈建议您升级至 JSAPI 最新版本(1.4.10 以上),以保证 Loca 最新功能的支持。过低版本的 JSAPI 会导致部分功能异常及报错。


如果在升级后发现有报错的情况,请查阅参考手册的最新使用方法。如果有更多问题可以通过工单联系我们。


差异说明

自 1.2.0 开始,Loca 进行了部分功能上的调整,具体内容如下:

  1. Loca 默认开启 3D 模式,全面支持 3D 模式的渲染。
    即创建 Loca 时的属性 viewMode 默认为 3D。如果开发者需要使用 2D 模式,请显式设置 viewMode: '2D'
    这里需要说明的是,自 v1.2.0 版本起,所有版本中的 2D 绘制功能将不再维护和升级。
  2. 部分 AttrOptions 属性名称变更,同时向下兼容 1.1.3 版本的配置项。
    升级至 1.2.0 的用户建议使用最新属性进行开发,1.1.3 版本的用户可以继续保持原属性不变。
    具体属性名对应见下表:

AttrOptions

v1.2.0+

v1.1.3-

差异说明

点、面类型填充颜色

color

fill


点类型边框颜色

borderColor

stroke


点类型边框宽度

borderWidth

lineWidth


线类型填充颜色

color

stroke


线类型宽度

borderWidth

lineWidth

仅 2D 模式下,支持线类型线宽设置,
3D 线宽统一为 1px,不可修改。

面类型边框宽度

borderWidth

lineWidth

仅 2D 模式下,支持面类型边框设置,
3D 面类型无边框。

混合模式

blendMode

3D 模式下无混合设置属性,该属性仅在 2D 模式下生效。



示例中心 功能
在线体验
常见问题