Google Map Api 谷歌地图接口整理一:基本知识: 1. 使用谷歌地图 API 的第一步就是要注册一个 API 密钥,需要注重一下两点: 1.假如使用 API 的页面还没有发布,只是在本地调试,可以不用密钥,随便用个字符串代替就可以了 2.API 密钥只对网站目录或者域有效对不同域的网页,需要用这些域分别注册不同的密钥2.页面引用javascript文件 URL( :也可以用,假如你需要在地图上显示大陆以外的具体地图,就用 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():返回地图是否可以连续平滑地缩放的布尔值假如能够连续平滑地缩放,返回"真";否则返回"假" 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:GSize(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 。