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 。