SuperMap.REST.ThemeGraph

统计专题图。 统计专题图通过为每个要素或记录绘制统计图来反映其对应的专题值的大小。它可同时表示多个字段属性信息,在区域本身与各区域之间形成横向和纵向的对比。 统计专题图多用于具有相关数量特征的地图上,比如表示不同地区多年的粮食产量、GDP、人口等,不同时段客运量、地铁流量等。允许一次分析多个数值型变量, 即可以将多个变量的值绘制在一个统计图上。目前提供的统计图类型有:面积图,阶梯图,折线图,点状图,柱状图,三维柱状图,饼图,三维饼图,玫瑰图, 三维玫瑰图,堆叠柱状图以及三维堆叠柱状图。下图为一幅渤海地区2000年城乡人口比例的统计专题图:

Inherits from

Summary
SuperMap.REST.ThemeGraph 统计专题图。 统计专题图通过为每个要素或记录绘制统计图来反映其对应的专题值的大小。它可同时表示多个字段属性信息,在区域本身与各区域之间形成横向和纵向的对比。 统计专题图多用于具有相关数量特征的地图上,比如表示不同地区多年的粮食产量、GDP、人口等,不同时段客运量、地铁流量等。允许一次分析多个数值型变量, 即可以将多个变量的值绘制在一个统计图上。目前提供的统计图类型有:面积图,阶梯图,折线图,点状图,柱状图,三维柱状图,饼图,三维饼图,玫瑰图, 三维玫瑰图,堆叠柱状图以及三维堆叠柱状图。下图为一幅渤海地区2000年城乡人口比例的统计专题图:
Properties
barWidth {Number} 柱状专题图中每一个柱的宽度。使用地图坐标单位,默认值为0。 只有选择的统计图类型为柱状图(柱状图、三维柱状图、堆叠柱状图、三维堆叠柱状图)时,此项才可设置。
flow {SuperMap.REST.ThemeFlow} 统计专题图流动显示与牵引线设置。 通过该字段可以设置统计符号是否流动显示和牵引线风格。
graduatedMode {SuperMap.REST.GraduatedMode} 统计图中地理要素的值与图表尺寸间的映射关系(常数、对数、平方根),即分级方式。 默认值为 SuperMap.REST.GraduatedMode.Constant。 分级主要是为了减少制作统计专题图中数据大小之间的差异,使得统计图的视觉效果比较好,同时不同类别之间的比较也还是有意义的。 提供三种分级模式:常数、对数和平方根,对于有值为负数的字段,不可以采用对数和平方根的分级方式。不同的等级方式用于确定符号大小的数值是不相同的。
graphAxes {SuperMap.REST.ThemeGraphAxes} 用于设置统计图中坐标轴样式相关信息,如坐标轴颜色、是否显示、坐标文本样式等。
graphAxesTextDisplayMode {SuperMap.REST.GraphAxesTextDisplayMode} 统计专题图坐标轴文本显示模式 。默认值 SuperMap.REST.GraphAxesTextDisplayMode.NONE。
graphSize {SuperMap.REST.ThemeGraphSize} 用于设置统计符号的最大最小尺寸。
graphSizeFixed {Boolean} 缩放地图时统计图符号是否固定大小。默认值为 false,即统计图符号将随地图缩放。
graphText {SuperMap.REST.ThemeGraphText} 统计图上的文字是否可以见以及文字标注风格。
graphType {SuperMap.REST.ThemeGraphType} 统计专题图类型。SuperMap 提供了多种类型的统计图, 分别为面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、堆叠柱状图、三维堆叠柱状图、环状图。默认为面积图。
items {Array(SuperMap.REST.ThemeGraphItem)} 统计专题图子项集合。必设字段。 统计专题图可以基于多个变量,反映多种属性,即可以将多个专题变量的值绘制在一个统计图上。每一个专题变量对应的统计图即为一个专题图子项。 对于每个专题图子项可以为其设置标题、风格,甚至可以将该子项再制作成范围分段专题图。
memoryKeys {Array(Integer)} 以内存数组方式制作专题图时的键数组。 键数组内的数值代表 SmID 值,它与 ThemeGraphItem 类中的值数组(ThemeGraphItem.memoryDoubleValues) 要关联起来应用。 键数组中数值的个数必须要与值数组的数值个数一致。值数组中的值将代替原来的专题值来制作统计专题图。 目前所有的专题图都支持以内存数组的方式制作专题图,但统计专题图与其他专题图指定内存数组的方式不同, 统计专题图使用 memoryKeys 指定内存数组,而其他专题图则使用 memoryData 来指定内存数组。
negativeDisplayed {Boolean} 专题图中是否显示属性为负值的数据。true 表示显示;默认为 false 即不显示。
offset {SuperMap.REST.ThemeOffset} 用于设置统计图相对于要素内点的偏移量。
overlapAvoided {Boolean} 统计图是否采用避让方式显示。 1.对数据集制作统计专题图:当统计图采用避让方式显示时,如果 overlapAvoided 为 true,则在统计图重叠度很大的情况下, 会出现无法完全避免统计图重叠的现象;如果 overlapAvoided 为 false,会过滤掉一些统计图,从而保证所有的统计图均不重叠。 2.对数据集同时制作统计专题图和标签专题图:当统计图不显示子项文本时,标签专题图的标签即使和统计图重叠,两者也都可正常显示; 当统计图显示子项文本时,如果统计图中的子项文本和标签专题图中的标签不重叠,则两者均正常显示;如果重叠,则会过滤掉统计图的子项文本,只显示标签。
roseAngle {Number} 统计图中玫瑰图或三维玫瑰图用于等分的角度,默认为0度,精确到0.1度。在角度为0或者大于360度的情况下均使用360度来等分制作统计图的字段数。
startAngle {Number} 饼状统计图扇形的起始角度。默认为0度,精确到0.1度,以水平方向为正向。只有选择的统计图类型为饼状图(饼图、三维饼图、玫瑰图、三维玫瑰图)时,此项才可设置。
Constructor
SuperMap.REST.ThemeGraph 统计专题图构造函数。
Functions
destroy 释放资源,将引用资源的属性置空。

