heatmap

方法列表

方法详细说明

createRenderer(params){Promise<HeatmapRendererResult>}

生成可直接应用于用于调用此方法的图层的 HeatmapRenderer 。渲染器使用视图背景的最佳颜色将点表示为连续表面。

当输入视图的范围内至少有一些点可见时，应调用此方法。如果视图中看不到任何点，则响应将不会返回有用的可视化效果

在大多数情况下，您将提供 layer, view, 和可选选项 field来生成此渲染器。在这种情况下，统计信息和数据的分布不是众所周知的，并且用户不知道要在可视化中使用什么颜色。

提供其他选项是为了方便更多涉及的自定义可视化创作应用程序。例如，如果已在另一个操作中生成了统计信息，则可以将统计信息对象传递给参数 statistics ，以避免对服务器进行额外的调用。

参数:

规范:

params Object 用于根据从给定字段返回的数据生成热图可视化效果的输入参数。有关每个参数的详细信息，请参阅下表。 规范: layer FeatureLayer|CSVLayer|GeoJSONLayer|WFSLayer|OGCFeatureLayer 为其生成可视化效果的点图层。 view MapView 将在其中呈现可视化效果的视图实例。 field String optional 将查询其数据以进行统计并用作数据驱动可视化的基础的字段的名称。 field 的值在热图中用作乘数，使具有高字段值的区域比具有低字段值的要素的区域更热。 heatmapScheme HeatmapScheme optional 在创作应用中，用户可以选择预定义的热图方案。将方案对象传递到此属性，以避免基于视图的背景获取方案对象。 statistics HeatmapStatisticsResult optional 从 heatmapStatistics 统计信息函数生成的统计信息对象。如果已生成该字段的统计信息，则将对象传递到此处以避免对服务器进行第二次统计信息查询。 fadeToTransparent Boolean optional 默认值: true 表示是否将下部色阶淡入透明色阶，以便在热图边缘创建模糊边界。 false 的值在下部色标上形成离散边界。 blurRadius Number optional 默认值: 10 以像素为单位的 blurRadius ，用于确定每个点的影响区域。模糊半径越大，表示点对周围点的影响更大。 minRatio Number optional 默认值: 0.01 在输出渲染器的 HeatmapRenderer.colorStops 中使用的最小 ratio  。 maxRatio Number optional 默认值: 1 在输出渲染器的 HeatmapRenderer.colorStops 中使用的最大 ratio  。 signal AbortSignal optional 允许可取消的请求。 如果取消，promise 将被拒绝，并出现名为 AbortError 的错误。 另请参阅 AbortController。

返回值:

类型	描述
Promise<HeatmapRendererResult>	解析为 HeatmapRendererResult 的实例。

示例代码:

let earthquakeLayer = new FeatureLayer({
  // url to a point dataset
});

// visualization based on field

let heatmapParams = {
  layer: earthquakeLayer,
  view: view,
  field: "magnitude"
};

// when the promise resolves, apply the renderer to the layer
heatmapRendererCreator.createRenderer(heatmapParams)
  .then(function(response){
    earthquakeLayer.renderer = response.renderer;
  });

类型定义

HeatmapRendererResult

createRenderer（） 方法的结果对象。有关每个属性的详细信息，请参阅下表。

属性:

renderer HeatmapRenderer 配置为最匹配视图背景和数据展开的呈现器对象。在图层的 renderer 属性上设置此项以更新其可视化效果。

scheme HeatmapScheme 渲染器使用的配色方案。

defaultValuesUsed Boolean 表示在图层中没有足够的数据和/或统计数据时是否使用默认值。当所有要素都具有相同的字段值或根本没有值时，通常使用默认值。

statistics HeatmapStatisticsResult 从查询返回给服务的基本统计信息，用于给定字段名称中的数据。

basemapId String 底图的 ID，用于确定热图的最佳色标。

basemapTheme String 表示输入视图底图的平均颜色是light还是dark。