Google Map Api 谷歌地图接口整理
一：基本知识：
1. 使用谷歌地图 API 的第一步就是要注册一个 API 密钥，需要注重一下两点：
1.假如使用 API 的页面还没有发布，只是在本地调试，可以不用密钥，随便用个字符串代替就可以了。
2.API 密钥只对网站目录或者域有效。对不同域的网页，需要用这些域分别注册不同的密钥
2.页面引用javascript文件<script src="le/maps?file=api&hl=zh-CN&v=2&key=abcdefg" type="text/javascript"></script>
歌曲请到天涯海角来 URL（le/maps?file=api&hl=zh-CN&v=2&key=abcdefg）解析：
le：也可以用le，假如你需要在地图上显示大陆以外的具体地图，就用 le
2.file=api 这个是请求API 的JS 文件用的,固定的格式。
3.hl=zh-CN
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. 设置状态的方法：
----------------------------------地图拖动-----------------------------------------------------------
hillsong enableDragging()：设置地图可以被拖动。
disableDragging()：禁止地图被拖动。
enableInfoWindow()：设置地图信息窗口可以弹出。
disableInfoWindow()：禁止地图信息窗口弹出。
infoWindowEnabled()：返回地图信息窗口是否能够被弹出的布尔值。假如能够弹出，返回"真"；否则返回"假"。这个方法通常作为检验之用。
enableDoubleClickZoom()：设置可以双击缩放地图，左键双击为放大，右键双击为缩小（默认）。
disableDoubleClickZoom()：禁止双击缩放地图，Google Earth 默认为禁止双击缩放。
doubleClickZoomEnabled()：返回地图是否可以双击缩放的布尔值。假如能够双击缩放，返回"真"；
-------------------------------------------连续平滑缩放------------------------------------------------------
enableContinuousZoom()：设置地图可以连续平滑地缩放。
disableContinuousZoom()：禁止地图连续平滑地缩放。
continuousZoomEnabled()：返回地图是否可以连续平滑地缩放的布尔值。假如能够连续平滑地缩放，返回"真"；否则返回"假"。
-------------------------------------------鼠标滚轮控制缩放------------------------------------------------
enableScrollWheelZoom()：设置地图可以由鼠标滚轮控制缩放。
disableScrollSheelZoom()听见凉山歌词：禁止由鼠标滚轮控制地图缩放。
scrollWheelZoomEnabled()：返回地图缩放是否可以由鼠标滚轮控制。假如能够由鼠标滚轮控制缩放，返回"真"；否则返回"假"。
isLoaded() 返回类型布尔值 假如地图已经被setCenter()初始化，则返回true.
2.得到地图的数据信息方法：
getCenter() 返回类型GLatLng 返回地图中心点的地图坐标.
getBounds() 返回类型GLatLngBounds 返回地图视口范围的矩形区域的地理坐标.
getBoundsZoomLevel(bounds) 返回类型数字返回显示指定的区域需要的最适合的地图缩放等级.该缩放等级是根据当前的地图类型计算出来的，假如还没有指定地图类型,将使用地图类型数组之中的第一项.
getSize() 返回类型GSize 返回地图视口的像素大小.
getZoom() 返回数字 返回当前的缩放等级.
吴克 没关系 getContainer()：取得地图的容器
getCurrentMapType()得到当前的地图类型。注重得到的是地图类型GMapType对象，而不是对象名称
3.设置地图：
setCenter(center, zoom?, type?)将地图视图切换到指定的中心点,也可以同时设置可选的地图缩放等级和地图类型.地图类型必须已经添加到地图.
addMapType()该方法必须在构造地图实例之后初始化地图状态时立即执行.在地图刚刚构造的时候调用地图其他的方法都将会产生错误.
panTo(center) 设置地图的中心点到指定的坐标，假如该点已经在当前的视口之中，则地图中心会滑动到该位置.
panBy(distance) 地图滑动指定的像素距离.
孙江枫 panDirection(dx, dy) 以指定的方向滑动地图宽度一半的距离.+1代表右方和下方,-1代表左方和上方.
setZoom(level)设置地图的缩放等级到给定值.
zoomIn()缩小地图(将地图的缩放等级增加1).
zoomOut()放大地图(将地图的缩放等级减少1).
savePosition()保存地图当前的位置和缩放等级,以供以后通过returnToSavedPosition()方法来返回当前视图.
returnToSavedPosition()返回到上一次通过savePosition()保存的地图视图.
checkResize()检查地图容器(container)的大小是否已经发生变化,在地图容器DOM大小可能发生变化的时候调用该方法,以便地图能进行自动调整.
setMapType(GMapType):设置地图类型：大概有三种类型：G_NORMAL_MAP,G_SATELLITE_MAP,G_PHYSICAL_MAP，
removeMapType(GMapType)从当前地图上删除一个地图类型。
enableGoogleBar():设置地图上的搜索栏
4.有关地图覆盖物的方法：
addOverlay(overlay) 在地图上添加一个标注并触发地图的addoverlay事件.
removeOverlay(overlay) 在地图上删除指定的标注.假如该标注确实在地图上.
发布评论