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_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
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 | 在所有的标记都从地图上移除时触发 |
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
一个图标指定用来显示在地图上的图片,因为浏览器兼容性的原因,指定一个图标是比较复杂的 点这儿浏览更多信息
至少你应该为图标指定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
代表纬度.
构造函数
构造函数 | 说明 |
---|---|
GSize(width, height) | 利用给定的宽度和高度值创建新的GSize |
属性
属性 | 说明 |
---|---|
width | 宽度 |
height | 高度 |
GBounds
GBounds
表示一个矩形范围. 如果GBounds
是地理坐标的,则X坐标代表经度,Y坐标代表纬度. 如果矩形范围跨越国际时间线,那"最小坐标"代表矩形范围左上角坐标,而不是两个坐标的数学最小值.
构造函数
构造函数 | 说明 |
---|---|
GBounds(minX, minY, maxX, maxY) | 利用给定坐标创建新GBounds |
属性
属性 | 说明 |
---|---|
minX | 左上角X坐标 |
minY | 左上角Y坐标 |
maxX | 右下角X坐标 |
maxY | 右下角Y坐标 |