谷歌地图类参考.doc

谷歌地图类参考地图对象GMapGMap代表页面上的一个地图对象。浏览更多信息构造函数构造函数 说明 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 map infoWindowEnabled() 如果信息浮窗启用，则返回trueControls addControl(control) 将给定控件添加到地图removeControl(control) 从地图上移除相应控件State 方法 说明 Google EarthtCenterLatLng() 返回地图中心点经/纬坐标Google EarthtBoundsLatLng() 返回地图视口边界 bounds(经/纬坐标)Google EarthtSpanLatLng() 返回地图视口宽度和高度(用精度和纬度作坐标)Google EarthtZoomLevel() 返回地图的缩放级别centerAtLatLng(latLng) 将地图中心定位到指定GPoint recenterOrPanToLatLng(latLng) 将地图中心定位到指定GPoint，如果指定点在视口之中，则执行平滑过渡动作zoomTo(zoomLevel) 缩放到指定的等级，如果指定的等级超出范围，则请求会被忽略.centerAndZoom(latLng, zoomLevel) 自动定位和缩放地图Google EarthtMapTypes() 返回所有支持的地图类型的数组(例如G_MAP_TYPE和G_SATELLITE_TYPE) Google EarthtCurrentMapType() 返回当前使用的地图类型(例如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 Event Arguments 说明 click overlay, point 当用户点击一个地图或标注的时候被触发，如果在标注上点击，该标注会作为参数传递到事件处理器，否则会将地图上被点击点的地理坐标作为参数.move none 在地图移动时触发，在地图被拖拽的时候会持续触发.movestart none 在地图开始连续的移动时触发，假如地图的移动不是连续的，则不会被触发.moveend none 在连续或不连续的移动完成时被触发，在连续的移动时，也只是在最后被触发一次.zoom oldZoomLevel, newZoomLevel 在地图缩放级别改变时被触发maptypechanGoogle Earthd none infowindowopen none 在信息浮窗显示后被触发infowindowclose none 在信息浮窗关闭后被触发addoverlay overlay 在一个标注被添加到地图后被触发removeoverlay overlay 在一个标注从地图上移除时触发，注意：如果调用clearOverlays，则不会被触发， 参看下面的clearoverlays事件clearoverlays none 在所有的标记都从地图上移除时触发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 Event Arguments 说明 click none 在用户点击标记时被触发infowindowopen none 标记上的信息浮窗打开后触发infowindowclose none 标记上的信息浮窗关闭后触发GPolyline GPolyline代表地图上的折线图，如果可能，折线用浏览器支持的矢量绘图工具绘制，否则调用Google服务器上面的图片来显示折线.构造函数构造函数 说明 GPolyline(points, color?, weight?, opacity?) 利用给定的地理坐标点数组创建一个GPolyline. color应该是一个16进制的颜色代码(例如#0000ff), weight是一个代表线宽像素值得整数,opacity是一个0-1之间的小数.GIcon 一个图标指定用来显示在地图上的图片，因为浏览器兼容性的原因，指定一个图标是比较复杂的 点这儿浏览更多信息至少你应该为图标指定imaGoogle Earth, shadowImaGoogle Earth, iconSize, shadowSize, 和iconAnchor属性，才能显示在地图上，如果你要使用信息浮窗，你必须同时指定infoWindowAnchor属性.构造函数构造函数 说明 GIcon(copy?) 创建一个图标，复制给定图标的属性属性属性 说明 imaGoogle Earth 前景图片地址shadow 阴影图片地址iconSize 前景图片大小像素值shadowSize 阴影图片大小像素值iconAnchor 图标在地图上的对应点相对于图片左上角的像素坐标值.infoWindowAnchor 信息浮窗在图片上的对应点相对于图片左上角的像素坐标值.printImaGoogle Earth 用来打印的前景图片文件URL地址，应该和imaGoogle Earth大小相同mozPrintImaGoogle Earth 用来在Firefox/Mozilla浏览器中打印的前景图片文件URL地址，应该和imaGoogle Earth大小相同.printShadow 用来打印的阴影图片文件URL地址，因为大部分浏览器不支持打印PNG图片，所以应该使用GIF图片.transparent 图标前景图片的透明版本用来捕获IE的点击事件，这个图片应该是一个24-bit的PNG版本图片，使用1%的不透明度，形状和大小都和图标文件相同.imaGoogle EarthMap 在非IE的浏览器中用来描述图标文件的可点击区域的一组x/y坐标数组.Google Earthvent 所有的事件注册和触发都由Google Earthvent类来处理，Google Earthvent类的方法都是静态方法， 例如，你应该使用Google Earthvent.bind(.)，而不是(new Event().bind(.).静态方法方法 说明 addListener(source, eventName, listenerFn) 当指定的事件触发时，调用指定的listenerFn函数， addListener返回一个变量，这个变量可以作为removeListener的参数.removeListener(listener) 移除事件监视器，参数应该是addListener的一个返回值.clearListeners(source, eventName) 为给定的事件移除所有的事件监视器trigGoogle Earthr(source, eventName, args.) 在指定的源上利用指定参数触发事件bind(source, eventName, object, method) 将给定的对象的给定方法绑定到给定的事件，当给定的时间被触发时，指定的方法就会被调用 例如Google Earthvent.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代表纬度.构造函数构造函