Google Map Api 谷歌地图接口整理

Google Map Api 谷歌地图接口整理一：基本知识：1. 使用谷歌地图API 的第一步就是要注册一个API 密钥，需要注重一下两点：1.假如使用API 的页面还没有发布，只是在本地调试，可以不用密钥，随便用个字符串代替就可以了。

2.API 密钥只对网站目录或者域有效。

对不同域的网页，需要用这些域分别注册不同的密钥2.页面引用javascript文件<scriptsrc="/maps?file=api&hl=zh-CN&v=2&key=abcdefg"type="text/javascript"></script>URL（/maps?file=api&hl=zh-CN&v=2&key=abcdefg）解析：：也可以用，假如你需要在地图上显示大陆以外的具体地图，就用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元素，是个Divopts 可选Options 构造函数选项GMap2包含的方法：1.设置状态的方法：enableDragging()：设置地图可以被拖动。

disableDragging()：禁止地图被拖动。

draggingEnabled()：返回地图是否能够被拖动的布尔值。

假如能够拖动，返回"真"；否则返回"假"。

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) 在地图上删除指定的标注.假如该标注确实在地图上.clearOverlays()删除所有地图上的标注.5.有关信息浮窗的方法：openInfoWindow(point, node, opts?)在指定的地理点打开一个简单的信息浮窗.滑动地图以保证打开的信息浮窗可见.信息浮窗的内容以DOM节点的形式给定.openInfoWindowHtml(point, html, opts?)在指定的地理点打开一个简单的信息浮窗.滑动地图以保证打开的信息浮窗可见.信息浮窗的内容以HTML文本的形式给定.openInfoWindowTabs(point, tabs, opts?)在指定的地理点打开一个分标签的信息浮窗.滑动地图以保证打开的信息浮窗可见.信息浮窗的内容以DOM节点的形式给定.openInfoWindowTabsHtml(point, tabs, opts?)在指定的地理点打开一个分标签的信息浮窗.滑动地图以保证打开的信息浮窗可见.信息浮窗的内容以HTML文本的形式给定.showMapBlowup(point, opts?)在指定的地理点打开一个显示指定点更近的视图的信息浮窗.closeInfoWindow()关闭当前打开的信息浮窗.getInfoWindow() 返回类型GInfoWindow 返回地图的信息浮窗对象.假如当前并不存在信息浮窗,则创建一个信息浮窗而不显示它.这个操作并不被enableInfoWindow()影响.6.控件的方法：addControl(GControl)添加一个google地图的控件RemoveControl(GControl)删除一个google地图的控件7. 示例：var map = new Map2(document.getElementByIdx_x_x("map"),{size:GSi ze(200,200), backgroundColor:"#FF0000"});map.addControl(new GSmallMapControl());//添加一个地图左侧的缩放按钮控件map.addControl(new GMapTypeControl());//添加地图类型控件包括普通地图、卫星地图、混合地图map.setCenter(new GLatLng(37.4419, -122.1419), 13); //实例化一个维度为37.4419、经度为-122.1419的经纬度实例，然后设置地图的中心。

地图缩放值为13// Add 10 markers in random locations on the mapvar bounds = map.getBounds();//得到地图四面的边界值var southWest = bounds.getSouthWest();//西南的经纬度var northEast = bounds.getNorthEast();//东北的经纬度var lngSpan = northEast.lng() - southWest.lng();//经度差var latSpan = t() - t();//维度差//实例化一个在本张地图中的一个经纬度var point = new GLatLng(t() + latSpan * Math.random(),southWest.lng() + lngSpan * Math.random());var marker = new GMarker(point);//实例化一个标点//给标点加click事件，当点击标点时弹出一个信息窗GEvent.addListener(marker, "click", function() {marker.openInfoWindowHtml("<b>hello</b>");});map.addOverlay(marker);//把标点添加到地图覆盖物2.GMapOptions类:这个类型包含以下4个属性1.size默认情况下，你创建的地图大小就是你给定的地图容器的大小，所以，通常情况下，你需要显式的声明你的地图容器的width和height属性，否则，地图是不能正常显示的，但是，有了size这个可选属性后，你就多了一个选择了。