Uniscope 二次开发文档API.docx
《Uniscope 二次开发文档API.docx》由会员分享，可在线阅读，更多相关《Uniscope 二次开发文档API.docx（19页珍藏版）》请在冰豆网上搜索。
Uniscope二次开发文档API
UniscopeGlobeAPI接口说明
uniscope.globe空间
方法：
voidcreateInterface（objectdiv,functiononCreated,functiononCreateFail）;
参数：
div:
控件创建的位置
onCreated：
创建成功响应的方法
onCreateFail：
创建失败响应的方法
功能：
创建一个新的Globe
方法：
voidaddEventListener（objecttargetObject,stringeventID,functioncallbackListener）;
参数：
targetObject:
事件的触发者
eventID：
触发事件ID
callbackListener：
响应事件的方法
功能：
添加一个全局事件
方法：
voidremoveEventListener（objecttargetObject,stringeventID,functioncallbackListener）;
参数：
targetObject:
事件的触发者
eventID：
触发事件ID
callbackListener：
响应事件的方法
功能：
移除一个全局事件
属性：
poiClickedHandler
类型：
eventHandler
功能：
poi被点击时触发的事件句柄
属性：
documentChangedHandler
类型：
eventHandler
功能：
文档被修改时触发的事件句柄
uniscope.globe.measure
方法：
voidclearResult（）;
参数：
无
功能：
清除所有的测量结果
方法：
voidlineLength（functioncallbackOnResult）;
参数：
callbackOnResult:
测量完成的响应函数
功能：
进行空间直线距离的测量
方法：
voidpathLength（functioncallbackOnResult）;
参数：
callbackOnResult:
测量完成的响应函数
功能：
进行地表路径长度的测量
方法：
voidsphericalArea（functioncallbackOnResult）;
参数：
callbackOnResult:
测量完成的响应函数
功能：
进行球面面积的测量
方法：
voidhorizontalDistance（functioncallbackOnResult）;
参数：
callbackOnResult:
测量完成的响应函数
功能：
进行水平距离长度的测量
方法：
voidverticalDistance（functioncallbackOnResult）;
参数：
callbackOnResult:
测量完成的响应函数数
功能：
进行垂直距离长度的测量
uniscope.analysis
方法：
voidcreateInterface（StringserverUrl）;
参数：
serverUrl:
分析服务的路径
功能：
uniscope.analysis初始化
方法：
voidthreatDome（inttype,doubleheight,doubleradius,doublelongitude,doublelatitude,doublealtitude,functioncallbackOnResult）;
参数：
type:
类型（1为只针对地形，2为只针对模型，3为针对地形和模型）
height:
目标点的相对高度
radius:
半径
longitude:
目标点所在的经度
latitude:
目标点所在的纬度
altitude:
目标点所在的地面高度
callbackOnResult:
完成后的回调函数
功能：
危险域分析
方法：
voidviewShed（inttype,doubleangle,doubleheight,doubleradius,doubleheading,doubletilt,doublelongitude,doublelatitude,doublealtitude,functioncallbackOnResult）;
参数：
type:
类型（1为只针对地形，2为只针对模型，3为针对地形和模型）
angle:
视角
height:
目标点的相对高度
radius:
半径
heading:
朝向
tilt:
俯仰
longitude:
目标点所在的经度
latitude:
目标点所在的纬度
altitude:
目标点所在的地面高度
callbackOnResult:
完成后的回调函数
功能：
可视域分析
方法：
voidbestPath（doubleclimb_limited,doubledescent_limited,StringpointString,functioncallbackOnResult）;
参数：
climb_limited:
向上的最大坡度
descent_limited:
向下的最大坡度
pointString:
线段的点集
callbackOnResult:
完成后的回调函数
功能：
最佳路径分析
方法：
voidvalley（inttype,doublesubWater,doubleradius,StringpointString,functioncallbackOnResult）;
参数：
type:
类型（1为只针对地形，2为只针对模型，3为针对地形和模型）
subWater:
水平面高度
radius:
水淹半径
pointString:
线段的点集
callbackOnResult:
完成后的回调函数
功能：
流域分析
方法：
voidbuffer（doublesubWater,doubleradius,doublelongitude,doublelatitude,functioncallbackOnResult）;
参数：
subWater:
水平面高度
radius:
水淹半径
longitude:
点源的经度
latitude:
点源的纬度
callbackOnResult:
完成后的回调函数
功能：
点源分析
方法：
voidsurfaceArea（StringpointString,functioncallbackOnResult）;
参数：
pointString:
面的顶点集
callbackOnResult:
完成后的回调函数
功能：
表面面积分析
方法：
voidterrainProfile（StringpointString,functioncallbackOnResult）;
参数：
pointString:
剖面的顶点集
callbackOnResult:
完成后的回调函数
功能：
剖面分析
方法：
voidexcavation（doublesubWater,StringpointString,functioncallbackOnResult）;
参数：
subWater:
水平面高度
pointString:
面的顶点集
callbackOnResult:
完成后的回调函数
功能：
挖填方分析
方法：
voidlineOfSight（doublesrcHeight,doubledestHeight,StringpointString,functioncallbackOnResult）;
参数：
srcHeight:
原始点的相对高度
destHeight:
目标点的相对高度
pointString:
视线的顶点集
callbackOnResult:
完成后的回调函数
功能：
挖填方分析
uniscope.search
方法：
voidcreateInterface（StringserverUrl）;
参数：
serverUrl:
服务的路径
功能：
uniscope.search初始化
方法：
voidgetPoiByKeyword（Stringkeyword,StringcityName,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
POI关键字查询
方法：
voidgetPoiByRect（Stringkeyword,StringcityName,doublenorth,doublesouth,doubleeast,doublewest,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
north,south,east,west:
矩形的参数
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
POI关键字查询
方法：
voidgetPoiByCircle（Stringkeyword,StringcityName,doublecenterLon,doublecenterLat,doubleradius,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
centerLon:
圆形区域中心点经度
centerLat:
圆形区域中心点纬度
radius:
圆形区域半径
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
POI圆形区域查询
方法：
voidgetBuildingByKeyword（Stringkeyword,StringcityName,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
Building关键字查询
方法：
voidgetBuildingByRect（Stringkeyword,StringcityName,doublenorth,doublesouth,doubleeast,doublewest,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
north,south,east,west:
矩形的参数
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
Building矩形区域查询
方法：
voidgetBuildingByCircle（Stringkeyword,StringcityName,doublecenterLon,doublecenterLat,doubleradius,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
centerLon:
圆形区域中心点经度
centerLat:
圆形区域中心点纬度
radius:
圆形区域半径
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
Building圆形区域查询
方法：
voidgetBuildingByPoint（Stringkeyword,StringcityName,doubleptLon,doubleptLat,intpageIndex,intpageLength,functioncallbackOnResult）;
参数：
keyword:
查询关键字
cityName:
城市名
ptLon:
经度
ptLat:
纬度
pageIndex:
显示页号
pageLength:
每页条数
callbackOnResult:
完成后的回调函数
功能：
Building点选查询
eventHandler对象
方法：
voidaddEventHandler（objecttargetObject,functioncallbackListener）;
参数：
targetObject:
事件的触发者（可设置为null）
callbackListener：
响应事件的方法
功能：
添加一个响应函数
方法：
voidremoveEventHandler（objecttargetObject,functioncallbackListener）;
参数：
targetObject:
事件的触发者（可设置为null）
callbackListener：
响应事件的方法
功能：
移除一个响应函数
方法：
voidclearEventHandler（）;
参数：
targetObject:
事件的触发者（可设置为null）
callbackListener：
响应事件的方法
功能：
清除所有的响应函数
方法：
voidnotifyEvent（objectargument）;
参数：
argument:
参数
功能：
触发事件
IUSEarth对象
属性：
ImageLayers
类型：
IUSLayers
功能：
获得Image图层的集合
属性：
ModelLayers
类型：
IUSLayers
功能：
获得Model图层的集合
属性：
POILayers
类型：
IUSLayers
功能：
获得POI图层的集合
属性：
VectorLayers：
类型：
IUSLayers
功能：
获得Vector图层的集合
属性：
UserDocument
类型：
IUSUserDocument
功能：
获得用户数据文档
属性：
GlobeObserver
类型：
IUSGlobeObserver
功能：
获得摄像机
属性：
TrackControl
类型：
IUSTrackControl
功能：
获得飞行路线控制器
属性：
Factory
类型：
IUSFactory
功能：
对象工厂
属性：
Measure
类型：
IUSMeasure
功能：
测量模块
属性：
ShapeCreator
类型：
IUSShapeCreator
功能：
几何对象创建
属性：
Paint
类型：
IUSPaint
功能：
绘制简单几何图形的接口
属性：
HtmlBalloon
类型：
IUSHtmlBalloon
功能：
HTML弹出气泡
属性：
Event
类型：
IUSEvent
功能：
事件模块
属性：
RootPath
类型：
String
功能：
获得文档所在的根目录
IUSLayers接口
属性：
Count
类型：
Int
功能：
获得图层的数量
属性：
Item
类型：
IUSLayer
功能：
获得某一图层
;
IUSLayer接口
属性：
Name
类型：
String
功能：
获得图层的名字
属性：
Visible
类型：
Boolean
功能：
获得/设置图层的可见性
IUSUserDocument接口
方法：
voidImportXmlString（StringxmlString,boolbAsync）;
参数：
xmlString:
导入的XmlString
bAsync:
是否异步读入
功能：
将一个XmlString导入USEarth中
方法：
StringLoadXmlFile（StringxmlFilePath）;
参数：
xmlFilePath:
文件的路径
功能：
从本地文件中读入xmlString
方法：
voidSaveXmlFile（StringxmlFilePath,StringxmlString）;
参数：
xmlFilePath:
文件的路径
xmlString:
需要写入的xmlString
功能：
将xmlString写入本地文件中
方法：
voidDeleteXmlFile（StringxmlFilePath）;
参数：
xmlFilePath:
文件的路径
功能：
删除本地文件中的xml
方法：
voidDeleteXmlFile（StringxmlFilePath）;
参数：
xmlFilePath:
文件的路径
功能：
删除本地文件中的xml
IUSGlobeObserver接口
方法：
voidForward（）;
参数：
无
功能：
视点向前移动
方法：
voidBackward（）;
参数：
无
功能：
视点向后移动
方法：
voidMoveLeft（）;
参数：
无
功能：
视点向左移动
方法：
voidMoveRight（）;
参数：
无
功能：
视点向右移动
方法：
voidTurnLeft（）;
参数：
无
功能：
视点向左旋转
方法：
voidTurnRight（）;
参数：
无
功能：
视点向右旋转
方法：
voidLookUp（）;
参数：
无
功能：
视点向上旋转
方法：
voidLookDown（）;
参数：
无
功能：
视点向下旋转
方法：
voidZoomIn（）;
参数：
无
功能：
视点靠近目标点
方法：
voidZoomOut（）;
参数：
无
功能：
视点远离目标点
方法：
voidResume（）;
参数：
无
功能：
视点返回全球状态
方法：
voidNorthView（）;
参数：
无
功能：
视点返回到正北姿态
方法：
voidTopView（）;
参数：
无
功能：
视点返回到顶视姿态
方法：
voidStop（）;
参数：
无
功能：
停止当前视点的运动状态
方法：
voidFlyTo（doublelon,doublelat,doublealt,doubleheading,doubletilt,doublerange）;
参数：
lon:
目标点经度
lat:
目标的纬度
alt:
目标点高程
heading:
朝向（与正北方向的夹角0<=heading<=360）
tilt:
俯仰（垂直指向地心方向的射线的夹角。
1<=tilt<=89）
range:
摄像机到目标点的距离
功能：
视点飞到制定的姿态
方法：
IUSVectorPick（intx,inty）;
参数：
x:
屏幕坐标x
y:
屏幕坐标y
功能：
获得当前点击的屏幕点在地球上的位置
方法：
IUSVectorPickTerrain（intx,inty）;
参数：
x:
屏幕坐标x
y:
屏幕坐标y
功能：
获得当前点击的屏幕点在地球上的位置（只选择地形，不包含模型）
属性：
Longitude
类型：
double
功能：
获得当前视点的经度
属性：
Latitude
类型：
double
功能：
获得当前视点的纬度
属性：
Altitude
类型：
double
功能：
获得当前视点的高程
属性：
Heading
类型：
double
功能：
获得当前视点的朝向（与正北方向的夹角0<=heading<=360）
属性：
Tilt
类型：
double
功能：
获得当前视点的俯仰角（垂直指向地心方向的射线的夹角。
1<=tilt<=89）
属性：
Range
类型：
double
功能：
获得当前视点的经度
IUSMeasure接口
方法：
voidClear（）;
参数：
无
功能：
清除当前的所有测量工具
方法：
voidMeasureLineLength（）;
参数：
无
功能：
进行空间直线距离的测量
方法：
voidMeasurePathLength（）;
参数：
无
功能：
进行地表路径长度的测量
方法：
voidMeasureHorizontalDistance（）;
参数：
无
功能：
进行水平距离长度的测量
方法：
voidMeasureHeight（）;
参数：
无
功能：
进行垂直距离长度的测量
方法：
voidMeasureArea（）;
参数：
无
功能：
进行球面面积的测量
IUSTrackControl接口
方法：
voidSetTrack（StringxmlTrack）;
参数：
xmlTrack:
使用xml描述的飞行路径
功能：
设置当前的飞行路径（使用xml描述）
方法：
voidShow（StringxmlTrack）;
参数：
xmlTrack:
使用xml描述的飞行路径
功能：
设置当前显示的飞行路径
方法：
voidPlay（）;
参数：
无
功能：
开始飞行当前的飞行路径
方法：
voidPause（）;
参数：
无
功能：
暂停
方法：
voidResume（）;
参数：
无
功能：
继续
方法：
voidStop（）;
参数：
无
功能：
停止
属性：
Visible
类型：
double
功能：
获得/设置飞行路线是否显示
IUSFactory接口
方法：
IUSPointCreatePoint（）;
参数：
无
功能：
创建一个IUSPoint对象
方法：
IUSPointsCreatePoints（）;
参数：
无
功能：
创建一个IUSPoints对象
方法：
IUSVectorCreateVector（）;
参数：
无
功能：
创建一个IUSVector对象
方法：
IUSVectorsCreateVectors（）;
参数：
无
功能：
创建一个IUSVectors对象
方法：
StringCreateGUID（）;
参数：
无
功能：
创建一个Guid
IUSShapeCreator接口
方法：
voidClear（）;
参数：
无
功能：
清除当前的所有创建工具
方法：
voidCreateLine（）;
参数：
无
功能：
创建一条直线对象，通过OnCreateLine事件返回创建的直线
方法：
voidCreatePolyline（doublewidth,dwordcolor）;
参数：
width：
宽度（为0时自动计算）
color：
颜色（一个dword值，比如0xffff0000（红色））
功能：
升级会员 