文档中心

概述

在地图上展示基于地理信息的热力数据。

目前支持的地理信息数据类型为百度坐标系（详见百度地图文档）的经纬度值。

特有静态属性

设备地图支持设定若干属性，可以在设计器右边栏的『样式设置』标签页中进行设置。除了尺寸位置边框等通用属性之外，设备地图还支持下列特定属性:

显示 \ 缩放

地图的缩放级别，3-18级，详见百度地图文档。

显示 \ 自动居中

开关，打开后会根据当前绑定的数据自动计算并设置地图的中心点。

显示 \ 城市列表

开关，打开后会在地图左上角显示城市选择器控件，方便用户进行地图跳转。

可视化 \ 颜色

配置热力数据点的颜色，可以在0-100的范围内添加任意数量的颜色，生成一段渐变色谱，在绘制热力数据点时，会根据数据点的权重比例，从这个渐变色谱中选取对应的颜色。 

可视化 \ 最大权重

权重的最大值，用来计算每一个数据点的权重比例。未指定则应用数据表权重列的最大值。

可视化 \ 不透明度

数据点的透明度，0-1之间的小数。0为完全透明、1为完全不透明。越不透明，视觉效果越『热』。

可视化 \ 辐射半径

数据点的辐射半径，单位为像素。更大的半径会引起更多的数据点重叠，重叠越多，视觉效果越『热』。

数据配置

设备地图需可以通过绑定数据表来展示数据可视化。

数据格式

数据表中应当包含[百度坐标系][1]经纬度值和热力权重的数据列，如下表中的『latitude』和『longitude』两列值分别为『纬度』值和『经度』值。

首先在『数据表』页面准备好如上数据，假设准备好的数据表命名为『热力图数据』。

接下来就可以在设计器中，通过设备地图组件的『数据配置』界面进行绑定。

数据绑定

在设计器中选择待绑定的设备地图组件，从右边栏中找到并点击『数据配置』标签页: 

• 数据表：【必填】要绑定的数据表，例如上一步创建的『地理位置数据』
• 经度：【必填】包含经度信息的列，例如示例中的『经度』
• 纬度：【必填】包含纬度信息的列，例如示例中的『纬度』
• 权重：【必填】包含热力值的列，用来给数据点进行热力着色，例如示例中的『权重』

动态属性

当仪表盘被集成使用时，可以在运行时通过SDK（使用方法见『物可视Player API文档』）设置下列设备地图属性。

ak

百度地图的API密钥。

设备地图默认的密钥可能会受到访问限制，这时用户应当自行申请地图密钥，并设置该属性。申请方法参见百度地图开放平台。

类型：string

动态事件

当仪表盘被集成使用时，可以在运行时通过SDK（使用方法见物可视Player API文档）监听下列设备地图事件。

currentZoom

地图缩放事件，用户通过任意方式改变地图缩放等级时触发。

事件参数：zoomLevel 改变后的缩放等级， number类型

currentCenter

地图中心点移动事件，用户通过任意方式改变地图中心点时触发。

事件参数：center 改变后的中心点， 百度地图Point类型