IntegratedMeshLayer 旨在可视化难以访问的基础设施和自然景观的 SceneView 中的准确表示。
集成网格数据通常由自动化过程捕获,用于从大型重叠影像集构建 3D 对象。结果使用三角形隔行扫描结构将原始输入图像信息集成为纹理网格。集成网格可以表示建筑和自然的 3D 要素,例如建筑墙、树木、山谷和悬崖,并具有逼真的纹理。集成网格场景图层将始终在地面表面的前面渲染。它们通常是为全市范围的 3D 制图而创建的,并且可以使用 Drone2Map for GeoScene 创建,然后可以将其共享到适用于桌面或 Web 应用程序的 GeoScene。
场景服务由 GeoScene Server REST 资源的 URL 标识:
IntegratedMeshLayer = new IntegratedMeshLayer({
url: "https://tiles.geoscene.cn/tiles/u0sSNqDXr7puKJrF/arcgis/rest/services/Frankfurt2017_v17/SceneServer/layers/0"
});
如果从不同的域请求服务,启用CORS的服务器或代理是必须的。
构造函数
属性列表
属性 | 类型 | 描述 | 类 | |
---|---|---|---|---|
String | 更多信息 用于访问资源或服务的授权字符串。 | 更多信息 | IntegratedMeshLayer | |
String | 更多信息 由场景服务定义的版权文本。 | 更多信息 | IntegratedMeshLayer | |
String | 更多信息 类名。 | 更多信息 | Accessor | |
Object | 更多信息 指定网格在垂直轴 (z) 上的放置方式。 | 更多信息 | IntegratedMeshLayer | |
Extent | 更多信息 图层的完整范围。 | 更多信息 | Layer | |
String | 更多信息 分配给图层的唯一 ID。 | 更多信息 | Layer | |
Number | 更多信息 场景服务图层的图层 ID 或图层索引。 | 更多信息 | IntegratedMeshLayer | |
String | 更多信息 指示图层应如何在 LayerList 微件中显示。 | 更多信息 | Layer | |
Boolean | 更多信息 指示图层的资源是否已加载。 | 更多信息 | Layer | |
Error | 更多信息 如果在加载时发生错误,则返回 Error 对象。 | 更多信息 | Layer | |
String | 更多信息 表示加载操作的状态。 | 更多信息 | Layer | |
Object[] | 更多信息 加载时出现的警告列表。 | 更多信息 | Layer | |
Number | 更多信息 图层在视图中可见的最大比例(最大放大)。 | 更多信息 | IntegratedMeshLayer | |
Number | 更多信息 图层在视图中可见的最小比例(最大程度缩小)。 | 更多信息 | IntegratedMeshLayer | |
SceneModifications | 更多信息 具有用于应用客户端修改的多边形和类型的 SceneModification 集合。 | 更多信息 | IntegratedMeshLayer | |
PortalItem | 更多信息 加载图层的门户项目。 | 更多信息 | IntegratedMeshLayer | |
SpatialReference | 更多信息 图层的空间参考。 | 更多信息 | IntegratedMeshLayer | |
String | 更多信息 图层的标题,用于在 LayerList 微件等位置识别它。 | 更多信息 | IntegratedMeshLayer | |
String | 更多信息对于 IntegratedMeshLayer,类型始终为 "integrated-mesh". | 更多信息 | IntegratedMeshLayer | |
String | 更多信息 图层或场景服务的 REST 端点的 URL。 | 更多信息 | IntegratedMeshLayer | |
Object | 更多信息 用于该服务的场景服务规范的版本。 | 更多信息 | IntegratedMeshLayer | |
Boolean | 更多信息 指示图层是否在视图中可见。 | 更多信息 | Layer |
属性详细说明
-
apiKey String起始版本: GeoScene API for JavaScript 4.22
-
用于访问资源或服务的授权字符串。
示例代码:// 设置 api 密钥以访问受保护的服务 const layer = new FeatureLayer({ url: serviceUrl, apiKey: "YOUR_API_KEY" });
-
copyright String
-
由场景服务定义的版权文本。
-
起始版本: GeoScene API for JavaScript 4.22
-
类名。类的名称声明格式为
geoscene.folder.className
。
-
elevationInfo Object起始版本: GeoScene API for JavaScript 4.22
-
指定网格如何放置在垂直轴 (z) 上。 此属性仅在使用
absolute-height
模式时影响 IntegratedMeshLayers 。 集成网格层始终在地表之前渲染,因此设置负偏移值不会将它们渲染到地表以下。- 属性:
-
mode String
定义网格如何放置在垂直轴 (z) 上。 目前仅支持
absolute-height
。模式 描述 absolute-height 网格放置在海平面以上的绝对高程(z 值)处。 此 z 值是通过将 offset
值和网格的 z 值相加来确定的。 它没有考虑地形的高度。 这是 IntegratedMeshLayer 唯一支持的高程模式。offset Number默认值:0高程偏移,将其添加到网格的垂直位置。
unit String默认值:metersoffset
值的单位。可选值:"feet"|"meters"|"kilometers"|"miles"|"us-feet"|"yards"
-
图层的完整范围。 默认情况下,这是全球范围的。 可以使用此属性设置视图的范围以匹配图层的范围,这样看起来要素填充了视图。 请参阅下面的示例片段。
示例代码:// 图层加载后,将视图的范围设置为图层的全范围 layer.when(function(){ view.extent = layer.fullExtent; });
-
分配给图层的唯一 ID。 如果没有开发者设置,则在图层加载时自动生成。
-
layerId Number
-
场景服务图层的图层 ID 或图层索引。这在从包含多个图层的服务加载具有 portalItem属性的单个图层时特别有用。 您可以在以下两种情况之一中指定此值:
- 通过 portalItem 属性加载图层时。
- 将图层 url 直接指向场景服务时。
如果以上两种情况下均未指定layerId,则选择服务中的第一层(
layerId = 0
)。示例代码:// 虽然这些示例使用 SceneLayer,但相同的模式可用于可能从 portalItem id 加载的其他层 // 在给定的 Portal Item 中加载第三层 let layer = new SceneLayer({ portalItem: { id: "73df987984b24094b848d580eb83b0fb" }, layerId: 2 });
// 如果不指定,则返回第一层(layerId: 0) let layer = new SceneLayer({ portalItem: { id: "73df987984b24094b848d580eb83b0fb" } });
// 如果 URL 指向服务而不是层,也可以使用 let layer = new SceneLayer({ url: "https://www.geosceneonline.cn/server/rest/services/Hosted/4%E5%85%A8%E5%B1%80%E5%9C%BA%E6%99%AF_WSL1/SceneServer", layerId: 0 // 注意url不以/2结尾 });
// 此代码返回与上一个片段相同的层 let layer = new SceneLayer({ url: "https://www.geosceneonline.cn/server/rest/services/Hosted/4%E5%85%A8%E5%B1%80%E5%9C%BA%E6%99%AF_WSL1/SceneServer/layers/0", // 在 URL 中指定层 id });
-
指示图层应如何在 LayerList 微件中显示。 下面列出了可能的值。
值 描述 show 该图层在内容列表中可见。 hide 该图层在内容列表中不可见。 hide-children 如果图层是GroupLayer,BuildingSceneLayer,KMLLayer, MapImageLayer, TileLayer 或 WMSLayer,从内容表中隐藏子图层。 可选值:"show"|"hide"|"hide-children"
- 默认值:show
-
指示图层的资源是否已加载。 当
true
时, 对象的所有属性都可以访问。- 默认值:false
-
如果在加载时发生错误,则返回 Error 对象。
- 默认值:null
-
表示加载操作的状态。
值 描述 not-loaded 该对象的资源尚未加载。 loading 该对象的资源正在加载。 loaded 该对象的资源已正确加载。 failed 对象的资源加载失败。 有关详细信息,请参阅 loadError。 可选值:"not-loaded"|"loading"|"failed"|"loaded"
- 默认值:not-loaded
-
加载时出现的警告列表。
-
maxScale Number
-
图层在视图中可见的最大比例(最大放大)。 如果地图放大超过此比例,则图层将不可见。
0
的值表示图层没有最大比例。 maxScale 值应始终小于 minScale 值,并且大于或等于服务规范。- 默认值:0
示例代码:// 当视图放大到超过 1:1,000 的比例时,图层将不可见 layer.maxScale = 1000;
// 图层的可见性不限于最大比例。 layer.maxScale = 0;
-
minScale Number
-
图层在视图中可见的最小比例(最大缩小)。如果地图缩小超过此比例,图层将不可见。值
0
表示图层不可见 没有最小比例。minScale 值应始终大于 maxScale 值,并且小于或等于服务规范。- 默认值:0
示例代码:// 当视图缩小到超过 1:3,000,000 的比例时,图层将不可见 layer.minScale = 3000000;
// 图层的可见性不限于最小比例。 layer.minScale = 0;
-
modifications SceneModifications起始版本: GeoScene API for JavaScript 4.22
-
具有多边形和类型的 SceneModification 集合以应用客户端修改。 修改不受 elevationInfo 偏移的影响。 使用 WebScene.save() 可以保留 SceneModifications 。 这允许您通过 Web 场景共享修改后的集成网格。 可以对集成网格应用以下修改:
实例 更改 描述 clip - 删除选定区域 剪出集成网格的部分,以查看下面的特征。例如,公用事业公司在某个区域的天然气或水管线上工作。规划人员可以创建一个场景,其中集成网格在某个地点被剪掉,以暴露其下方的水或天然气管线。 mask - 仅显示选定区域 定义感兴趣的区域。使用面并仅绘制该多边形内集成网格的一部分。例如,如果只想显示城市边界内集成网格的一部分。 replace - 展平所选区域 替换基于 3D 多边形的集成网格区域。例如,要添加已构建的建筑物,请在建筑物的占地面积处展平集成网格,以便可视化新建筑物。创建新建筑区域的不同场景,并将场景共享为 Web 场景,以便与利益干系人进行讨论。集成网格将展平到修改多边形的最小 z 顶点。 IntegratedMeshLayer 的修改需要与 IntegratedMeshLayer 位于同一空间参考中。WGS84和WebMercator之间的重新投影将自动完成。可以使用客户端投影引擎将几何图形重新投影到其他空间参考。
示例代码:// 创建 IntegratedMeshLayer const layer = new IntegratedMeshLayer({ ... }) // 创建一个多边形
const polygon = new Polygon({ ... }); // 创建修改
let modifications = new SceneModifications( [ new SceneModification(polygon, "replace") ]); // 将修改添加到 IntegratedMesh
imlayer.modifications = modifications;
-
portalItem PortalItem
-
加载图层的门户项目。 如果门户项目引用要素服务或场景服务,则可以使用 layerId 属性指定要加载的单个图层。
从 4.17 版开始,可以从 GeoScene Online 和 GeoScene Enterprise 中托管的要素服务项目加载表格。 这仅适用于要素图层,并且会成功加载 如果 FeatureLayer.isTable 返回
true
。示例代码://虽然这个例子使用了FeatureLayer,但同样的模式也可以 // 用于可能从 portalItem ids 加载的其他层。 const lyr = new FeatureLayer({ portalItem: { // 转换成 new PortalItem() id: "caa9bd9da1f4487cb4989824053bb847" } //返回服务中的第一层 });
// 虽然此示例使用 FeatureLayer,但同样的模式也可以 // 用于 SceneLayers。 const lyr = new FeatureLayer({ portalItem: { // 转换成 new PortalItem() id: "8d26f04f31f642b6828b7023b84c2188" }, //加载给定要素服务中的第三项 layerId: 2 });
// 这个片段加载一个托管在 GeoScene Online 中的表格。 const table = new FeatureLayer({ portalItem: { id: "123f4410054b43d7a0bacc1533ceb8dc" } }); // 将表格添加到地图之前,必须先加载并确认它是正确的类型。 table.load().then(function() { if (table.isTable) { map.table.add(table); } });
-
spatialReference SpatialReferenceautocast
-
图层的空间参考。
-
title String
-
图层的标题,用于在 LayerList 微件等位置识别它。
通过服务 url 加载层时,标题来自服务名称。 如果服务有多个层,则每个层的标题将是服务名称和层名称的串联。 从门户项目加载图层时,将使用门户项目的标题。 最后,如果图层作为 webmap 或 webscene 的一部分加载,则存储的图层标题
-
type Stringreadonly
对于 IntegratedMeshLayer,类型始终为 "integrated-mesh".
-
url String
-
图层或场景服务的 REST 端点的 URL。 URL 可能指向一个GeoScene Enterprise 或 GeoScene Online 上的资源。
当 url 直接指向服务而不是特定层时,可以使用 layerId 属性指定层。如果 layerId 未指定,则默认为服务中的第一层。
示例代码:// GeoScene 服务器上场景服务的图层 let sceneLayer = new SceneLayer({ url: "https://www.geosceneonline.cn/server/rest/services/Hosted/4%E5%85%A8%E5%B1%80%E5%9C%BA%E6%99%AF_WSL1/layers/0" });
// 如果 URL 指向服务而不是层,也可以使用 let layer = new SceneLayer({ // 注意url不以/0结尾 url: "https://www.geosceneonline.cn/server/rest/services/Hosted/4%E5%85%A8%E5%B1%80%E5%9C%BA%E6%99%AF_WSL1/SceneServer", layerId: 0 });
-
version Objectreadonly
-
用于该服务的场景服务规范的版本。
示例代码:// 将版本打印到控制台 console.log(layer.version.versionString);
-
- 默认值:true
示例代码:// 该层在视图中不可见 layer.visible = false;
方法列表
属性 | 返回值类型 | 描述 | 类 | |
---|---|---|---|---|
更多信息 如果 load() 操作已经在进行中,则取消它。 | 更多信息 | Layer | ||
Promise<LayerView> | 更多信息 当图层被添加到 Map.layers 集合并且必须为其创建图层视图时,由视图调用,例如 MapView 和 SceneView 。 | 更多信息 | Layer | |
更多信息 销毁图层和任何相关资源(包括其portalItem,如果它是图层上的属性)。 | 更多信息 | Layer | ||
Boolean | 更多信息 在实例上触发事件。 | 更多信息 | Layer | |
Promise<Object> | 更多信息 在图层可用时获取图层的自定义属性数据。 | 更多信息 | Layer | |
Boolean | 更多信息 指示实例上是否存在与提供的事件名称匹配的事件侦听器。 | 更多信息 | Layer | |
Boolean | 更多信息
| 更多信息 | Layer | |
Boolean | 更多信息
| 更多信息 | Layer | |
Boolean | 更多信息
| 更多信息 | Layer | |
Promise | 更多信息 加载该类引用的资源。 | 更多信息 | Layer | |
Object | 更多信息 在实例上注册事件处理程序。 | 更多信息 | Layer | |
Promise | 更多信息
| 更多信息 | Layer |
方法详细说明
-
当图层被添加到 Map.layers 集合并且图层视图必须为其创建时,由MapView和SceneView等视图调用, 该方法内部使用,没有直接调用的用例。
参数:view *父视图
options Objectoptional指定附加选项的对象。 有关此对象所需的属性,请参阅下面的对象规格表。
规范:signal AbortSignaloptional一个中止图层视图创建的信号。
返回值:类型 描述 Promise<LayerView> 用 LayerView 实例解析。
-
destroy()inherited起始版本: GeoScene API for JavaScript 4.22
-
销毁图层和任何相关资源(包括其portalItem,如果它是图层上的属性)。该层一旦被销毁就不能再使用了。
被破坏的图层将从其父对象中删除,例如 Map、WebMap、WebScene,Basemap, Ground ,或 GroupLayer。
-
起始版本: GeoScene API for JavaScript 4.22
-
在实例上触发事件。仅当创建此类的子类时才应使用此方法。
参数:type String事件名称
event Objectoptional事件负载。
返回值:类型 描述 Boolean 如果侦听器收到通知,则为 true
-
isFulfilled()
可用于验证创建类的实例是否已完成(无论成功或失败)。 如果已完成,将会返回true
。返回值:类型 描述 Boolean 指示创建类的实例是否已完成(无论成功或失败)。
-
isRejected()
可用于验证创建类的实例是否失败。 如果失败, 将会返回true
。返回值:类型 描述 Boolean 指示是否已拒绝创建类的实例。
-
isResolved()
可用于验证创建类的实例是否成功。 如果成功, 将会返回true
。返回值:类型 描述 Boolean 指示是否已解析创建类的实例。
-
加载此类引用的资源。 此方法自动为 View 及其在 Map 中引用的所有资源执行 如果视图是用地图实例构造的。
当访问一个不会在View中加载的资源时,开发者必须调用这个方法。
load()
方法仅在第一次调用时触发资源的加载。 随后的调用返回相同的promise。可以提供一个
signal
来停止对Loadable
实例加载状态的关注。 当信号中止时,实例不会停止其加载过程,只有 cancelLoad 可以中止它。参数:signal AbortSignaloptional可用于中止异步任务的 Signal 对象。 当发出中止信号时,返回的 Promise 将被一个名为
AbortError
的 Error 拒绝。另请参阅 AbortController 以获取有关如何构造可用于传递中止 signals 的控制器的更多信息。返回值:类型 描述 Promise 资源已加载时解析。
-
在实例上注册事件处理程序。调用此方法将事件与侦听器挂钩
参数:要监听的event 或者事件数组
listener Function事件触发时要调用的函数
返回值:类型 描述 Object 返回一个 remove()
方法的事件处理程序,该方法用以停止侦听事件。属性 类型 描述 remove Function 当被调用时,从事件中移除监听器。 示例代码:view.on("click", function(event){ // event是事件触发后返回的事件句柄。 console.log(event.mapPoint); });
-
起始版本: GeoScene API for JavaScript 4.22
-
when()
创建类的实例后,会被执行一次。该方法接受两个参数:callback
函数和errback
函数。callback
在类的实例加载时执行。 如果类的实例无法加载,则执行errback
。参数:callback Functionoptional当 Promise 成功时,该函数将被调用。
errback Functionoptional当 Promise 失败时,该函数将被调用。
返回值:类型 描述 Promise 返回回调结果的新promise,可用于 链接其他函数。 示例代码:// 尽管此示例使用 MapView,但任何作为 Promise 的类实例都可以以相同的方式使用 when() let view = new MapView(); view.when(function(){ // 当 Promise resolved 时,函数将被执行 }, function(error){ // 当 Promise 通过 rejected 抛错时,这个函数将被执行 });
事件概述
属性 | 类型 | 描述 | 类 | |
---|---|---|---|---|
{view: View,layerView: LayerView} |
更多信息
在图层的 LayerView创建并在视图中呈现后触发。 |
更多信息 | Layer | |
{view: View,error: Error} |
更多信息
将图层添加到地图后,在创建 LayerView 期间发出错误时触发。 |
更多信息 | Layer | |
{view: View,layerView: LayerView} |
更多信息
在层的 LayerView 被销毁并且不再在视图中呈现后触发。 |
更多信息 | Layer |
事件详述
-
layerview-createinherited
-
在图层的 LayerView创建并在视图中呈现后触发。
示例代码:// 每次为此特定视图创建图层视图时,都会触发此函数。 layer.on("layerview-create", function(event){ / 发出此事件的图层的 LayerView event.layerView; });
-
layerview-create-errorinherited
-
将图层添加到地图后,在创建 LayerView 期间发出错误时触发。
示例代码:// 在创建图层的图层视图期间发生错误时会触发此函数 layer.on("layerview-create-error", function(event) { console.error("LayerView failed to create for layer with the id: ", layer.id, " in this view: ", event.view); });