JavaScript ArcGIS SceneLayer用法及代码示例

AMD: require(["esri/layers/SceneLayer"], (SceneLayer) => { /* code goes here */ });

ESM: import SceneLayer from "@arcgis/core/layers/SceneLayer";

类： esri/layers/SceneLayer

继承: SceneLayer > Layer > Accessor

自从：用于 JavaScript 4.0 的 ArcGIS API

• Overview
• 发布SceneLayer
• 数据可视化
• 过滤数据
• Popups
• Querying
• 获取SceneLayers的几何/范围

概述

SceneLayer 是一种图层类型，专为 on-demand 流式传输并在 SceneView 中显示大量数据而设计。 SceneLayers 支持两种几何类型：Point 和 3D 对象(例如建筑物)。

您可以在 searching the gallery 的 ArcGIS Online 中找到许多 SceneLayers 的样本。

发布SceneLayer

SceneLayer 显示来自 Scene Service 的数据。场景服务可以以适合网络流的开放格式保存大量特征。 SceneLayer 逐渐加载这些特征，从粗略的表示开始，并根据close-up 视图的需要将它们细化到更高的细节。

let sceneLayer = new SceneLayer({
  url: "https://scene.arcgis.com/arcgis/rest/services/Hosted/Building_Hamburg/SceneServer/layers/0"
});

let sceneLayer = new SceneLayer({
 portalItem: {
   id: "6fce72d1a3df4b309a317f1e2faae05e"
 }
});

数据可视化

就像其他层一样，SceneLayers 可以使用渲染器进行可视化。可以使用 MeshSymbol3D 设置 3D 对象的样式。可以将 FillSymbol3DLayer 添加到 MeshSymbol3D 以从 SceneLayer 可视化 3D 对象：

let symbol = {
  type: "mesh-3d",  // autocasts as new MeshSymbol3D()
  symbolLayers: [{
    type: "fill",  // autocasts as new FillSymbol3DLayer()
    material: { color: "red" }
  }]
};

sceneLayer.renderer = {
  type: "simple",  // autocasts as new SimpleRenderer()
  symbol: symbol
};

过滤数据

SceneLayers 可以使用 SQL where 子句进行过滤。过滤是通过definitionExpression 属性实现的。此属性在客户端上使用 SceneLayer 缓存属性进行评估，并且仅支持 standardized SQL 。

let layer = new SceneLayer({
 url: "http://scene.arcgis.com/arcgis/rest/services/Hosted/Building_Hamburg/SceneServer/layers/0",
 definitionExpression: "usage = 'Residential' AND totalHeight < 5"
});

另一种过滤数据的方法是在 SceneLayerView 上使用 FeatureFilter。这将只显示满足过滤条件的特征。设置 geometry 和 spatialRelationship 允许您根据与传入几何的空间关系过滤要素。目前仅支持 contains、intersects 或 disjoint 类型的空间关系。

有关详细信息，请参阅 Filter features by geometry with SceneLayer 示例。

弹出窗口

点和 3D 对象 SceneLayers 可以使用 popupTemplate 属性自定义弹出内容。具有关联要素图层的 SceneLayer 将查询关联要素图层的属性。对于仅具有缓存属性的SceneLayer，属性来自缓存。还支持 popupTemplate 中 expressionInfo 的 Arcade 表达式。

查询

SceneLayer 和 SceneLayerView 都支持查询，但行为不同。

查询 SceneLayer 将从关联要素图层中的属性中检索结果。如果图层没有关联的要素图层，则查询将被拒绝并出现错误。图层上的查询函数强大，因为它们是基于SceneLayer 中的所有函数进行的，并且它们还支持高级查询。当 spatialRelationship 设置为 intersects 、 contains 或 disjoint 时，支持空间查询。

获取SceneLayers的几何/范围

3D 对象 SceneLayers 不返回原始几何图形，因为这是二进制格式。要获取空间信息，您可以查询 SceneLayer 中要素的 2D 范围或 3D 范围。可以使用 SceneLayer 上的 queryExtent() 方法检索所有要素(甚至尚未加载的要素)的 2D 范围。仅当图层具有关联的要素图层时，此方法才会成功。只能通过使用 SceneLayerView 上的 queryExtent() 方法来查询 3D 范围以获取已加载的要素。

当在任何查询方法上将returnGeometry设置为true时，点SceneLayers返回几何图形。此外，可以使用 SceneLayer 上的 queryExtent() 检索多个点的 2D 范围。仅使用缓存属性无法获取 SceneLayer 的范围。

编辑：属性更新

目前，仅场景图层上的applyEdits 方法支持属性更新。可编辑SceneLayer 的先决条件是关联的FeatureLayer 启用了编辑和更改跟踪。有关发布的详细信息，请参阅 Publishing section of the scene layer guide topic 。具有已编辑属性的要素将使用更新的属性进行渲染，直到已编辑要素的数量超过 50,000。之后，不会检索已编辑的属性，而是使用缓存的过时属性呈现特征。 Rebuild the cache 用于达到此最大数量之前的场景图层。

场景图层属性更新的一个用例是更改状态和类型，请查看此示例：Sample - SceneLayer attribute editing 在此示例中，可编辑要素图层共享给所有人。因此，每个人都可以修改这些数据。在实际用例中，只有经过授权的编辑者才能编辑图层。在这种情况下，关联的要素图层不会公开共享，只能由编辑者访问。要使编辑对场景图层用户可见，有必要 rebuild the cache 。