该手册共有四篇文章,分别是:、、、 ,当前:类参考
GMap代表页面上的一个地图对象. 浏览更多信息
| 构造函数 |
说明 |
GMap(container, mapTypes?, width?, height?) |
在当前的HTML容器内创建一个新的地图,如果没有指定,则使用默认的地图类型([G_MAP_TYPE, G_SATELLITE_TYPE]) Creates a new map inside 同样的,如果没有严格指定大小,则会使用HTML容器的大小. |
| 方法 |
说明 |
enableDragging() |
启用动态托拽 (默认已经启用) |
disableDragging() |
禁止动态托拽 |
draggingEnabled() |
如果动态托拽启用,则返回true |
enableInfoWindow() |
启用信息浮窗 (默认已经启用) |
disableInfoWindow() |
禁止信息浮窗 windows on this map |
infoWindowEnabled() |
如果信息浮窗启用,则返回true |
addControl(control) |
将给定控件添加到地图 |
removeControl(control) |
从地图上移除相应控件 |
| 方法 |
说明 |
getCenterLatLng() |
返回地图中心点经/纬坐标 |
getBoundsLatLng() |
返回地图视口边界 bounds(经/纬坐标) |
getSpanLatLng() |
返回地图视口宽度和高度(用精度和纬度作坐标) |
getZoomLevel() |
返回地图的缩放级别 |
centerAtLatLng(latLng) |
将地图中心定位到指定GPoint |
recenterOrPanToLatLng(latLng) |
将地图中心定位到指定GPoint,如果指定点在视口之中,则执行平滑过渡动作 |
zoomTo(zoomLevel) |
缩放到指定的等级,如果指定的等级超出范围,则请求会被忽略. |
centerAndZoom(latLng, zoomLevel) |
自动定位和缩放地图 |
getMapTypes() |
返回所有支持的地图类型的数组(例如G_MAP_TYPE和G_SATELLITE_TYPE) |
getCurrentMapType() |
返回当前使用的地图类型(例如G_MAP_TYPE或G_SATELLITE_TYPE) |
setMapType(mapType) |
切换到指定的地图类型(例如G_MAP_TYPE或G_SATELLITE_TYPE) |
| 方法 |
说明 |
addOverlay(overlay) |
将指定的标注 (例如GMarker或GPolyline) 添加到地图 |
removeOverlay(overlay) |
从地图上移除指定的标注 |
clearOverlays() |
删除所有地图上的标注 |
| 方法 |
说明 |
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显示一个放大,如果zoomLevel和mapType参数没有被设置,默认使用第1缩放等级和当前正使用的地图类型. |
closeInfoWindow() |
关闭信息浮窗 |
| Event |
Arguments |
说明 |
click |
overlay, point |
当用户点击一个地图或标注的时候被触发,如果在标注上点击,该标注会作为参数传递到事件处理器,否则会将地图上被点击点的地理坐标作为参数. |
move |
none |
在地图移动时触发,在地图被拖拽的时候会持续触发. |
movestart |
none |
在地图开始连续的移动时触发,假如地图的移动不是连续的,则不会被触发. |
moveend |
none |
在连续或不连续的移动完成时被触发,在连续的移动时,也只是在最后被触发一次. |
zoom |
oldZoomLevel, newZoomLevel |
在地图缩放级别改变时被触发 |
maptypechanged |
none |
< FONT> |
infowindowopen |
none |
在信息浮窗显示后被触发 |
infowindowclose |
none |
在信息浮窗关闭后被触发 |
addoverlay |
overlay |
在一个标注被添加到地图后被触发 |
removeoverlay |
overlay |
在一个标注从地图上移除时触发,注意:如果调用clearOverlays,则不会被触发, 参看下面的clearoverlays事件 |
clearoverlays |
none |
在所有的标记都从地图上移除时触发 |
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显示一个放大,如果zoomLevel和mapType参数没有被设置,默认使用第1缩放等级和当前正使用的地图类型. |
| Event |
Arguments |
说明 |
click |
none |
在用户点击标记时被触发 |
infowindowopen |
none |
标记上的信息浮窗打开后触发 |
infowindowclose |
none |
标记上的信息浮窗关闭后触发 |
GPolyline代表地图上的折线图,如果可能,折线用浏览器支持的矢量绘图工具绘制,否则调用Google服务器上面的图片来显示折线.
| 构造函数 |
说明 |
GPolyline(points, color?, weight?, opacity?) |
利用给定的地理坐标点数组创建一个GPolyline. color应该是一个16进制的颜色代码(例如"#0000ff"), weight是一个代表线宽像素值得整数,opacity是一个0-1之间的小数. |
一个图标指定用来显示在地图上的图片,因为浏览器兼容性的原因,指定一个图标是比较复杂的,至少你应该为图标指定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.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) |
The GXmlHttp提供一个方法用来创建跨浏览器的XmlHttpRequest实例.
| 方法 |
说明 |
create() |
构造一个新的XmlHttpRequest实例 |
The GXml类提供一个以XML格式来解析字符串的静态方法,这个解析器可以在任何浏览器上执行,假如浏览器上没有集成XML解析器,则会自动的使用一个基于Javascript的XML解析器,而这个Javascript的执行过程可能会比较慢.
| 方法 |
说明 |
parse(xmlStr) |
以XML来解析指定的字符串,并返回一个XML DOM. |
value(xmlNode) |
返回一个节点的文本内容,用来解析文本节点. |
The GXslt类提供XML的XSLT转化方法.本类可以在任何浏览器上运行,假如浏览器上没有集成XSLT处理器,则会自动的使用一个基于Javascript的XSLT处理器. 而这个Javascript的执行过程可能会比较慢.
| 方法 |
说明 |
create(xsltXmlDoc) |
利用给定的XML DOM对象,返回一个GXslt实例,该XML DOM对象必须是一个XSLT文件. |
| 方法 |
说明 |
transformToHtml(xmlDoc, htmlContainer) |
转换给定的XML文档,并将HTML结果存入指定的HTML容器内. |
GPoint代表一个二维平面点,如果GPoint代表一个地理位置,则x是经度, y是纬度,用十进制.
| 构造函数 |
说明 |
GPoint(x, y) |
利用给定的坐标值创建新GPoint |
| 属性 |
说明 |
x |
点的X(水平方向)坐标 |
y |
点的Y(竖直方向)坐标 |
GSize代表一个二维的范围大小值, 如果GSize是地理的范围,那么width代表经度,而y代表纬度.
| 构造函数 |
说明 |
GSize(width, height) |
利用给定的宽度和高度值创建新的GSize |
GBounds表示一个矩形范围. 如果GBounds是地理坐标的,则X坐标代表经度,Y坐标代表纬度. 如果矩形范围跨越国际时间线,那"最小坐标"代表矩形范围左上角坐标,而不是两个坐标的数学最小值.
| 构造函数 |
说明 |
GBounds(minX, minY, maxX, maxY) |
利用给定坐标创建新GBounds |
| 属性 |
说明 |
minX |
左上角X坐标 |
minY |
左上角Y坐标 |
maxX |
右下角X坐标 |
maxY |
右下角Y坐标 |
本文来源于Google由Step1.cn翻译并整理