Properties

barWidth

{Number} 柱状专题图中每一个柱的宽度。使用地图坐标单位,默认值为0。 只有选择的统计图类型为柱状图(柱状图、三维柱状图、堆叠柱状图、三维堆叠柱状图)时,此项才可设置。

flow

{SuperMap.REST.ThemeFlow} 统计专题图流动显示与牵引线设置。 通过该字段可以设置统计符号是否流动显示和牵引线风格。

graduatedMode

{SuperMap.REST.GraduatedMode} 统计图中地理要素的值与图表尺寸间的映射关系(常数、对数、平方根),即分级方式。 默认值为 SuperMap.REST.GraduatedMode.Constant。 分级主要是为了减少制作统计专题图中数据大小之间的差异,使得统计图的视觉效果比较好,同时不同类别之间的比较也还是有意义的。 提供三种分级模式:常数、对数和平方根,对于有值为负数的字段,不可以采用对数和平方根的分级方式。不同的等级方式用于确定符号大小的数值是不相同的。

graphAxes

{SuperMap.REST.ThemeGraphAxes} 用于设置统计图中坐标轴样式相关信息,如坐标轴颜色、是否显示、坐标文本样式等。

graphSize

{SuperMap.REST.ThemeGraphSize} 用于设置统计符号的最大最小尺寸。

graphSizeFixed

{Boolean} 缩放地图时统计图符号是否固定大小。默认值为 false,即统计图符号将随地图缩放。

graphText

{SuperMap.REST.ThemeGraphText} 统计图上的文字是否可以见以及文字标注风格。

graphType

{SuperMap.REST.ThemeGraphType} 统计专题图类型。SuperMap 提供了多种类型的统计图, 分别为面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、堆叠柱状图、三维堆叠柱状图、环状图。默认为面积图。

graphAxesTextDisplayMode

{SuperMap.REST.GraphAxesTextDisplayMode} 统计专题图坐标轴文本显示模式 。默认值 SuperMap.REST.GraphAxesTextDisplayMode.NONE。

items

{Array(SuperMap.REST.ThemeGraphItem)} 统计专题图子项集合。必设字段。 统计专题图可以基于多个变量,反映多种属性,即可以将多个专题变量的值绘制在一个统计图上。每一个专题变量对应的统计图即为一个专题图子项。 对于每个专题图子项可以为其设置标题、风格,甚至可以将该子项再制作成范围分段专题图。

