高德地图

卡片

卡片是指包裹图表组件的外层架构，可以理解为组件由卡片中基础元素（卡片标题、图表、卡片背景、卡片边框）和图表元素构成。

图3 卡片

• 背景
  • 背景色：设置组件卡片的背景颜色。
  • 边框：组件卡片边框设置，支持无边框、全边框和角边框三种样式。设置为全边框和角边框时，支持设置组件外圈边框的线型、圆角等。
  • 样式：选择图片时，图片显示的样式，支持普通、居中、拉伸和平铺四种样式。
  • 选择图片：使用本地的图片作为组件背景，支持新增目录和子目录，便于对图片进行分类管理。推荐使用JPG、JPEG、PNG或GIF格式的图片，且每张图片不能超过50MB。
• 特效：组件是否高亮显示，支持默认展示和跳转到页面时展示。
• 边距：组件中图表距离整个组件四边（上、下、左、右，如图2）的距离，默认为0，即铺满整个组件。
  • 上边距：图表到组件边框顶部的距离。
  • 右边距：图表到组件边框右侧的距离。
  • 下边距：图表到组件边框底部的距离。
  • 左边距：图表到组件边框左侧的距离。
• 布局模板 > 地图样式：在下拉框中选择地图的样式，如“控件+标签图层”、默认样式、“地图行政区+图标图层”等。

配置

在配置中，设置地图组件的基本信息、地图样式、地图控件和地图控件等。

图4 配置

• 地图基本配置
  • 地图密钥：输入地图的服务密钥，请参考高德开放平台中操作自行到官网申请。
  • 安全密钥：如果您的地图密钥是在2021年12月02日以后申请的key，需要配合安全密钥一起使用。如何使用安全密钥，请参见JS API 安全密钥使用。
  • 地图中心：设置地图中心的设置类型，支持自定义和行政区。
  • 行政区编码：设置行政区或行政区对应的编码，如何下载行政区编码，请参见Web服务 API 相关下载。“地图中心”设置为“行政区”时，才显示该配置。
  • 地图中心经度：设置地图中心点的经度。“地图中心”设置为“自定义”时，才显示该配置。
  • 地图中心纬度：设置地图的中心点的纬度。“地图中心”设置为“自定义”时，才显示该配置。
  • 缩放级别：设置地图的缩放层级。“地图中心”设置为“自定义”时，才显示该配置。
  • 缩放范围：设置地图可以缩放的范围，取值范围为2~26。
  • POI显示：是否开启POI显示，关闭后不会显示全部地图文字和POI信息。
• 地图样式
  • 底图样式：设置底图的样式类型，支持标准地图和卫星图。
  • 显示要素：设置地图显示的元素，支持区域面、道路、建筑物和标注。当“底图样式”设置为“标准地图”时，才显示该配置项。
  • 显示路网：是否显示路网，当“底图样式”设置为“卫星图”时，才显示该配置项。
  • 实时路况：是否显示实时路况。
  • 视图模式：设置地图的视图模式，支持2D平面图和3D平面图。
  • 俯仰角度：设置地图的初始化俯仰角度。“视图模式”设置为“3D平面图”时，才显示该配置项。
  • 地图样式：设置地图样式模板，支持标准模板和自定义模板。
  • 标准模板：设置地图标准的样式模板，可选择高德地图支持的11种模板，即标准、幻影黑、月光银、远山黛、草色青、雅士灰、涂鸦、马卡龙、靛青蓝、极夜紫和酱籽。
  • 自定义地图：根据实际需求自定义地图。 如何自定义地图，请参见自定义地图。
• 区域掩模
  • 区域掩模：是否显示区域内的掩模。开启后，只显示区域内的图层和覆盖物。
  • 掩模边界：掩模边界信息的获取方式，支持直接设置行政区和geojson两种方式。
  • 行政区编码：设置行政区或行政区对应的编码，如何下载行政区编码，请参见Web服务 API 相关下载。“掩模边界”设置为“行政区”时，才显示该配置项。
  • 选择数据：通过上传geojson来设置掩模的边界信息。“掩模边界”设置为“geojson”时，才显示该配置项。
  • 掩模边框：设置掩模边框的颜色和大小。
