location

方法概述

方法详细说明

createRenderer(params){Promise<RendererResult>}

生成一个渲染器，可直接将其应用于支持的图层。此渲染器包含单个符号，其中根据视图的背景选择最优的颜色。

在大多数情况下，您将提供 layer 和 view 来生成此渲染器。如果在 3D SceneView 中工作，则应使用 symbolType 选项。

参数

规范

params Object 用于生成基于位置的可视化的输入参数。各参数的详细信息见下表。 规范 layer FeatureLayer|SceneLayer|CSVLayer|GeoJSONLayer|WFSLayer|OGCFeatureLayer 为其生成可视化效果的图层。 view View optional 渲染输入图层的视图。此方法可检查视图的背景 (即底图、web 地图背景或视图容器)，以确定输出渲染器的最佳颜色。在实践中应始终设置此参数，但如果未提供，此方法将假定生成的渲染器显示在浅色背景上。 locationScheme LocationScheme optional 在制作应用程序中，用户可以选择预定义的位置方案。将方案对象传递到此属性，以避免基于视图的背景获取方案对象。 sizeOptimizationEnabled Boolean optional 默认值： false 仅适用于点和折线图层。指示符号大小是否应根据视图比例而变化。设置后，必须在 view 参数中提供有效的 MapView 实例。3D SceneViews 不支持此选项。 outlineOptimizationEnabled Boolean optional 默认值： false 仅适用于面图层。指示多边形轮廓宽度是否应根据视图比例而变化。设置后，必须在 view 参数中提供有效的 MapView 实例。3D SceneViews 不支持此选项。 symbolType String optional 默认值：2d 要生成的符号类型。这取决于您正在使用的视图和所需的可视化效果。对于具有 mesh 几何类型的图层，不需要指定此参数。下面描述了可能的值。 值 描述 2d 使用 2D 符号生成可视化，如 SimpleMarkerSymbol、SimpleLineSymbol 或 SimpleFillSymbol。如果为 MapView 中的数据生成可视化效果，请使用此选项。 3d-flat 使用具有平面符号图层的 3D 符号生成可视化，例如 IconSymbol3DLayer、LineSymbol3DLayer 或 FillSymbol3DLayer。如果为 SceneView 中的数据生成 2D 可视化，请使用此选项。 3d-volumetric 使用具有体积符号图层的 3D 符号生成可视化效果，例如 ObjectSymbol3DLayer、PathSymbol3DLayer 或 ExtrudeSymbol3DLayer。如果为 SceneView 中的数据生成 3D 可视化，请使用此选项。如果使用此选项，则必须为 view 参数提供 SceneView 实例。 3d-volumetric-uniform 使用具有体积符号图层的统一大小的 3D 符号生成可视化效果。如果为 SceneView 中的数据生成 3D 可视化效果，并且符号的大小应一致，例如球体，请使用此选项。如果使用此选项，则必须为 view 参数提供 SceneView 实例。 可能值："2d"|"3d-flat"|"3d-volumetric"|"3d-volumetric-uniform" colorMixMode String optional 默认值：replace 此选项仅适用于为网格 SceneLayers 生成渲染器。指定如何将符号的颜色应用于几何颜色/纹理。有关更多上下文，请参阅 FillSymbol3DLayer.material 文档。有关可能的值，请参见下表。 值 描述 tint 将符号 color 应用于不饱和的几何体/纹理颜色。 replace 移除几何/纹理颜色并应用符号color。 multiply 将几何图形/纹理颜色值与符号 color 值相乘。结果是颜色变深。与白色相乘可使几何图形颜色保持不变。 forBinning Boolean optional 指示生成的渲染器是否用于图格可视化。 signal AbortSignal optional 允许可取消的请求。如果取消，则承诺将被拒绝，并返回一个名为 AbortError 的错误。另请参见 AbortController。

返回

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

示例

let layer = new FeatureLayer({
  url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0"
});

// simple visualization to indicate features with a single symbol
let params = {
  layer: layer,
  view: view
};

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

类型定义

RendererResult

createRenderer() 方法的结果对象。各属性的详细信息见下表。

属性

renderer SimpleRenderer 配置有最适合与视图背景相匹配的单一颜色的简单渲染器。将此设置为 renderer 属性以更新其可视化效果。

locationScheme LocationScheme 渲染器使用的位置方案。

basemapId String 用于确定要素的最佳填充颜色的底图的 ID。

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