memoryKeys

{Array(Integer)} 以内存数组方式制作专题图时的键数组。 键数组内的数值代表 SmID 值,它与 ThemeGraphItem 类中的值数组(ThemeGraphItem.memoryDoubleValues) 要关联起来应用。 键数组中数值的个数必须要与值数组的数值个数一致。值数组中的值将代替原来的专题值来制作统计专题图。 目前所有的专题图都支持以内存数组的方式制作专题图,但统计专题图与其他专题图指定内存数组的方式不同, 统计专题图使用 memoryKeys 指定内存数组,而其他专题图则使用 memoryData 来指定内存数组。

 memoryKeys的使用方法如:
  function addThemeGraph() {
     removeTheme();
       //创建统计专题图对象,ThemeGraph 必设 items。
      //专题图参数 ThemeParameters 必设 theme(即以设置好的分段专题图对象)、dataSourceName 和 datasetName
     var style1 = new SuperMap.REST.ServerStyle({
                  fillForeColor: new SuperMap.REST.ServerColor(92,73,234),
                  lineWidth: 0.1
              }),
              style2 = new SuperMap.REST.ServerStyle({
                  fillForeColor: new SuperMap.REST.ServerColor(211,111,240),
                  lineWidth: 0.1
              }),
              item1 = new SuperMap.REST.ThemeGraphItem({
                  memoryDoubleValues:[1.18,0.95,0.37,1.31,0.8,1.5],
                 caption: "1992-1995人口增长率",
                 graphExpression: "Pop_Rate95",
                  uniformStyle: style1
              }),
              item2 = new SuperMap.REST.ThemeGraphItem({
              //以内存数组方式制作专题图时的值数组
                  memoryDoubleValues:[2.71,0,0.74,3.1,2.2,3.5],
                  caption: "1995-1999人口增长率",  //专题图子项的名称
                  graphExpression: "Pop_Rate99",  //统计专题图的专题变量
                  uniformStyle: style2      //统计专题图子项的显示风格
              }),
              themeGraph  = new SuperMap.REST.ThemeGraph({
              //以内存数组方式制作专题图时的键数组,键数组内的数值代表 SmID 值
                   memoryKeys:[1,2,4,8,10,12],
                  items: new Array(item1,item2),
                  barWidth: 0.03,
                   //统计图中地理要素的值与图表尺寸间的映射关系为平方根
                  graduatedMode: SuperMap.REST.GraduatedMode.SQUAREROOT,
                  //graphAxes用于设置统计图中坐标轴样式相关信息
                  graphAxes: new SuperMap.REST.ThemeGraphAxes({
                      axesDisplayed: true
                  }),
                  graphSize: new SuperMap.REST.ThemeGraphSize({
                      maxGraphSize: 1,
                      minGraphSize: 0.35
                  }),
                  //统计图上的文字是否可以见以及文字标注风格
                  graphText: new SuperMap.REST.ThemeGraphText({
                      graphTextDisplayed: true,
                      graphTextFormat: SuperMap.REST.ThemeGraphTextFormat.VALUE,
                      graphTextStyle: new SuperMap.REST.ServerTextStyle({
                          sizeFixed: true,
                          fontHeight: 9,
                          fontWidth: 5
                      })
                  }),
                  //统计专题图类型为三维柱状图
                  graphType: SuperMap.REST.ThemeGraphType.BAR3D
              }),
//专题图参数对象
              themeParameters = new SuperMap.REST.ThemeParameters({
                  themes: [themeGraph],
                  dataSourceNames: ["Jingjin"],
                  datasetNames: ["BaseMap_R"]
              }),
   //与服务端交互
              themeService=new SuperMap.REST.ThemeService(url, {
                  eventListeners: {
                      "processCompleted": ThemeCompleted,
                       "processFailed": themeFailed
                 }
             });
      themeService.processAsync(themeParameters);
  }

negativeDisplayed

{Boolean} 专题图中是否显示属性为负值的数据。true 表示显示;默认为 false 即不显示。

offset

{SuperMap.REST.ThemeOffset} 用于设置统计图相对于要素内点的偏移量。

overlapAvoided