• 地图行政区
  • 行政区：是否高亮显示行政区。
  • 行政区范围：设置行政区范围的获取方式，支持直接设置行政区和geojson两种方式。
  • 行政区编码：设置行政区或行政区对应的编码，如何下载行政区编码，请参见Web服务 API 相关下载。“行政区范围”设置为“行政区”时，才显示该配置项。
  • 选择层级：设置高亮行政区的下钻范围，支持显示省级、显示市级和显示区级。选择的层级必须低于设置的行政区，例如，行政区编码设置为A市，选择层级只能设置为市级或者区级才会有效。“行政区范围”设置为“行政区”时，才显示该配置项。
  • 选择数据：通过上传geojson，来设置行政区范围。“行政区范围”设置为“geojson”时，才显示该配置项。
  • 层级颜色：设置高亮行政区的颜色。
  • 行政区边框：设置高亮行政区的边框颜色。
• 地图控件
  • 缩放：开启后，地图右下角会添加缩放控件。
    图5 开启缩放效果
    
  • 旋转：开启后，地图右上角会添加旋转控件。
    图6 开启旋转效果
    
  • 比例尺：开启后，地图左下角会添加比例尺控件。
    图7 开启比例尺效果
    
• 地图控件
  • 拖拽：设置地图是否支持拖拽。
  • 缩放：设置地图是否支持缩放。
  • 双击放大：设置地图是否支持双击放大。“缩放”设置为“开启”时，才显示该配置项。
  • 旋转：设置地图是否支持旋转。

图形

图形是指组件中，实现数据可视化的具体图形表达元素，例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。

图8 图形

• 统一配置
  • 显示范围：统一设置图层的显示范围，地图缩放级别在该范围内时，显示对应图层。
  • 图层透明度：统一设置图层的透明度。
