Google Map Api 谷歌地图接口整理.doc

Google Map Api 谷歌地图接口整理
一:基本知识:
 1. 使用谷歌地图 API 的第一步就是要注册一个 API 密钥,需要注重一下两点:
    API 的页面还没有发布,只是在本地调试,可以不用密钥,随便用个字符串代替就可以了。
    密钥只对网站目录或者域有效。对不同域的网页,需要用这些域分别注册不同的密钥
<script src="http://ditu./maps?file=api&hl=&v=2&key=abcdefg" type="text/javascript"></script>
   URL(http://ditu./maps?file=api&hl=&v=2&key=abcdefg)解析:
     .:也可以用ditu.,假如你需要在地图上显示大陆以外的具体地图,就用 maps.
     =api 这个是请求API 的JS 文件用的,固定的格式。
     =
      这个是在设定地图上除了地图图片以外的诸如控件名称、版权声明、使用提示等所需要显示文本的语言版本时候用的,假如没有指定这个参数就使用 API 的默认值,对itu. 来说,默认是中文简体aps. 默认的是英文。
     4. v=2
      这个是用来指定需要导入的 API 类库的版本号,可以有四种设定方式:
        v=  稳定版本,更新最慢,但是最可靠;
        v=2 当前版本(只用主版本号),更新速度和可靠性介于 s 和 x 之间
        v= 最新版本,更新最快,包括最新功能,可能没有当前版本可靠;
        v= 指定具体版本。不建议使用。
    注:目前谷歌地图 API的主版本号是2,当API升级时旧版本只能继续使用一个月,所以要及时更改主版本号,版本号改变会在Google Code和Maps API讨论组发布相关信息
     =abcdefg这个是设定你注册的 API 密钥.
  
二:核心类:
   google地图API主要包括:地图类(GMap2)、标记类(GMarker)、标记选项类(GMarkerOptions)、折线类(GPolyline)、经纬度(GLatLng)、命名空间(GEvent)、坐标类(GPoint)、控件的大小类GSize、 interface(GControl)、地图类型类(GMapType)、地图上面的图标类(GIcon)、窗体类(GInfoWindow)、窗体选项类 GInfoWindowOptions)、接口GOverlay、枚举GMapPane等等
   注:标记和折线都是地图的覆盖物
 :地图类,下面实例化一张地图:
   var map= new GMap2(container: DOM_Div,opts: Options);
   构造函数的参数如下:
    参数       是否必要      值类型         定义
    container      是          DOM_Div    DOM元素,是个Div
    opts          可选        Options    构造函数选项
   
    GMap2包含的方法:
     :
       enableDragging():设置地图可以被拖动。
       disableDragging():禁止地图被拖动。
       draggingEnabled():返回地图是否能够被拖动的布尔值。假如能够拖动,返回"真";否则返回"假"。
       enableInfoWindow():设置地图信息窗口可以弹出。
       disableInfoWindow():禁止地图信息窗口弹出。
       infoWindowEnabled():返回地图信息窗口是否能够被弹出的布尔值。假如能够弹出,返回"真";否则返回"假"。这个方法通常作为检验之用。
       enableDoubleClickZoom():设置可以双击缩放地图,左键双击为放大,右键双击为缩小(默认)。
       disableDoubleClickZoom():禁止双击缩放地图,Google Earth 默认为禁止双击缩放。
       doubleClickZoomEnabled():返回地图是否可以双击缩放的布尔值。假如能够双击缩放,返回"真";
       enableContinuousZoom():设置