@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.9

package/{documention → documentation}/MapGISTerrainProvider.html

@@ -83,7 +83,7 @@
     <div class="nameContainer">
         <h4 class="name" id="MapGISTerrainProvider">
             
-            new MapGISTerrainProvider<span class="signature">(options)</span>
+            new MapGISTerrainProvider<span class="signature">(<span class="optional">options</span>)</span>
         </h4>
     
         
@@ -94,15 +94,17 @@
     </div>
 
     
-    <p class="summary"><h5>支持如下方法：</h5>
-<a href='#fromUrl'>[1、通过场景服务的url获取MapGISTerrainProvider对象]</a><br/></p>
-    
 </dt>
 <dd>
     
     
     <div class="description">
-        <p>MapGIS地形服务接入类</p>
+        <p>MapGIS 地形服务接入类。</p>
+<p>该类用于将 MapGIS 地形服务封装为 Cesium <code>TerrainProvider</code>，支持单服务加载和多服务
+混合加载两种模式。在多地形场景下会依据瓦片可用范围自动选择当前可见的地形子服务，
+并统一管理法向量请求、高程赋色和请求头等运行参数。</p>
+<p>推荐通过 <code>fromUrl</code> 从场景服务自动识别地形子图层并创建 provider；当业务需要手动
+拼装多个 DEM 服务时，可直接传入 <code>serviceList</code>。</p>
     </div>
     
 
@@ -123,6 +125,8 @@
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -146,10 +150,23 @@
             </td>
             
             
+                <td class="default">
+                
+                    {}
+                
+                </td>
+            
             
             <td class="description last">
                 
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
                 
+                <p>构造参数。</p>
                 
 
 <table class="params">
@@ -206,11 +223,7 @@
                         
                     
                 
-                <p>服务基地址，
-当仅加载一个DEM地形服务时，使用该初始化参数，当加载多个DEM地形服务时，请使用serviceList初始化参数，<br>
-基地址格式为:<br>
-IGS1.0: http://{ip}:{port}/igs/rest/g3d/{folder}:{serviceName}/GetTerrain<br>
-IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/layers/{layerId}/terrains</p></td>
+                <p>单个地形服务地址。单服务模式下直接使用该地址，多服务模式下通常改为传入 <code>serviceList</code>。</p></td>
         </tr>
 	
 	
@@ -246,7 +259,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形的平铺方案，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=TilingScheme' target='_blank'>详见Cesium.TilingScheme</a></p></td>
+                <p>地形瓦片平铺方案。</p></td>
         </tr>
 	
 	
@@ -282,7 +295,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形二维范围</p></td>
+                <p>单服务模式下的二维范围。</p></td>
         </tr>
 	
 	
@@ -318,7 +331,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形三维范围</p></td>
+                <p>单服务模式下的三维范围。</p></td>
         </tr>
 	
 	
@@ -354,7 +367,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>是否请求法向量</p></td>
+                <p>是否为当前地形请求法向量数据。</p></td>
         </tr>
 	
 	
@@ -390,7 +403,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形最大显示级数</p></td>
+                <p>单个地形服务允许响应的最大级别。</p></td>
         </tr>
 	
 	
@@ -426,7 +439,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形分析-高程赋色功能的色表，格式为['#000000', '#2747E0', '#D33B7D', '#D33038', '#FF9742', '#ffd700', '#FFFFFF']</p></td>
+                <p>地形高程赋色使用的色表数组。</p></td>
         </tr>
 	
 	
@@ -462,7 +475,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形分析-高程赋色功能的最小高度</p></td>
+                <p>高程赋色的最小高度。</p></td>
         </tr>
 	
 	
@@ -498,7 +511,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>地形分析-高程赋色功能的最大高度</p></td>
+                <p>高程赋色的最大高度。</p></td>
         </tr>
 	
 	
@@ -534,7 +547,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>坡度箭头重复次数，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Cartesian2' target='_blank'>详见Cesium.Cartesian2</a></p></td>
+                <p>坡度箭头重复次数。</p></td>
         </tr>
 	
 	
@@ -570,7 +583,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>请求拦截器，可对最后发出的请求链接进行编辑，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Proxy' target='_blank'>详见Cesium.Proxy</a></p></td>
+                <p>请求代理对象，可在请求发出前改写目标地址。</p></td>
         </tr>
 	
 	
@@ -606,8 +619,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>当加载多个DEM地形服务时，请使用serviceList初始化参数。
-此时传入的格式变为了[{url:'',range:{},range3D:{},requestVertexNormals:true,maxLevel:20}]</p></td>
+                <p>多地形模式下的服务清单。每项通常包含 <code>url</code>、范围、法向量开关和最大级别等信息。</p></td>
         </tr>
 	
 	
