Google Earth COM API学习笔记.doc

Google API
1. API Classes
Here are the classes, structs, unions and interfaces with brief descriptions:
2. IApplicationGE接口
是Google Earth API开发中最重要的一个接口,通过该接口可以控制Google Earth程序的开启、关闭、获取地图窗口的句柄、操作主窗体句柄,还可以进行获取地图视场照相机对象、获取Google Earth版本号、转换坐标等一系列复杂操作。它是基于Google Earth API程序开发的基础。
初始化
打开Google Earth程序,首先要登录远程的Google地图服务器,Google Earth会在本地与服务器之间打开一个会话通道,然后等待十多秒钟之后,才能看见蓝黑色的地球。通常情况下,进行Google Earth API的二次开发时,自己的程序也需要走这些步骤。
如何才能得知Google Earth已经注册好呢?Google 的API中提供了几个反馈Google Earth是否已经登录到服务器上注册完毕的函数,通过这些函数,可以在Google Earth初始化之后执行自己的业务代码,操作Google Earth完成相应动作。而没判断是否初始化结束就直接操作Google Earth,可能会导致错误。
这些与初始化相关的设置共有4个:IsInitialized、IsOnline、Login、Logout。
视场相机设置
IApplicationGE接口提供了一个获得"视场照相机"的对象的方法GetCamera和SetCamera。
SetCameraParams为调整当前Google Earth的视场焦点的各个参数,无须重新定义照相对象:
ApplicationGEClass appGE = new ApplicationGEClass();  
…… 
private void SetCamParm()  
{  
    double tmplat, tmplng, tmpalt, tmprange, 
tmptilt, tmpAzimuth, tmpSpeed;  
    tmplat = ;     //焦点纬度 
    tmplng = ;   //焦点经度 
    tmpalt = 0;        //焦点高度 
    tmprange = 500;   //视场范围 
    tmptilt = 45;     //镜头倾角 
    tmpAzimuth = 0;   //镜头方位角 
    tmpSpeed = 4;     //相机移动速度 
    (tmplat, tmplng, tmpalt,
(AltitudeModeGE)1, tmprange,    tmptilt, 
tmpAzimuth, tmpSpeed);  
} 
截屏设置
Google Earth有个很有用的功能,按【Ctrl+Alt+S】组合键,可以保存当前地图的截图照片,默认是JPG格式的彩***片。IApplicationGE接口也提供了一个SavaScreenShot方法,可以获得当前地图窗口内容的灰度图片,是黑白的。
SaveScreenShot为当前地图视场范围截屏,保存成黑白效果的图片。保存的黑白照片可以定义清晰程度。
private void button2_Click(object sender, EventArgs e)
{
string ssFile = bine(, "");
try
{
//quality的Ì?取¨?值¦Ì范¤?围¡ì在¨²(0,100)之?间?,ê?质¨º量¢?越?高?,ê?quality越?大䨮
(ssFile, 100);
("成¨¦功|保À¡ê存ä?截?屏¨¢图ª?像?:êo" + ssFile);
}
catch (Exception ex)
{
("保À¡ê存ä?截?屏¨¢图ª?像?时º¡À发¤¡é生¦¨²错䨪误¨®:êo" + );
}
}
加载KML操作
API中也提供了两个功能类似的方法--OpenKMLFile和LoadKMLData,这两个方法都可以向Google Earth加载