{Boolean} 统计图是否采用避让方式显示。 1.对数据集制作统计专题图:当统计图采用避让方式显示时,如果 overlapAvoided 为 true,则在统计图重叠度很大的情况下, 会出现无法完全避免统计图重叠的现象;如果 overlapAvoided 为 false,会过滤掉一些统计图,从而保证所有的统计图均不重叠。 2.对数据集同时制作统计专题图和标签专题图:当统计图不显示子项文本时,标签专题图的标签即使和统计图重叠,两者也都可正常显示; 当统计图显示子项文本时,如果统计图中的子项文本和标签专题图中的标签不重叠,则两者均正常显示;如果重叠,则会过滤掉统计图的子项文本,只显示标签。

roseAngle

{Number} 统计图中玫瑰图或三维玫瑰图用于等分的角度,默认为0度,精确到0.1度。在角度为0或者大于360度的情况下均使用360度来等分制作统计图的字段数。

startAngle

{Number} 饼状统计图扇形的起始角度。默认为0度,精确到0.1度,以水平方向为正向。只有选择的统计图类型为饼状图(饼图、三维饼图、玫瑰图、三维玫瑰图)时,此项才可设置。

Constructor

SuperMap.REST.ThemeGraph

统计专题图构造函数。

Parameters

options {Object} 参数。

Allowed options properties

barWidth {Number} 柱状专题图中每一个柱的宽度。
flow {SuperMap.REST.ThemeFlow} 统计专题图流动显示与牵引线设置。
graduatedMode {SuperMap.REST.GraduatedMode} 统计图中地理要素的值与图表尺寸间的映射关系。
graphAxes {SuperMap.REST.ThemeGraphAxes} 统计图中坐标轴样式相关信息。
graphSize {SuperMap.REST.ThemeGraphSize} 统计符号的最大最小尺寸。
graphSizeFixed {Boolean} 缩放地图时统计图符号是否固定大小。
graphText {SuperMap.REST.ThemeGraphText} 统计图上的文字是否可以见以及文字标注风格。
graphType {SuperMap.REST.ThemeGraphType} 统计专题图类型。
items {Array(SuperMap.REST.ThemeGraphItem)} 统计专题图子项集合。
memoryKeys {Array(Integer)} 以内存数组方式制作专题图时的键数组。
negativeDisplayed {Boolean} 专题图中是否显示属性为负值的数据。
offset {SuperMap.REST.ThemeOffset} 统计图相对于要素内点的偏移量。
overlapAvoided {Boolean} 统计图是否采用避让方式显示。
roseAngle {Number} 统计图中玫瑰图或三维玫瑰图用于等分的角度。
startAngle {Number} 饼状统计图扇形的起始角度。

Functions

destroy

destroy: function()

释放资源,将引用资源的属性置空。

标签或符号流动显示和牵引线风格设置类。 通过该类可以设置专题图中符号是否流动显示、是否使用牵引线以及牵引线风格。
{Object} 专题图分级模式枚举类。 CONSTANT: “CONSTANT”,
统计专题图坐标轴样式类。 该类用于设置统计图中坐标轴样式相关信息,如坐标轴颜色、是否显示、坐标文本样式等。
统计专题图符号尺寸类。 通过该类可以设置统计专题图符号最小和最大的基准尺寸。专题图表的尺寸大小与基准值、分级方式及专题字段值的大小都有着紧密联系。 它是利用指定的分级方式,最大基准值、最小基准值以及字段的最大值和最小值计算统计图中各个值对应的图表尺寸的大小。
统计图文字标注风格类。 通过该类可以设置统计图表中文字可见性以及标注风格。
{Object} 统计专题图类型枚举类。
{Object} 统计专题图坐标轴文本显示模式。 ALL: “ALL”, 显示全部文本
统计专题图子项类。 统计专题图可以基于多个变量,反映多种属性,即可以将多个专题变量的值绘制在一个统计图上。每一个专题变量对应的统计图即为一个专题图子项。 该类用来设置每个统计专题图子项的名称,专题变量,显示风格,甚至可以将该子项再制作成范围分段专题图。
专题图中文本或符号相对于要素内点的偏移量设置类。 通过该类可以设置专题图中标记文本或符号的偏移量以及偏移量是否随地图缩放而改变。
destroy: function()
释放资源,将引用资源的属性置空。
专题图基类。
Close