Google_Map_Api_谷歌地图接口整理.doc

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