• 图层：单击“新增图层”，可新建飞线图层、区域热力图层、图标图层、标签图层和3D柱状图层。
  图9 新建飞线图层
  
  • 基本配置：
    • 类型：固定为飞线图层
    • 图层：显示或隐藏图层。
    • 显示范围：设置图层的显示范围，地图缩放级别在该范围内时，显示对应图层。
    • 图层透明度：设置图层的透明度。
  • 图层样式
    • 颜色样式：设置飞线的颜色样式，支持单色和渐变色。
    • 显示类型：设置飞线颜色的显示类型，支持均分显示和区间显示。
    • 颜色设置：根据颜色设置的数量，会将飞线值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的颜色。“显示类型”设置为“均分显示”时，才显示该配置项。
    • 填充颜色：根据设置不同的区间，当飞线值落在对应的区间内，显示对应的颜色值。区域范围外的飞线将不显示。“显示类型”设置为“区间显示”时，才显示该配置项。
    • 选中色：设置飞线鼠标悬浮颜色，同时也是交互动作中，高亮飞线的颜色。
    • 飞线弧度：设置飞线的弧度，只在3D模式下生效。
    • 起点宽度：设置飞线的起点宽度。
    • 终点宽度：设置飞线的终点宽度。
  • 动画效果
    • 脉冲效果：是否开启飞线的脉冲效果。
    • 脉冲点长度：设置脉冲长度，开启脉冲效果后显示该配置项。
    • 脉冲点速度：设置脉冲速度，开启脉冲效果后显示该配置项。
    • 头部颜色：设置脉冲的头部颜色，开启脉冲效果后显示该配置项。
    • 尾部颜色：设置脉冲的尾部颜色，开启脉冲效果后显示该配置项。
    • 气泡效果：是否开启飞线终点的气泡效果。
    • 气泡样式：设置气泡的颜色，支持蓝色、黄色、绿色、红色，开启气泡效果后显示该配置项。
    • 气泡半径：设置气泡的半径，开启气泡效果后显示该配置项。
    • 动画速度：设置气泡的动画速度，开启气泡效果后显示该配置项。
  • 图层标签
    • 标签悬浮：飞线鼠标悬浮时，是否显示标签。
    • 系列名：标签是否显示系列名。
    • 系列名内容：请输入系列名内容。
    • 系列名字体：设置系列名的字体、颜色和大小等。
    • 数值：标签是否显示数值，对应静态数据中的“value”字段。
    • 数值字体：设置数值的字体、颜色和大小等。
    • 数值显示：是否显示最大值、最小值。选中后，对应最大值最小值的标签背景色、字体颜色将会发生变化。
  图10 新建区域热力图层
  
  • 基本配置
    • 类型：固定为标签图层。
    • 图层：显示或隐藏图层。
    • 显示范围：设置图层的显示范围，地图缩放级别在该范围内时，显示对应图层。
    • 图层透明度：设置图层的透明度。
  • 图层样式
    • 显示类型：设置图标的显示类型，支持均分显示和区间显示。
    • 颜色设置：根据颜色设置的数量，会将值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的颜色。“显示类型”设置为“均分显示”时，才显示该配置项。
    • 填充颜色：根据设置不同的区间，当值落在对应的区间内，显示对应的颜色值，区域范围外的将不显示。“显示类型”设置为“区间显示”时，才显示该配置项。
    • 选中色：设置鼠标单击和悬浮颜色，同时也是交互动作中，高亮区域的颜色。
    • 区域边框：设置行政边界的颜色和边框大小。
  • 图层标签
    • 标签：是否开启图标标签。
    • 标签悬浮：开启时，图标鼠标悬浮时显示标签。关闭时，标签常显。
    • 系列名：标签是否显示系列名，对应静态数据中的“label”字段。
    • 系列名字体：设置系列名的字体、大小和颜色等。“标签悬浮”设置为“开启”时，显示该配置项。
    • 数值：标签是否显示数值，对应静态数据中的“value”字段。
    • 数值字体：设置数值的字体、大小和颜色等。“标签悬浮”设置为“开启”时，显示该配置项。
    • 数值显示：是否显示最大值、最小值。选中后，对应最大值最小值的标签背景色、字体颜色将会发生变化。
  图11 新建图标图层
  
  • 基本配置
    • 类型：固定为图标图层。
    • 图层：显示或隐藏图层。
    • 显示范围：设置图层的显示范围，地图缩放级别在该范围内时，显示对应图层。
    • 图层透明度：设置图层的透明度。
    • 标签避让：开启后，地图中重叠的图标会避让。
  • 图层样式
    • 显示类型：设置图标的显示类型，支持均分显示和区间显示。
    • 图标图片：“显示类型”设置为“均分显示”时，会根据图标图片的数量，将图标值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的图标。“显示类型”设置为“区间显示”时，可设置不同的区间，当图标值落在对应的区间内，显示对应的颜色值，区域范围外的图标将不显示。
    • 悬浮放大：是否开启鼠标悬浮后图标放大。悬浮方法和标签避让同时开启会影响显示效果。
    • 图片宽度：设置图片的宽度。
    • 图片高度：设置图片的高度。
    • 上下偏移：设置图标根据点经纬度的上下偏移。
    • 左右偏移：设置图标根据点经纬度的左右偏移。
  • 图层标签
    • 标签：是否开启图标标签。
    • 标签悬浮：开启时，图标鼠标悬浮时显示标签。关闭时，标签常显。
    • 系列名：标签是否显示系列名，对应静态数据中的“label”字段。
    • 系列名字体：设置系列名的字体、大小和颜色等。“标签悬浮”设置为“开启”时，显示该配置项。
    • 数值：标签是否显示数值，对应静态数据中的“value”字段。
    • 数值字体：设置数值字体。“标签悬浮”设置为“开启”是，显示该配置项。
    • 文字大小：设置常显标签的文字大小。“标签悬浮”设置为“关闭”时，显示该配置项。
    • 文字颜色：设置常显标签的文字颜色。“标签悬浮”设置为“关闭”时，显示该配置项。
    • 数值显示：是否显示最大值、最小值。选中后，对应最大值最小值的标签背景色、字体颜色将会发生变化。
  图12 新建标签图层
  
  • 基本配置
    • 类型：固定为标签图层。
    • 图层：显示或隐藏图层。
    • 显示范围：设置图层的显示范围，地图缩放级别在该范围内时，显示对应图层。
    • 图层透明度：设置图层的透明度。
  • 标签样式
    • 标签宽度：设置标签的宽度。
    • 溢出文本：设置文本溢出时的显示方式，支持省略和换行。
    • 文字对齐方式：设置文本对齐方式，支持左对齐、居中和右对齐。
    • 系列名：标签是否显示系列名，对应静态数据中的“label”字段。
    • 系列名字体：设置系列名的字体、大小和颜色等。
    • 数值：标签是否显示数值，对应静态数据中的“value”字段。
    • 数值字体：设置数值的字体、大小和颜色等。
    • 背景样式：设置标签的背景样式，支持颜色和图片。
    • 显示类型：设置标签背景的显示类型，支持均分显示和区间显示。
    • 颜色设置：“显示类型”设置为“均分显示”时，会根据颜色设置的数量，将标签值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的背景颜色。“显示类型”设置为“区间显示”时，可设置不同的区间，当标签值落在对应的区间内，显示对应的背景颜色，区域范围外的图标将不显示。
    • 填充方式：图标的填充方式，支持普通、居中、拉伸和平铺。“背景样式”设置为“图片”时，显示该配置项。
    • 背景图片：“显示类型”设置为“均分显示”时，会根据背景颜色的数量，将标签值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的背景图片。“显示类型”设置为“区间显示”时，可设置不同的区间，当标签值落在对应的区间内，显示对应的背景图片，区域范围外的图标将不显示。
    • 选中色：设置标签鼠标悬浮时的字体颜色，同时也是交互动作中，高亮标签的颜色。
    • 上下偏移：设置标签根据点经纬度的上下偏移。
    • 左右偏移：设置标签根据点经纬度的左右偏移。
  • 标签图标
    • 标签图标：是否显示标签图标。
    • 显示类型： 标签图标的显示类型，支持均分显示和区间显示。
    • 填充方式：图标的填充方式，支持普通、居中、拉伸和平铺。
    • 图标图片1：“显示类型”设置为“均分显示”时，会根据图标图片的数量，会将标签值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的图标。“显示类型”设置为“区间显示”时，可设置不同的区间，当标签值落在对应的区间内，显示对应的图标，区域范围外的图标将不显示。
    • 图片宽度：设置图片的宽度。
    • 图片高度：设置图片的高度。
    • 上下偏移：设置图标根据点经纬度的上下偏移。
    • 左右偏移：设置图标根据点经纬度的左右偏移。
  图13 新建柱状图层
  
  • 基本配置
    • 类型：固定为标签图层。
    • 图层：显示或隐藏图层。
    • 显示范围：设置图层的显示范围，地图缩放级别在该范围内时，显示对应图层。
    • 图层透明度：设置图层的透明度。
  • 图层样式
    • 显示类型：设置图标的显示类型，支持均分显示和区间显示。
    • 颜色设置：根据颜色设置的数量，会将值从最小值到最大值的范围进行均分，落在不同范围的值，将显示对应的颜色。“显示类型”设置为“均分显示”时，才显示该配置项。
    • 填充颜色：根据设置不同的区间，当值落在对应的区间内，显示对应的颜色值，区域范围外的将不显示。“显示类型”设置为“区间显示”时，才显示该配置项。
    • 选中色：设置鼠标悬浮和单击颜色，同时也是交互动作中，高亮柱体的颜色。
    • 边数：棱柱的边数，默认为“3”，如果希望做成圆柱体效果，可以尝试此字段设置一个较大的值，例如32。
    • 单位：图层的单位，支持像素和米。
    • 半径：棱柱的半径。
    • 高度范围：棱柱的高度。
  • 图层标签
    • 标签：是否开启图标标签。
    • 标签悬浮：开启时，图标鼠标悬浮时显示标签。关闭时，标签常显。
    • 系列名：标签是否显示系列名，对应静态数据中的“label”字段。
    • 系列名字体：设置系列名的字体、大小和颜色等。“标签悬浮”设置为“开启”时，显示该配置项。
    • 数值：标签是否显示数值，对应静态数据中的“value”字段。
    • 数值字体：设置数值的字体、大小和颜色。“标签悬浮”设置为“开启”时，显示该配置项。
    • 数值显示：是否显示最大值、最小值。选中后，对应最大值最小值的标签背景色、字体颜色将会发生变化。

镜头编辑

在弹窗上拖拽、缩放、旋转 (仅3D视图) 到期望位置后保存，组件的相应配置项会跟随更改。

图14 镜头编辑

交互

在交互中，配置高德地图与其他组件或页面之间的交互能力。更多交互介绍，请参见交互设置。