layer~HRTELayer(name, hrteUrl, options)

地形地貌图层， 常与遥感影像一起来表达高低起伏的地表形态。该图层有以下特点：
1.数据来源依赖于空间信息服务平台发布的HRTE服务。
2.地形地貌以三维而非二维的形式来表现。
3.当前版本仅支持陆地上的地形，暂不支持海底地形。

Extends:

Summary

Methods:
fromHMapPlatform

通过空间信息服务平台元数据创建图层
clearLocalStorage

清空客户端存储的数据即useLocalStorage为true时缓存到indexeddb中的数据
getExaggeration

获取地形夸张系数
setDrawMode

设置绘制模式，使地形地貌图层按照点、线、面不同的形式展示。注意：图层添加到地图上之后调用有效，
setExaggeration

设置地形夸张系数

Constructor

new HRTELayer(name, hrteUrl, options)

Parameters:
Name Type Description
name String

图层名称
hrteUrl String

服务地址，来源于空间信息服务平台的HRTE服务。
options Object
Name Type Description
dataFormat String

影像瓦片的格式，支持"png"|"jpg"|"bmp"|"webp"。默认为“png”
enableLight Number

是否允许使用光照来增强地形地貌的三维表现效果，默认为true。
dataMaxLevel Number

整数，表示当前图层中瓦片数据的最大级别，当地图缩放超过该值时，该图层中瓦片数据将被继续渲染。如果不设置或该值大于地图最大级别，则默认按地图对象的最大级别算。最佳实践值为HRTE的影像数据的最大有效层级，该值可以从服务元数据中获取到。
terrainDataMaxLevel Number

地形数据的最大有效级别。超过该级别，直接展示不带高程的影像数据。该值可以从服务元数据中获取到。
fixCrack Boolean

是否修补地形地貌裂缝，注意ctb三角算法下的地形地貌数据需要开启该选项,默认为true。
exaggeration Number

地形地貌夸张系数,增加或者减小地形起伏的幅度。大于0的数值，默认为1。
showHeightLine Boolean

是否显示等高线，默认为false。
heightLineInterval Number

等高线显示间隔，地图单位，可以通过地图对象上的getDegreePerMeter和getMeterPerDegree方法，对地图单位进行度和米的转换，默认为0.001。
heightLineWidth Number

等高线的宽度，单位像素，默认为1。
heightLineColor module:style~Color

等高线颜色，默认为红色。
heightLineMinHeight Number

等高线显示的最小高度，地图单位，可以通过地图对象上的getDegreePerMeter和getMeterPerDegree方法，对地图单位进行度和米的转换，默认为0。
colorsByHeight Array.<Object>

根据高度对地形地貌进行分层设色，不同的高度区间使用不同的颜色展示，默认为空数组，即不进行分层设色。数组中单个元素为{minHeight:0, maxHeight:0.002, color:new hmap.style.Color(179,200,137,1)}，即高度分段的最小高度、最大高度和其对应的颜色。
colorsByGlope Array.<Object>

根据坡度着色，默认为空数组，即不进行坡度着色。数组中单个元素为{glope:0, color:new hmap.style.Color(0,247,0,1)}，即坡度值和其对应的颜色。
colorsByGlopeDirection Array.<Object>

根据坡向着色，默认为空数组，即不进行坡向着色。数组中单个元素为{angle:0, color:new hmap.style.Color(0, 255, 255, 1)}，即坡向范围角度值和其对应的颜色。
useLocalStorage Boolean

是否启用客户端存储。若启用，浏览地图时请求的地形地貌瓦片和纹理图片将存储在客户端，再次浏览时将不再向服务端请求。默认true。
useWebWorker Boolean

是否开启多线程，开启多线程后，会自动开启客户端缓存useLocalStorage，默认为false。
baseGroundLayer Boolean

是否三维基础图层，如果设置成三维基础图层，贴地绘制的图层将会绘制到该图层上。
checkCameraCollisions Boolean

是否开启与相机的碰撞检测，开启后，控件交互时，相机不会进入场景内部。
collisionHeight Number

碰撞检测的高度阈值，当相机高度小于场景高度与碰撞高度之和时，判断相机与图层发生了碰撞。

Members

depthTest

获取图层的深度测试属性
return {Boolean} 深度测试属性

Overrides:

Methods

static fromHMapPlatform(metadataUrl, options) → {Promise}

通过空间信息服务平台元数据创建图层

Parameters:
Name Type Description
metadataUrl String

空间信息服务平台服务对应的元数据地址
options options

可选项，对空间信息服务平台元数据不包含的可选项进行补充，若传入的可选项与元数据中重复，以元数据为准。
Returns:
Promise -

图层创建的promise，resolve返回图层实例

clearLocalStorage() → {Promise}

清空客户端存储的数据即useLocalStorage为true时缓存到indexeddb中的数据

Returns:
Promise -

返回清空本地数据的信息（message）

getExaggeration() → {Number}

获取地形夸张系数

Returns:
Number -

地形夸张系数

setDrawMode(mode)

设置绘制模式，使地形地貌图层按照点、线、面不同的形式展示。注意：图层添加到地图上之后调用有效，

Parameters:
Name Type Description
mode String

模式，枚举类型包括"line"，"point","triangle" 三种，不设置或者设置其他使用"triangle"
Example
map.addLayer(hrteLayer); //添加地形图层
       hrteLayer.setDrawMode('line')  //改变绘制模式

setExaggeration(exag)

设置地形夸张系数

Parameters:
Name Type Description
exag Number

地形夸张系数。大于0的数值，小于0或非数值类型则不进行更改