Google Maps常用方法参考.docx

GMap GMap代表页面上的一个地图对象.构造函数构造函数说明GMap(container, mapTypes?, width?, height?)在当前的HTML容器内创建一个新的地图，如果没有指定，则使用默认的地图类型(G_MAP_TYPE, G_SATELLITE_TYPE) creates a new map inside 同样的，如果没有严格指定大小，则会使用HTML容器的大小.方法Configuration 方法说明enableDragging()启用动态托拽 (默认已经启用)disableDragging()禁止动态托拽draggingEnabled()如果动态托拽启用，则返回trueenableInfoWindow()启用信息浮窗 (默认已经启用)disableInfoWindow()禁止信息浮窗 windows on this mapinfoWindowEnabled()如果信息浮窗启用，则返回trueControls addControl(control)将给定控件添加到地图removeControl(control)从地图上移除相应控件State 方法说明getCenterLatLng()返回地图中心点经/纬坐标getBoundsLatLng()返回地图视口边界 bounds(经/纬坐标)getSpanLatLng()返回地图视口宽度和高度(用精度和纬度作坐标)getZoomLevel()返回地图的缩放级别centerAtLatLng(latLng)将地图中心定位到指定GPointrecenterOrPanToLatLng(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)Overlays 方法说明addOverlay(overlay)将指定的标注 (例如GMarker或GPolyline) 添加到地图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显示一个放大，如果zoomLevel和mapType参数没有被设置，默认使用第1缩放等级和当前正使用的地图类型.closeInfoWindow()关闭信息浮窗Events EventArguments说明clickoverlay, point当用户点击一个地图或标注的时候被触发，如果在标注上点击，该标注会作为参数传递到事件处理器，否则会将地图上被点击点的地理坐标作为参数.movenone在地图移动时触发，在地图被拖拽的时候会持续触发.movestartnone在地图开始连续的移动时触发，假如地图的移动不是连续的，则不会被触发.moveendnone在连续或不连续的移动完成时被触发，在连续的移动时，也只是在最后被触发一次.zoomoldZoomLevel, newZoomLevel在地图缩放级别改变时被触发maptypechangednone?infowindowopennone在信息浮窗显示后被触发infowindowclosenone在信息浮窗关闭后被触发addoverlayoverlay在一个标注被添加到地图后被触发removeoverlayoverlay在一个标注从地图上移除时触发，注意：如果调用clearOverlays，则不会被触发， 参看下面的clearoverlays事件clearoverlaysnone在所有的标记都从地图上移除时触发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显示一个放大，如果zoomLevel和mapType参数没有被设置，默认使用第1缩放等级和当前正使用的地图类型.Events EventArguments说明clicknone在用户点击标记时被触发infowindowopennone标记上的信息浮窗打开后触发infowindowclosenone标记上的信息浮窗关闭后触发GPolyline GPolyline代表地图上的折线图，如果可能，折线用浏览器支持的矢量绘图工具绘制，否则调用Google服务器上面的图片来显示折线.构造函数构造函数说明GPolyline(points, color?, weight?, opacity?)利用给定的地理坐标点数组创建一个GPolyline. color应该是一个16进制的颜色代码(例如#0000ff), weight是一个代表线宽像素值得整数,opacity是一个0-1之间的小数.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容器内.GPoint GPoint代表一个二维平面点，如果GPoint代表一个地理位置，则x是经度, y是纬度，用十进制.构造函数构造函数说明GPoint(x, y)利用给定的坐标值创建新GPoint属性属性说明x点的X(水平方向)坐标y点的Y(竖直方向)坐标GSize GSize代表一个二维的范围大小值， 如果GSize是地理的范围，那么width代表经度，而y代表纬度.构造函数构造函数说明