google map api

fly.net.cn

浏览: 187358 次
性别:
来自: 北京

最近访客更多访客>>

cues

chasewinds

ceoajun

gephen

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

google api

Google 浏览器 JavaScript XML IE

`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

EventArguments说明

`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

EventArguments说明

`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)`	返回一个节点的文本内容，用来解析文本节点.