@@ -643,7 +655,7 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
                         
                     
                 
-                <p>A credit for the data source, which is displayed on the canvas，<a href='http://10.10.130.72:8086/static/modules/cesium/api/cesium/index.html?classFilter=Credit' target='_blank'>详见Cesium.Credit</a></p></td>
+                <p>Cesium 视图中展示的数据源版权信息。</p></td>
         </tr>
 	
 	
@@ -694,6 +706,21 @@ IGS2.0: http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/SceneServer/
     
     
     
+        <h5>Example</h5>
+        
+
+    
+    <pre class="prettyprint"><code>// ES5引入方式
+const { MapGISTerrainProvider } = zondy.cesium
+
+// ES6引入方式
+import { MapGISTerrainProvider } from '@mapgis/webclient-cesium-plugin'
+
+const provider = await MapGISTerrainProvider.fromUrl(sceneUrl)
+viewer.terrainProvider = provider</code></pre>
+    
+
+    
 </dd>
 
     
@@ -919,8 +946,7 @@ This function should not be called before Cesium.CesiumTerrainProvider.ready ret
 <dd>
     
     <div class="description">
-        <p>是否应用地形法向量,当所有地形子图层的hasVertexNormals和requestVertexNormals参数都为true时,
-MapGISTerrainProvider的hasVertexNormals属性为true,否则为false</p>
+        <p>是否含有地形法向量数据，IGS地形默认都含有法向量数据，因此固定返回true</p>
     </div>
     
     
@@ -1599,14 +1625,14 @@ not be called before Cesium.CesiumTerrainProvider.ready returns true.</p>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id=".fromUrl">
+        <h4 class="name" id="addService">
             
-            MapGISTerrainProvider.fromUrl<span class="signature">(url, options)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="MapGISTerrainProvider.html">MapGISTerrainProvider</a>|undefined}</span>
+            addService<span class="signature">(terrainService)</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 198
+            engineExtensions/core/MapGISTerrainProvider.js, line 526
         </div>
         
     </div>
@@ -1617,7 +1643,9 @@ not be called before Cesium.CesiumTerrainProvider.ready returns true.</p>
     
     
     <div class="description">
-        <p>通过场景服务的url获取MapGISTerrainProvider对象，若场景服务中不包含地形图层则返回undefined<a id='fromUrl'/></p>
+        <p>向 provider 追加一个地形服务。</p>
+<p>该方法会把传入配置转换为 <code>MapGISTerrainService</code> 实例，创建对应的地形子图层，
+并同步刷新整体范围与法向量可用状态。</p>
     </div>
     
 
@@ -1648,36 +1676,13 @@ not be called before Cesium.CesiumTerrainProvider.ready returns true.</p>
 	
         <tr>
             
-                <td class="name"><code>url</code></td>
-            
-            
-            <td class="type">
-            
-                
-<span class="param-type">String</span>
-
-
-            
-            </td>
-            
-            
-            
-            <td class="description last">
-                
-                <p>服务的基地址</p></td>
-        </tr>
-	
-	
-	
-        <tr>
-            
-                <td class="name"><code>options</code></td>
+                <td class="name"><code>terrainService</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type">Object</span>
+<span class="param-type"><a href="MapGISTerrainService.html">MapGISTerrainService</a></span>
 
 
             
@@ -1687,7 +1692,7 @@ not be called before Cesium.CesiumTerrainProvider.ready returns true.</p>
             
             <td class="description last">
                 
-                <p>实例化对象时提供的额外配置参数，若该对象中包含构造参数则会覆盖对应的构造参数</p></td>
+                <p>待追加的地形服务配置。</p></td>
         </tr>
 	
 	
@@ -1730,54 +1735,7 @@ not be called before Cesium.CesiumTerrainProvider.ready returns true.</p>
     
     
     
-    <h5>Returns:</h5>
-    
-
-
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Type</th>
-        <th class="last">Description</th>
-    </tr>
-    </thead>
-    <tbody>
-    
-        <tr>
-            
-            <td class="type">
-            
-                        <a href="MapGISTerrainProvider.html">MapGISTerrainProvider</a>
-                         | 
-                    
-                        undefined
-                        
-                    
-            </td>
-            <td class="description last"></td>
-        </tr>
-    
-    </tbody>
-</table>
-
-    
-    
-    
-        <h5>Example</h5>
-        
-
-    
-    <pre class="prettyprint"><code>const url = 'http://10.10.130.72:8089/igs/rest/services/Scene/TwTerrain/SceneServer'
-const addTerrainProvider = async (url) => {
-  const imageryProvider = await MapGISTerrainProvider.fromUrl(url)
-  if (terrainProvider) {
-    viewer.terrainProvider = terrainProvider
-  }
-}
-addTerrainProvider(url)</code></pre>
     
