Uniscope-二次开发文档API

Uniscope-二次开发文档API
Uniscope Globe API 接口说明uniscope.globe空间
方法：void createInterface (object div, function onCreated, function onCreateFail);
参数： div: 控件创建的位置
onCreated：创建成功响应的方法
onCreateFail：创建失败响应的方法
功能：创建一个新的Globe
方法：void addEventListener (object targetObject, string eventID, function callbackListener); 参数： targetObject: 事件的触发者
eventID：触发事件ID
callbackListener：响应事件的方法
功能：添加一个全局事件
方法：void removeEventListener(object targetObject, string eventID, function callbackListener); 参数： targetObject: 事件的触发者
eventID：触发事件ID
callbackListener：响应事件的方法
功能：移除一个全局事件
属性：poiClickedHandler
类型：eventHandler
功能：poi被点击时触发的事件句柄
属性：documentChangedHandler
类型：eventHandler
功能：文档被修改时触发的事件句柄
uniscope.globe.measure
方法：void clearResult();
参数：无
功能：清除所有的测量结果
方法：void lineLength (function callbackOnResult);
参数：callbackOnResult: 测量完成的响应函数
功能：进行空间直线距离的测量
功能：挖填方分析
方法：void lineOfSight(double srcHeight, double destHeight, String pointString, function callbackOnResult );
参数： srcHeight: 原始点的相对高度
destHeight: 目标点的相对高度
pointString: 视线的顶点集
callbackOnResult: 完成后的回调函数
功能：挖填方分析
uniscope.search
方法：void createInterface( String serverUrl);
参数：serverUrl:服务的路径
功能：uniscope.search初始化
方法：void getPoiByKeyword(String keyword, String cityName, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：POI关键字查询
方法：void getPoiByRect(String keyword, String cityName, double north, double south,double east, double west, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
north, south, east, west: 矩形的参数
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：POI关键字查询
方法：void getPoiByCircle(String keyword,String cityName, double centerLon, double centerLat, double radius, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
centerLon: 圆形区域中心点经度
centerLat: 圆形区域中心点纬度
radius: 圆形区域半径
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：POI圆形区域查询
方法：void getBuildingByKeyword(String keyword, String cityName, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：Building关键字查询
方法：void getBuildingByRect(String keyword, String cityName, double north, double south, double east, double west, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
north, south, east, west: 矩形的参数
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：Building矩形区域查询
方法：void getBuildingByCircle(String keyword,String cityName, double centerLon, double centerLat, double radius, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
centerLon: 圆形区域中心点经度
centerLat: 圆形区域中心点纬度
radius: 圆形区域半径
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：Building圆形区域查询
方法：void getBuildingByPoint(String keyword,String cityName, double ptLon, double ptLat, int pageIndex, int pageLength, function callbackOnResult );
参数： keyword: 查询关键字
cityName: 城市名
ptLon: 经度
ptLat: 纬度
pageIndex: 显示页号
pageLength: 每页条数
callbackOnResult: 完成后的回调函数
功能：Building点选查询
eventHandler对象
方法：void addEventHandler(object targetObject, function callbackListener);
参数： targetObject: 事件的触发者（可设置为null）
callbackListener：响应事件的方法
功能：添加一个响应函数
方法：void removeEventHandler(object targetObject, function callbackListener); 参数： targetObject: 事件的触发者（可设置为null）
callbackListener：响应事件的方法
功能：移除一个响应函数
方法：void clearEventHandler();
参数： targetObject: 事件的触发者（可设置为null）
callbackListener：响应事件的方法
功能：清除所有的响应函数
方法：void notifyEvent(object argument);
参数：argument: 参数
功能：触发事件
IUSEarth对象
属性：ImageLayers
类型：IUSLayers
功能：获得Image 图层的集合
属性：ModelLayers
类型：IUSLayers
功能：获得Model图层的集合
属性：POILayers
类型：IUSLayers
属性：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接口
方法：void ImportXmlString(String xmlString, bool bAsync);
参数：xmlString: 导入的XmlString
bAsync: 是否异步读入
功能：将一个XmlString导入USEarth中
方法：String LoadXmlFile(String xmlFilePath);
参数：xmlFilePath: 文件的路径
功能：从本地文件中读入xmlString
方法：void SaveXmlFile(String xmlFilePath, String xmlString); 参数：xmlFilePath: 文件的路径
xmlString: 需要写入的xmlString
功能：将xmlString写入本地文件中
方法：void DeleteXmlFile (String xmlFilePath); 参数： xmlFilePath: 文件的路径
功能：删除本地文件中的xml
方法：void DeleteXmlFile (String xmlFilePath); 参数： xmlFilePath: 文件的路径
功能：删除本地文件中的xml IUSGlobeObserver接口
方法：void Forward();
参数：无
功能：视点向前移动
方法：void Backward();
参数：无
功能：视点向后移动
方法：void MoveLeft();
参数：无
功能：视点向左移动
方法：void MoveRight();
参数：无
功能：视点向右移动
方法：void TurnLeft();
参数：无
功能：视点向左旋转
方法：void TurnRight();
参数：无
功能：视点向右旋转
方法：void LookUp();
参数：无
功能：视点向上旋转
方法：void LookDown();
参数：无
功能：视点向下旋转
方法：void ZoomIn();
参数：无
功能：视点靠近目标点
方法：void ZoomOut();
参数：无
功能：视点远离目标点
方法：void Resume();
参数：无
功能：视点返回全球状态
方法：void NorthView();
参数：无
功能：视点返回到正北姿态
方法：void TopView();
参数：无
功能：视点返回到顶视姿态
方法：void Stop();
参数：无
功能：停止当前视点的运动状态
方法：void FlyTo( double lon, double lat, double alt, double heading, double tilt, double range); 参数： lon: 目标点经度
lat: 目标的纬度
alt: 目标点高程
heading: 朝向（与正北方向的夹角 0 <= heading <= 360 ）
tilt: 俯仰（垂直指向地心方向的射线的夹角。

1 <= tilt <= 89 ）
range: 摄像机到目标点的距离
功能：视点飞到制定的姿态
方法：IUSVector Pick(int x, int y);
参数： x: 屏幕坐标x
y: 屏幕坐标y
功能：获得当前点击的屏幕点在地球上的位置
方法：IUSVector PickTerrain (int x, int y);
参数： x: 屏幕坐标x
y: 屏幕坐标y
功能：获得当前点击的屏幕点在地球上的位置（只选择地形，不包含模型）
属性：Longitude
类型：double
功能：获得当前视点的经度
属性：Latitude
类型：double
功能：获得当前视点的纬度
属性：Altitude
类型：double
功能：获得当前视点的高程
属性：Heading
类型：double
功能：获得当前视点的朝向（与正北方向的夹角 0 <= heading <= 360 ）
属性：Tilt
类型：double
功能：获得当前视点的俯仰角（垂直指向地心方向的射线的夹角。

1 <= tilt <= 89 ）
属性：Range
类型：double
功能：获得当前视点的经度
IUSMeasure接口
方法：void Clear();
参数：无
功能：清除当前的所有测量工具
方法：void MeasureLineLength ();
参数：无
功能：进行空间直线距离的测量
方法：void MeasurePathLength ();
参数：无
功能：进行地表路径长度的测量
方法：void MeasureHorizontalDistance ();
参数：无
功能：进行水平距离长度的测量
方法：void MeasureHeight ();
参数：无
功能：进行垂直距离长度的测量
方法：void MeasureArea ();
参数：无
功能：进行球面面积的测量
IUSTrackControl接口
方法：void SetTrack(String xmlTrack); 参数：xmlTrack: 使用xml描述的飞行路径功能：设置当前的飞行路径（使用xml描述）
方法：void Show(String xmlTrack);
参数：xmlTrack: 使用xml描述的飞行路径功能：设置当前显示的飞行路径
方法：void Play();
参数：无
功能：开始飞行当前的飞行路径
方法：void Pause();
参数：无
功能：暂停
方法：void Resume();
参数：无
功能：继续
方法：void Stop();
参数：无
功能：停止
属性：Visible
类型：double
功能：获得/设置飞行路线是否显示
IUSFactory接口
方法：IUSPoint CreatePoint();
参数：无
功能：创建一个IUSPoint对象
方法：IUSPoints CreatePoints();
参数：无
功能：创建一个IUSPoints对象
方法：IUSVector CreateVector();
参数：无
功能：创建一个IUSVector对象
方法：IUSVectors CreateVectors();
参数：无
功能：创建一个IUSVectors对象
方法：String CreateGUID();
参数：无
功能：创建一个Guid
IUSShapeCreator接口
方法：void Clear();
参数：无
功能：清除当前的所有创建工具
方法：void CreateLine ();
参数：无
功能：创建一条直线对象，通过OnCreateLine事件返回创建的直线
方法：void CreatePolyline (double width, dword color);
参数：width：宽度（为0时自动计算）
color：颜色（一个dword值，比如0xffff0000(红色) ）
功能：创建一条折线对象，通过On CreatePolyline事件返回创建的折线
方法：void CreatePolygon ();
参数：无
功能：创建一个多边形对象
方法：void CreateCircle ();
参数：无
功能：创建一个圆形对象
方法：void CreateRectangle ();
参数：无
功能：创建一个矩形对象
方法：void CreateSphere ();
参数：无
功能：创建一个球形对象
方法：void CreateSector ();
参数：无
功能：创建一个扇形对象
IUSPaint接口
方法：void DrawPoint(IUSVectors* pVector, dword color);
参数：无
功能：绘制点集
方法：void DrawLine(IUSVectors* pVector, dword color);
参数：无
功能：绘制线
方法：void DrawPoly(IUSVectors* pVector, dword color);
参数：无
功能：绘制多边形
方法：void DrawCubicSpline(IUSVectors* pVector, dword color);
参数：无
功能：绘制三次样条曲线
方法：void DrawBox(double north, double south, double east, double west, double upper_height, double lower_height, dword color);
参数：无
功能：绘制Box
方法：void DrawText(double lon, double lat, double alt, String text, dword color)
参数：无
功能：绘制文字
方法：void DrawIcon(double lon, double lat, double alt, String text, dword color)参数：无
功能：绘制图标
方法：void Clear()
参数：无
功能：清除所有绘制的图元
IUSHtmlBalloon接口
方法：IUSPoint ShowString(String htmlString, int x, int y, int width, int height); 参数：htmlString: 需要显示的HTML串
x: HtmlBalloon显示的位置x
y: HtmlBalloon显示的位置y
width: HtmlBalloon的宽度（设置为0将自动计算）
height: HtmlBalloon的高度（设置为0将自动计算）
功能：在HtmlBalloon中显示指定的HTML串
方法：IUSPoint Show (String urlString, int x, int y, int width, int height);
参数：urlString: 需要显示的页面地址
x: HtmlBalloon显示的位置x
y: HtmlBalloon显示的位置y
width: HtmlBalloon的宽度（设置为0将自动计算）
height: HtmlBalloon的高度（设置为0将自动计算）
功能：在HtmlBalloon中显示指定的页面
方法：void Hide();
参数：无
功能：隐藏HtmlBalloon
IUSEvent接口
事件：OnLBDown（IUSPoints pt）
功能：鼠标左键按下事件
事件：OnLBUp
功能：鼠标左键弹起事件
事件：OnRBDown
功能：鼠标右键按下事件
事件：OnDblClick
功能：鼠标双击事件
事件：OnDocumentChanged
功能：当文档改变的时候的事件
事件：OnMeasureLineLengthFinish
功能：空间直线距离测量完成事件
事件：OnMeasurePathLengthFinish
功能：地表路径测量完成事件
事件：OnMeasureHorizontalDistanceFinish 功能：水平距离长测量完成事件
事件：OnMeasureHeightFinish
功能：垂直距离测量完成事件
事件：OnMeasureAreaFinish
功能：球面面积测量完成事件
事件：OnTrackFinish
功能：沿线飞行完成事件
事件：OnCreateLine
功能：创建直线完成事件
事件：OnCreatePolyline
功能：创建折线完成事件
事件：OnCreatePolygon
功能：创建多边形完成事件
事件：OnCreateCircle
功能：创建圆完成事件
事件：OnCreateRectangle
功能：创建矩形完成事件
事件：OnCreateSphere
功能：创建球形完成事件
事件：OnCreateSector
功能：创建扇形完成事件
事件：OnPoiClicked
功能：POI被点击事件
事件：OnHTMLBalloonClickNewWindow
功能：HtmlBalloon的新开窗口被点击而触发的事件。