Google Maps API第2版(Google地图接口)

Google Maps API第2版类参考

1.GMap

GMap代表页面上的一个地图对象.

构造函数

构造函数 说明
GMap(container, mapTypes?, width?, height?) 在当前的HTML容器内创建一个新的地图,如果没有指定,则使用默认的地图类型([G_MAP_TYPE, G_SATELLITE_TYPE]) Creates a new map inside 同样的,如果没有严格指定大小,则会使用HTML容器的大小.

方法

Configuration

方法 说明
enableDragging() 启用动态托拽(默认已经启用)
disableDragging() 禁止动态托拽
draggingEnabled() 如果动态托拽启用,则返回true
enableInfoWindow() 启用信息浮窗(默认已经启用)
disableInfoWindow() 禁止信息浮窗 windows on this map
infoWindowEnabled() 如果信息浮窗启用,则返回true

Controls

addControl(control) 将给定控件添加到地图
removeControl(control) 从地图上移除相应控件

State

方法 说明
getCenterLatLng() 返回地图中心点经/纬坐标
getBoundsLatLng() 返回地图视口边界 bounds(经/纬坐标)
getSpanLatLng() 返回地图视口宽度和高度(用精度和纬度作坐标)
getZoomLevel() 返回地图的缩放级别
centerAtLatLng(latLng) 将地图中心定位到指定GPoint
recenterOrPanToLatLng(latLng) 将地图中心定位到指定GPoint,如果指定点在视口之中,则执行平滑过渡动作
zoomTo(zoomLevel) 缩放到指定的等级,如果指定的等级超出范围,则请求会被忽略.
centerAndZoom(latLng, zoomLevel) 自动定位和缩放地图
getMapTypes() 返回所有支持的地图类型的数组(例如G_MAP_TYPEG_SATELLITE_TYPE)
getCurrentMapType() 返回当前使用的地图类型(例如G_MAP_TYPEG_SATELLITE_TYPE)
setMapType(mapType) 切换到指定的地图类型(例如G_MAP_TYPEG_SATELLITE_TYPE)

Overlays

方法 说明
addOverlay(overlay) 将指定的标注 (例如GMarkerGPolyline) 添加到地图
removeOverlay(overlay) 从地图上移除指定的标注
clearOverlays() 删除所有地图上的标注

Info Window

方法 说明
openInfoWindow(latLng, htmlElem, pixelOffset?, onOpenFn?, onCloseFn?) 在指定的地理坐标点显示一个包含指定HTML内容的信息浮窗.htmlElem应该是一个HTML DOM对象.如果指定了pixelOffset (GSize)则使用给定的像素值调整窗口位置,这样就可以实现在标记上显示信息浮窗,如果指定了onOpenFn 则在窗口显示后调用相应的函数,在窗口关闭时会调用onCloseFn函数.
openInfoWindowHtml(marker, htmlStr, pixelOffset?, onOpenFn?, onCloseFn?) 同于openInfoWindow,不过是用HTML字符串做参数,而不是HTML DOM对象.
openInfoWindowXslt(marker, xmlElem, xsltUri, pixelOffset?, onOpenFn?, onCloseFn?) 同于openInfoWindow,不过使用XML元素和XSLT文档的URI地址来生成信息浮窗内容,当一个URI地址第一次使用时,该文档会被GXmlHttp下载并被缓存.
showMapBlowup(point, zoomLevel?, mapType?, pixelOffset?, onOpenFn?, onCloseFn?)) 在当前地理位置点GPoint显示一个放大,如果zoomLevelmapType参数没有被设置,默认使用第1缩放等级和当前正使用的地图类型.
closeInfoWindow() 关闭信息浮窗

Events

Event Arguments 说明
click overlay, point 当用户点击一个地图或标注的时候被触发,如果在标注上点击,该标注会作为参数传递到事件处理器,否则会将地图上被点击点的地理坐标作为参数.
move none 在地图移动时触发,在地图被拖拽的时候会持续触发.
movestart none 在地图开始连续的移动时触发,假如地图的移动不是连续的,则不会被触发.
moveend none 在连续或不连续的移动完成时被触发,在连续的移动时,也只是在最后被触发一次.
zoom oldZoomLevel, newZoomLevel 在地图缩放级别改变时被触发
maptypechanged none
infowindowopen none 在信息浮窗显示后被触发
infowindowclose none 在信息浮窗关闭后被触发
addoverlay overlay 在一个标注被添加到地图后被触发
removeoverlay overlay 在一个标注从地图上移除时触发,注意:如果调用clearOverlays,则不会被触发,参看下面的clearoverlays事件
clearoverlays none 在所有的标记都从地图上移除时触发

2.GMarker

GMarker是一种地图标注,在地图上显示一个图标,类构造函数使用GIcon的一个实例和一个点作为参数,GMarker也包含一些比较方便的方法来在标注上显示一个信息浮窗.

构造函数

构造函数 说明
GMarker(point, icon?) 在指定的点,用指定的图标显示一个标记,如果没有指定图标,则使用默认的Google Map图标.

方法

方法 说明
openInfoWindow(htmlElem) 利用给定的HTML内容在标注上显示一个信息浮窗,htmlElem应该是一个HTML DOM实例.
openInfoWindowHtml(htmlStr) 同于openInfoWindow,但是使用HTML字符串作参数,而不是HTML DOM实例.
openInfoWindowXslt(xmlElem, xsltUri) 同于openInfoWindow,不过使用XML元素和XSLT文档的URI地址来生成信息浮窗内容,当一个URI地址第一次使用时,该文档会被GXmlHttp下载并被缓存.
showMapBlowup(zoomLevel?, mapType?) 在标注上GPoint显示一个放大,如果zoomLevelmapType参数没有被设置,默认使用第1缩放等级和当前正使用的地图类型.

