CesiumTerrainProvider

new Cesium.CesiumTerrainProvider(options)

提供地形切片，通过STK地形服务或者SuperMap iServer REST API。
Name Type Description
options Object 包含以下属性的对象:
Name Type Default Description
url String 地形服务的url。
proxy Proxy optional 服务代理。
requestVertexNormals Boolean false optional 是否请求法线（用于光照效果），默认不请求。
requestWaterMask Boolean false optional 是否请求水面标志位（用于水面特效），默认不请求。
ellipsoid Ellipsoid optional 椭球体，默认为WGS84。
credit Credit | String optional 服务描述信息。
isSct Boolean true optional 是否为iServer发布的TIN地形服务,stk地形设置为false。
isShowGlobe Boolean optional 是否剔除无效地形区域,默认为true（全球显示）。
invisibility Boolean optional 是否开启设置地形显隐的功能,默认为false。
packingRequest PackingRequest optional 批量请求编码方式。
Example:
var  terrainProvider = new Cesium.CesiumTerrainProvider({
	                        url : ‘http://localhost:8090/Terrain’,
		                    requestWaterMask : true,
		                    requestVertexNormals : true,
		                    isSct : true
                     });
var viewer = new Cesium.Viewer(‘cesiumContainer’,{
                  terrainProvider : terrainProvider
             });

Members

credit : Credit

获取该地形服务的描述信息。

currentVersion : String

获取或者设置当前使用的地形数据的版本。目前仅支持tin地形数据。

customRequestHeaders : Object

获取或者设置自定义请求头。

hasVertexNormals : Boolean

获取当前地形是否有顶点法线。 不能在CesiumTerrainProvider#ready 返回TRUE之前调用。

hasWaterMask : Boolean

是否有水面标志。

readonlyhistoryVersions : String

获取地形数据的所有历史版本信息。目前仅支持tin地形数据。

indexedDBSetting : Object

获取或者设置地形的indexedDB缓存是否开启(IE浏览器不支持)。
Example:
//设置是否保存地形缓存到浏览器的indexedDB数据库
viewer.terrainProvider.indexedDBSetting.isOpen = true

isCreateSkirt : Boolean

获取或者设置是否创建裙边，裙边用于规避地形裂缝问题，默认true正常显示，反之false关闭。

isShowGlobe : Boolean

获取或者设置是否剔除无效地形区域（用于TIN地形），默认为true，全球显示。

packingRequest

批量请求编码方式。
See:

ready : Boolean

获取该地形服务是否就绪。

readonlyreadyPromise : Promise.<Boolean>

获取该地形服务的就绪状态promise对象。

requestVertexNormals : Boolean

是否请求顶点法线。

requestWaterMask : Boolean

是否请求水面标志位。

subdomains : String

获取或者设置子域名称。通过该接口可以向指定的子域请求数据。

tilingScheme : GeographicTilingScheme

获取该地形服务的投影对象（经纬度或者墨卡托投影）。

visible : Boolean

获取或者设置地形是否可见。利用该接口，可以实现在不刷新地球的同时设置地形的显隐。需要在创建CesiumTerrainProvider时将invisibility设置为true。
Example:
var viewer = new Cesium.Viewer('cesiumContainer',{
        //创建地形服务提供者的实例，url为SuperMap iServer发布的TIN地形服务
        terrainProvider : new Cesium.CesiumTerrainProvider({
            url : URL_CONFIG.SiChuan_TERRAIN,
            isSct : true,//地形服务源自SuperMap iServer发布时需设置isSct为true
            invisibility:true//隐藏地形时需设置 invisibility为true
        }),
    });
         //添加SuperMap iServer发布的影像服务
         var layer = viewer.imageryLayers.addImageryProvider(new Cesium.SuperMapImageryProvider({
        url : URL_CONFIG.SiChuan_IMG
     }));

Methods

getLevelMaximumGeometricError(level) → Number

获取该层级的最大几何误差。
Name Type Description
level Number tile层级。
Returns:
最大几何误差。

getTileDataAvailable(x, y, level) → Boolean

获取x y level对应的瓦片数据是否可用。
Name Type Description
x Number x坐标。
y Number y坐标。
level Number tile层级。
Returns:
是否可用。