-
     
 </dd>
 
@@ -1785,14 +1743,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="addService">
+        <h4 class="name" id="getLayersByRange">
             
-            addService<span class="signature">(terrainService)</span>
+            getLayersByRange<span class="signature">(range)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;Object>}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 521
+            engineExtensions/core/MapGISTerrainProvider.js, line 733
         </div>
         
     </div>
@@ -1803,7 +1761,8 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>添加一个地形服务</p>
+        <p>查询与指定范围相交的地形子图层。</p>
+<p>可用于在多地形场景下定位当前业务范围实际命中的地形服务集合。</p>
     </div>
     
 
@@ -1834,13 +1793,13 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>terrainService</code></td>
+                <td class="name"><code>range</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type"><a href="MapGISTerrainService.html">MapGISTerrainService</a></span>
+<span class="param-type">Geometry</span>
 
 
             
@@ -1850,7 +1809,7 @@ addTerrainProvider(url)</code></pre>
             
             <td class="description last">
                 
-                <p>地形服务数据对象</p></td>
+                <p>用于求交的范围几何对象。</p></td>
         </tr>
 	
 	
@@ -1893,6 +1852,35 @@ addTerrainProvider(url)</code></pre>
     
     
     
+    <h5>Returns:</h5>
+    
+
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+    
+        <tr>
+            
+            <td class="type">
+            
+                        Array.&lt;Object>
+                        
+                    
+            </td>
+            <td class="description last">与输入范围相交的地形子图层数组。</td>
+        </tr>
+    
+    </tbody>
+</table>
+
+    
     
     
 </dd>
@@ -1901,14 +1889,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="getLayersByRange">
+        <h4 class="name" id="getServiceById">
             
-            getLayersByRange<span class="signature">(range)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{Array.&lt;Object>}</span>
+            getServiceById<span class="signature">(id)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="MapGISTerrainService.html">MapGISTerrainService</a>|null}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 697
+            engineExtensions/core/MapGISTerrainProvider.js, line 624
         </div>
         
     </div>
@@ -1919,7 +1907,7 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>返回和range相交的地形子图层对象数组</p>
+        <p>根据服务 ID 查询已注册的地形服务配置。</p>
     </div>
     
 
@@ -1950,13 +1938,13 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>range</code></td>
+                <td class="name"><code>id</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type">Geometry</span>
+<span class="param-type">String</span>
 
 
             
@@ -1966,7 +1954,7 @@ addTerrainProvider(url)</code></pre>
             
             <td class="description last">
                 
-                <p>范围几何对象</p></td>
+                <p>地形服务 ID。</p></td>
         </tr>
 	
 	
@@ -2027,11 +2015,14 @@ addTerrainProvider(url)</code></pre>
             
             <td class="type">
             
-                        Array.&lt;Object>
+                        <a href="MapGISTerrainService.html">MapGISTerrainService</a>
+                         | 
+                    
+                        null
                         
                     
             </td>
-            <td class="description last">相交的地形子图层对象数组</td>
+            <td class="description last">命中的地形服务；未找到时返回 <code>null</code>。</td>
         </tr>
     
     </tbody>
@@ -2046,14 +2037,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="getServiceById">
+        <h4 class="name" id="removeService">
             
-            getServiceById<span class="signature">(id)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="MapGISTerrainService.html">MapGISTerrainService</a>|null}</span>
+            removeService<span class="signature">(terrainService)</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 600
+            engineExtensions/core/MapGISTerrainProvider.js, line 614
         </div>
         
     </div>
@@ -2064,7 +2055,8 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>通过service的id获取service对象，没有则返null</p>
+        <p>移除单个地形服务。</p>
+<p>该方法是 <code>removeServices</code> 的单项包装，适用于按服务对象逐个下线地形数据源。</p>
     </div>
     
 
@@ -2095,13 +2087,13 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>id</code></td>
+                <td class="name"><code>terrainService</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type"><a href="MapGISTerrainService.html">MapGISTerrainService</a></span>
 
 
             
@@ -2111,7 +2103,7 @@ addTerrainProvider(url)</code></pre>
             
             <td class="description last">
                 
-                <p>service对象的id</p></td>
+                <p>待移除的地形服务。</p></td>
         </tr>
 	
 	
@@ -2154,38 +2146,6 @@ addTerrainProvider(url)</code></pre>
     
     
     
