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 optional 是否为iServer发布的TIN地形服务。
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。

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:
是否可用。