Events

Event Arguments 说明
click none 在用户点击标记时被触发
infowindowopen none 标记上的信息浮窗打开后触发
infowindowclose none 标记上的信息浮窗关闭后触发

3.GPolyline

GPolyline代表地图上的折线图,如果可能,折线用浏览器支持的矢量绘图工具绘制,否则调用Google服务器上面的图片来显示折线.

构造函数

构造函数 说明
GPolyline(points, color?, weight?, opacity?) 利用给定的地理坐标点数组创建一个GPolyline.color应该是一个16进制的颜色代码(例如"#0000ff"), weight是一个代表线宽像素值得整数,opacity是一个0-1之间的小数.

4.GIcon

一个图标指定用来显示在地图上的图片,因为浏览器兼容性的原因,指定一个图标是比较复杂的点这儿浏览更多信息

至少你应该为图标指定image, shadowImage, iconSize, shadowSize,和iconAnchor属性,才能显示在地图上,如果你要使用信息浮窗,你必须同时指定infoWindowAnchor属性.

构造函数

构造函数 说明
GIcon(copy?) 创建一个图标,复制给定图标的属性

属性

属性 说明
image 前景图片地址
shadow 阴影图片地址
iconSize 前景图片大小像素值
shadowSize 阴影图片大小像素值
iconAnchor 图标在地图上的对应点相对于图片左上角的像素坐标值.
infoWindowAnchor 信息浮窗在图片上的对应点相对于图片左上角的像素坐标值.
printImage 用来打印的前景图片文件URL地址,应该和image大小相同
mozPrintImage 用来在Firefox/Mozilla浏览器中打印的前景图片文件URL地址,应该和image大小相同.
printShadow 用来打印的阴影图片文件URL地址,因为大部分浏览器不支持打印PNG图片,所以应该使用GIF图片.
transparent 图标前景图片的透明版本用来捕获IE的点击事件,这个图片应该是一个24-bit的PNG版本图片,使用1%的不透明度,形状和大小都和图标文件相同.
imageMap 在非IE的浏览器中用来描述图标文件的可点击区域的一组x/y坐标数组.

GEvent

所有的事件注册和触发都由GEvent类来处理,GEvent类的方法都是静态方法,例如,你应该使用GEvent.bind(...),而不是(new Event()).bind(...).

静态方法

方法 说明
addListener(source, eventName, listenerFn) 当指定的事件触发时,调用指定的listenerFn函数,addListener返回一个变量,这个变量可以作为removeListener的参数.
removeListener(listener) 移除事件监视器,参数应该是addListener的一个返回值.
clearListeners(source, eventName) 为给定的事件移除所有的事件监视器
trigger(source, eventName, args...) 在指定的源上利用指定参数触发事件
bind(source, eventName, object, method) 将给定的对象的给定方法绑定到给定的事件,当给定的时间被触发时,指定的方法就会被调用例如GEvent.bind(map, "move",this, this.onMapMove)

GXmlHttp

The GXmlHttp提供一个方法用来创建跨浏览器的XmlHttpRequest实例.

静态方法

方法 说明
create() 构造一个新的XmlHttpRequest实例

GXml

The GXml类提供一个以XML格式来解析字符串的静态方法,这个解析器可以在任何浏览器上执行,假如浏览器上没有集成XML解析器,则会自动的使用一个基于Javascript的XML解析器,而这个Javascript的执行过程可能会比较慢.

静态方法

方法 说明
parse(xmlStr) 以XML来解析指定的字符串,并返回一个XML DOM.
value(xmlNode) 返回一个节点的文本内容,用来解析文本节点.

GXslt

The GXslt类提供XML的XSLT转化方法.本类可以在任何浏览器上运行,假如浏览器上没有集成XSLT处理器,则会自动的使用一个基于Javascript的XSLT处理器.而这个Javascript的执行过程可能会比较慢.

静态方法

方法 说明
create(xsltXmlDoc) 利用给定的XML DOM对象,返回一个GXslt实例,该XML DOM对象必须是一个XSLT文件.

方法

方法 说明
transformToHtml(xmlDoc, htmlContainer) 转换给定的XML文档,并将HTML结果存入指定的HTML容器内.

5.GPoint

GPoint代表一个二维平面点,如果GPoint代表一个地理位置,则x经度,y纬度,用十进制.

构造函数

构造函数 说明
GPoint(x, y) 利用给定的坐标值创建新GPoint

属性

属性 说明
x 点的X(水平方向)坐标
y 点的Y(竖直方向)坐标

6.GSize

GSize代表一个二维的范围大小值, 如果GSize是地理的范围,那么width代表经度,而y代表纬度.

构造函数

构造函数 说明
GSize(width, height) 利用给定的宽度和高度值创建新的GSize

属性

属性 说明
width 宽度
height 高度

7.GBounds

GBounds表示一个矩形范围. 如果GBounds是地理坐标的,则X坐标代表经度,Y坐标代表纬度.如果矩形范围跨越国际时间线,那"最小坐标"代表矩形范围左上角坐标,而不是两个坐标的数学最小值.

构造函数

构造函数 说明
GBounds(minX, minY, maxX, maxY) 利用给定坐标创建新GBounds

属性

属性 说明
minX 左上角X坐标
minY 左上角Y坐标
maxX 右下角X坐标
maxY 右下角Y坐标