-    <h5>Returns:</h5>
-    
-
-
-<table class="params">
-    <thead>
-    <tr>
-        
-        <th>Type</th>
-        <th class="last">Description</th>
-    </tr>
-    </thead>
-    <tbody>
-    
-        <tr>
-            
-            <td class="type">
-            
-                        <a href="MapGISTerrainService.html">MapGISTerrainService</a>
-                         | 
-                    
-                        null
-                        
-                    
-            </td>
-            <td class="description last">service对象</td>
-        </tr>
-    
-    </tbody>
-</table>
-
-    
     
     
 </dd>
@@ -2194,14 +2154,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="removeService">
+        <h4 class="name" id="removeServices">
             
-            removeService<span class="signature">(terrainService)</span>
+            removeServices<span class="signature">(terrainServices)</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 591
+            engineExtensions/core/MapGISTerrainProvider.js, line 601
         </div>
         
     </div>
@@ -2212,7 +2172,9 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>删除一个地形服务</p>
+        <p>批量移除一组地形服务。</p>
+<p>传入的每个服务都会从服务清单和对应子图层中删除，并在完成后统一刷新
+provider 的法向量能力状态。</p>
     </div>
     
 
@@ -2243,13 +2205,13 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>terrainService</code></td>
+                <td class="name"><code>terrainServices</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type"><a href="MapGISTerrainService.html">MapGISTerrainService</a></span>
+<span class="param-type">Array.&lt;<a href="MapGISTerrainService.html">MapGISTerrainService</a>></span>
 
 
             
@@ -2259,7 +2221,7 @@ addTerrainProvider(url)</code></pre>
             
             <td class="description last">
                 
-                <p>地形服务数据对象</p></td>
+                <p>待移除的地形服务列表。</p></td>
         </tr>
 	
 	
@@ -2310,14 +2272,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="removeServices">
+        <h4 class="name" id="updateService">
             
-            removeServices<span class="signature">(terrainServices)</span>
+            updateService<span class="signature">(terrainService)</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 579
+            engineExtensions/core/MapGISTerrainProvider.js, line 660
         </div>
         
     </div>
@@ -2328,7 +2290,8 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>删除多个地形服务</p>
+        <p>用新的服务配置替换同 ID 的地形服务。</p>
+<p>替换成功后会同步重建对应子图层，使范围、级别或地址等变更立即参与后续瓦片请求。</p>
     </div>
     
 
@@ -2359,13 +2322,13 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>terrainServices</code></td>
+                <td class="name"><code>terrainService</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type">Array.&lt;<a href="MapGISTerrainService.html">MapGISTerrainService</a>></span>
+<span class="param-type"><a href="MapGISTerrainService.html">MapGISTerrainService</a></span>
 
 
             
@@ -2375,7 +2338,7 @@ addTerrainProvider(url)</code></pre>
             
             <td class="description last">
                 
-                <p>地形服务数据对象</p></td>
+                <p>最新的地形服务配置。</p></td>
         </tr>
 	
 	
@@ -2426,14 +2389,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="updateService">
+        <h4 class="name" id="updateServiceProperty">
             
-            updateService<span class="signature">(terrainService)</span>
+            updateServiceProperty<span class="signature">(id, key, value)</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 632
+            engineExtensions/core/MapGISTerrainProvider.js, line 697
         </div>
         
     </div>
@@ -2444,7 +2407,9 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>在serviceList中找到id和传入的service对象相同的service进行更新</p>
+        <p>按属性维度更新指定地形服务。</p>
+<p>对显示状态、地址和级别等直接映射到子图层的字段会同步修改图层对象；
+对范围和平铺方案等会触发子图层重建。</p>
     </div>
     
 
@@ -2475,13 +2440,36 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>terrainService</code></td>
+                <td class="name"><code>id</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type"><a href="MapGISTerrainService.html">MapGISTerrainService</a></span>
+<span class="param-type">String</span>
+
+
+            
+            </td>
+            
+            
+            
+            <td class="description last">
+                
+                <p>地形服务 ID。</p></td>
+        </tr>
+	
+	
+	
+        <tr>
+            
+                <td class="name"><code>key</code></td>
+            
+            
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
 
             
@@ -2491,7 +2479,30 @@ addTerrainProvider(url)</code></pre>
             
             <td class="description last">
                 
-                <p>地形服务对象</p></td>
+                <p>待更新的属性名。</p></td>
+        </tr>
+	
+	
+	
+        <tr>
+            
+                <td class="name"><code>value</code></td>
+            
+            
+            <td class="type">
+            
+                
+<span class="param-type">*</span>
+
+
+            
+            </td>
+            
+            
+            
+            <td class="description last">
+                
+                <p>新属性值。</p></td>
         </tr>
 	
 	
@@ -2542,14 +2553,14 @@ addTerrainProvider(url)</code></pre>
             
 <dt>
     <div class="nameContainer">
-        <h4 class="name" id="updateServiceProperty">
+        <h4 class="name" id=".fromUrl">
             
-            updateServiceProperty<span class="signature">(id, key, value)</span>
+            MapGISTerrainProvider.fromUrl<span class="signature">(url, <span class="optional">options</span>)</span><span class="glyphicon glyphicon-circle-arrow-right"></span><span class="type-signature returnType">{<a href="Promise.html">Promise</a>.&lt;(<a href="MapGISTerrainProvider.html">MapGISTerrainProvider</a>|undefined)>}</span>
         </h4>
     
         
         <div class="tag-source">
-            engineExtensions/core/MapGISTerrainProvider.js, line 664
+            engineExtensions/core/MapGISTerrainProvider.js, line 182
         </div>
         
     </div>
@@ -2560,7 +2571,9 @@ addTerrainProvider(url)</code></pre>
     
     
     <div class="description">
-        <p>在serviceList中找到id和传入的service对象，单独更新service上的某一个属性</p>
+        <p>通过场景服务地址创建地形提供器。</p>
+<p>该方法会从场景服务中解析可用的地形子图层，并基于识别结果组装
+<code>MapGISTerrainService</code> 列表。若场景服务中不包含地形图层，则返回 <code>undefined</code>。</p>
     </div>
     
 
@@ -2581,6 +2594,8 @@ addTerrainProvider(url)</code></pre>
 		<th>Type</th>
 		
 		
+		<th>Default</th>
+		
 		
 		<th class="last">Description</th>
 	</tr>
@@ -2591,7 +2606,7 @@ addTerrainProvider(url)</code></pre>
 	
         <tr>
             
-                <td class="name"><code>id</code></td>
+                <td class="name"><code>url</code></td>
             
             
             <td class="type">
@@ -2604,56 +2619,55 @@ addTerrainProvider(url)</code></pre>
             </td>
             
             
+                <td class="default">
+                
+                </td>
+            
             
             <td class="description last">
                 
-                <p>地形服务对象的Id</p></td>
+                    
+                    
+                        
+                    
+                
+                <p>场景服务地址。</p></td>
         </tr>
 	
 	
 	
         <tr>
             
-                <td class="name"><code>key</code></td>
+                <td class="name"><code>options</code></td>
             
             
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Object</span>
 
 
             
             </td>
             
             
-            
-            <td class="description last">
+                <td class="default">
                 
-                <p>属性名</p></td>
-        </tr>
-	
-	
-	
-        <tr>
-            
-                <td class="name"><code>value</code></td>
-            
-            
-            <td class="type">
-            
+                    {}
                 
-<span class="param-type">Any</span>
-
-
-            
-            </td>
-            
+                </td>
             
             
             <td class="description last">
                 
-                <p>属性值</p></td>
+                    
+                        <span class="optional"> 可选</span>
+                    
+                    
+                        
+                    
+                
+                <p>附加配置参数。可覆盖自动识别后的默认地形参数。</p></td>
         </tr>
 	
 	
@@ -2696,7 +2710,53 @@ addTerrainProvider(url)</code></pre>
     
     
     
+    <h5>Returns:</h5>
     
+
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Type</th>
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+    <tbody>
+    
+        <tr>
+            
+            <td class="type">
+            
+                        <a href="Promise.html">Promise</a>.&lt;(<a href="MapGISTerrainProvider.html">MapGISTerrainProvider</a>|undefined)>
+                        
+                    
+            </td>
+            <td class="description last">已初始化的地形提供器；若未识别到地形图层则返回 <code>undefined</code>。</td>
+        </tr>
+    
+    </tbody>
+</table>
+
+    
+    
+    
+        <h5>Example</h5>
+        
+
+    
+    <pre class="prettyprint"><code>// ES5引入方式
+const { MapGISTerrainProvider } = zondy.cesium
+
+// ES6引入方式
+import { MapGISTerrainProvider } from '@mapgis/webclient-cesium-plugin'
+
+const terrainProvider = await MapGISTerrainProvider.fromUrl(sceneUrl)
+if (terrainProvider) {
+  viewer.terrainProvider = terrainProvider
+}</code></pre>
+    
+
     
 </dd>
 
@@ -2714,7 +2774,7 @@ addTerrainProvider(url)</code></pre>
 
 
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:54 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>