当前位置： >>
Google地图中文API
Google 地图 API 参考Google 地图 API 现在与 Google AJAX API 载入器集成,后者创建了一个公共命名空间,以便载入和使用多个 Google AJAX API.该 框架可让您将可选 google.maps.* 命名空间用于当前在 Google 地图 API 中使用的所有类, 方法和属性, 使用此命名空间替换常规 G 前缀.不要担心,现有
G 命名空间仍能得到支持.例如,Google 地图 API 中的 GMap2 对象还可以定义为 google.maps.Map2.请注意,此参考文档仅指现有 G 命名空间. 如果只是要使用地图显示内容,则需要了解以下类,类型和函数:
GMap2 GMapOptions GGoogleBarOptions GInfoWindow GInfoWindowTab GInfoWindowOptions GMarker GMarkerOptions GPolyline GPolylineOptions
GLatLng GLatLngBounds GControl GTileLayerOptions GTileLayerOverlayOptions GEvent GEventListener GXmlHttp GXml GXslt
GBrowserIsCompatible GDirections GDirectionsOptions GTravelModes GRoute GStep GTrafficOverlay GTrafficOverlayOptions GAdsManager GAdsManagerOptions
GPolyEditingOptions GPolyStyleOptions GPolygon GPolygonOptions GScreenOverlay GScreenPoint GScreenSize GGroundOverlay GIcon GPoint GSize GBounds
GLog GDraggableObject GDraggableObjectOptions GGeoStatusCode GGeoAddressAccuracy GClientGeocoder GGeocodeCache GFactualGeocodeCache GMarkerManager GMarkerManagerOptions GGeoXml GDownloadUrl
GStreetviewPanorama GStreetviewPanoramaOptions GStreetviewOverlay GStreetviewClient GStreetviewClient.ReturnValues GStreetviewData GStreetviewLocation GStreetviewLink GPov GStreetviewPanorama.ErrorValues如果您要通过实现自己的控件,叠加层或地图类型来扩展地图 API 的功能,则还需要了解以下类和类型:
GGoogleBarListingTypes GGoogleBarLinkTarget GGoogleBarResultList GMapPane GOverlay GControl GControlPosition
GControlAnchor GMapTypeControl GMenuMapTypeControl GHierarchicalMapTypeControl GMapType GMapTypeOptions GLayer
GTileLayer GTileLayerOverlay GCopyrightCollection GCopyright GProjection GMercatorProjectionGMap2 类对 GMap2 类进行实例化以创建地图.这是 API 中的中心类.其他都是辅助类.构造函数构造函数 GMap2(container:Node, opts?:GMapOptions) 说明 在指定的 HTML 容器中创建新的地图,该容器通常是一个 DIV 元素.如果可选参数 opts.mapTypes 中 没有给出地图类型集合,则使用默认的集合 G_DEFAULT_MAP_TYPES.如果可选参数 opts.size 中没有 给出大小,则使用 container 的大小.如果给出了 opts.size,则相应地调整地图容器元素的大小. 请参见 class GMapOptions.注意:需要先将地图居中,才能使用该地图.您应该立即调用 GMap2.setCenter() 来初始化使用该构造函数创建的地图.方法配置方法 enableDragging() disableDragging() draggingEnabled() enableInfoWindow() disableInfoWindow() 返回值 None None None None 启用地图拖动(默认情况下启用). 禁用地图拖动. 启用地图上的信息窗口操作(默认情况下启用). 如果信息窗口处于打开状态,请关闭它并禁用打开新信息窗口. 说明Boolean 当且仅当启用了地图拖动时,返回 true.infoWindowEnabled()Boolean 当且仅当启用了信息窗口时,返回 true. 启用双击缩放地图(默认情况下启用).enableDoubleClickZoom() None (自 2.58 开始) 禁用双击缩放地图. disableDoubleClickZoom() None (自 2.58 开始) 当且仅当启用了双击缩放地图时,返回 true. doubleClickZoomEnabled() Boolean (自 2.58 开始) 启用选择浏览器的连续平滑缩放(默认情况下禁用). enableContinuousZoom() None (自 2.58 开始) 禁用连续平滑缩放. disableContinuousZoom() None (自 2.58 开始) 如果启用了连续平滑缩放,则返回 true. continuousZoomEnabled() Boolean (自 2.58 开始) enableGoogleBar() None 为地图启用集成搜索控件 GoogleBar GoogleBar.如果启用,该控件会取代默认的&由 Google 强力驱动& 徽标.请注意,该控件默认情况下未启用. (自 2.92 开始) disableGoogleBar() None 禁用 GoogleBar 集成搜索控件.如果禁用,默认的&由 Google 强力驱动&徽标会占据以前放置 此控件的位置.请注意,该控件已经默认禁用.(自 2.92 开始) 启用使用鼠标滚轮缩放.注意:默认情况下禁用滚轮缩放. enableScrollWheelZoom() None (自 2.78 开始) 禁用使用鼠标滚轮缩放.注意:默认情况下禁用滚轮缩放. disableScrollWheelZoom() None (自 2.78 开始) 返回一个表示是否启用滚轮缩放的布尔值. scrollWheelZoomEnabled() Boolean (自 2.78 开始)控件方法 addControl(control:GControl, position?:GControlPosition) removeControl(control:GControl) getContainer() 返回 值 说明将控件添加到地图.地图上的位置由可选的 position 参数确定.如果此参数不存 None 在, 一个控 则使用由 GControl.getDefaultPosition() 方法确定的控件默认位置. 件实例只能向地图中添加一次. None 从地图中删除控件.如果控件从未被添加到地图中,则该删除不起任何作用. Node 返回包含地图的 DOM 对象.由 GControl.initialize() 使用.地图类型方法 返回值 说明getMapTypes() getCurrentMapType() setMapType(type:GMapType) addMapType(type:GMapType)GMapType[] 返回在此地图中注册的地图类型数组. GMapType None None 返回当前选中的地图类型. 选择指定的新地图类型.类型必须是地图已知的类型.请参见构造函数和方法 addMapType(). 将新地图类型添加到地图中.有关怎样定义自定义地图类型的信息,请参见 GMapType 部 分. 从地图中删除地图类型.会更新由 GMapTypeControl 或 GHierarchicalMapTypeControl 显示的按钮集并触发 removemaptype 事件.removeMapType(type:GMapType) None地图状态方法 isLoaded() getCenter() getBounds() getBoundsZoomLevel(bounds:GLatLngBounds) getSize() getZoom() getDragObject() 返回值 Boolean GLatLng GLatLngBounds Number GSize Number GDraggableObject (自 2.93 开始) 说明 当且仅当地图在创建后使用 setCenter() 进行初始化时, 返回 true. 返回地图视图中心点的地理坐标. 返回地图视图的可视矩形区域(以地理坐标表示). 返回指定矩形区域在地图视图中的缩放级别.缩放级别要按当 前选中的地图类型计算.如果还未选择地图类型,将使用地图 类型列表中列出的第一个类型. 返回地图视图的大小(以像素表示). 返回当前的缩放级别. 返回此地图使用的可拖放对象.检索附加到此地图的 Google 地球浏览器插件的实例,并在该 实例准备好接收命令时调用传递的回调函数,从而将地球实例 (GEPlugin 对象)作为参数传递. 如果 Google 地球实例以前已通过设置 Google 地球地图类型 (通过 GMap2.setMapType(G_SATELLITE_3D_MAP)) 进行了实例 化,可能会立即触发该回调函数.如果实例尚未创建,调用 getEarthInstance 会初始化 Google 地球插件. (这种异步行 为就是该方法需要回调的原因.) getEarthInstance(callback:Function(instance: None GEPlugin)) 注意:如果初始化遇到错误,回调函数将传递 null 参数. 请注意,尽管该方法会创建 Google 地球实例,但不会 不会将 不会 Google 地球地图类型设置为当前视图.要执行此操作,请显式 或让用户通 地调用 GMap2.setMapType(G_SATELLITE_3D_MAP), 过 MapTypeControl 选择此地图类型.请参见 Google 地球 API 开发人员指南,以获取有关怎样使用 GEPlugin 对象的详 细信息. (自 2.113 开始)修改地图状态方法 setCenter(center:GLatLng, 返回 值 说明None 按指定的中心设置地图视图.也可以同时设置缩放级别和地图类型.地图类型必须是地图zoom?:Number, type?:GMapType)已知的类型.请参见构造函数和方法 addMapType().必须在构造后先调用此方法,才能设 置地图的初始状态.在调用此函数之前调用对新构造的 GMap2 对象执行的操作,这是错 对象执行的操作, 在调用此函数之前调用对新构造的 误的. 误的. None 将地图的中心点更改为指定的点.如果该点已经在当前的地图视图中可见,则会以平滑动 画的方式移动中心点.panTo(center:GLatLng) panBy(distance:GSize) panDirection(dx:one of -1 0 +1, dy:one of -1 0 +1) setZoom(level:Number) zoomIn() zoomOut() savePosition() returnToSavedPosition() checkResize()None 以动画方式平移指定的距离(以像素为单位). None 以动画方式向指示方向平移地图宽度的一半.+1 是向右向下,-1 是向左向上. None 将缩放级别设置为指定的新值. None 将缩放级别加 1. None 将缩放级别减 1. None 存储当前的地图位置和缩放级别,以便以后用 returnToSavedPosition() 重新调用. None 恢复用 savePosition() 保存的地图视图. None 通知地图其容器大小已更改. 在更改了容器 DOM 对象的大小后调用此方法, 以便地图能够 调整自己适合于新的大小.叠加层方法 addOverlay(overlay:GOverlay) 返回 值 说明None 将叠加层添加到地图中,并触发 addoverlay 事件. 从地图中删除叠加层.尝试删除不在地图上的叠加层是错误的.如果调用成功,会触发 removeoverlay 事件.removeOverlay(overlay:GOverlay) None clearOverlays()None 从地图中删除所有叠加层,并触发 clearoverlays 事件.getPane(pane:GMapPane)Node返回层中包含 pane 识别的对象的 DIV.由 GOverlay 实例用于方法 GOverlay.initialize() 的实例中,以在地图上绘制它们自身.信息窗口方法 openInfoWindow(latlng:GLatLng, node:Node, opts?:GInfoWindowOptions) openInfoWindowHtml(latlng:GLatLng, html:String, opts?:GInfoWindowOptions) 返回值 None None 说明 在指定点处打开一个简单的信息窗口. 平移地图, 使得打开的信 息窗口完全可见.信息窗口的内容为 DOM 节点. 在指定点处打开一个简单的信息窗口. 平移地图, 使得打开的信 息窗口完全可见.信息窗口的内容为 HTML 文本. 在指定点处打开一个带标签的信息窗口. 平移地图, 使得打开的 信息窗口完全可见.信息窗口的内容为 DOM 节点. 在指定点处打开一个带标签的信息窗口. 平移地图, 使得打开的 信息窗口完全可见.信息窗口的内容为 HTML 文本. 在指定的点打开信息窗口,它包含地图上该点附近的近景视图. 更新当前打开的 GInfoWindow 对象的内容,而不重新放置.信 息窗口的大小将被调整, 以便与新内容相符. 对信息窗口内容实 际进行更改后,将调用可选的 onupdate 回调函数. (自 2.85 开始) updateCurrentTab(modifier:Function, onupdate?:Function) None 会更新当前选中的标签,从而调整 GInfoWindow 对象的大小, 而不重新放置.modifier 函数用于修改当前选中的标签并将 GInfoWindowTab 作为参数传递.在信息窗口显示新内容后,调 用可选的 onupdate 回调函数.openInfoWindowTabs(latlng:GLatLng, None tabs:GInfoWindowTab[], opts?:GinfoWindowOptions) openInfoWindowTabsHtml(latlng:GLatLng, None tabs:GInfoWindowTab[], opts?:GInfoWindowOptions) showMapBlowup(latlng:GLatLng, opts?:GInfoWindowOptions) updateInfoWindow(tabs:GInfoWindowTab[], onupdate?:Function) NoneNone(自 2.85 开始) closeInfoWindow() getInfoWindow() None GInfoWindow 关闭当前打开的信息窗口. 返回此地图的信息窗口对象. 如果还没有信息窗口, 会创建一个, 但该窗口不显示.此操作不受 enableInfoWindow() 影响.坐标变换方法 fromContainerPixelToLatLng(pixel:GPoint) 返回值 GLatLng 说明 在含有页面地图的 DOM 元素中计算指定像素坐标点的地理坐标. 此方法有助 于实现自定义控件与地图的交互. 在包含该页面地图的 DOM 元素中计算指定的地理位置的像素坐标. fromLatLngToContainerPixel(latlng:GLatLng) GPoint (自 2.100 开始) fromLatLngToDivPixel(latlng:GLatLng) GPoint 计算指定地理位置在含有可拖动地图的 DOM 元素中的像素坐标. 为自定义叠 加层实现 GOverlay.redraw() 方法时,需要用此方法定位自定义叠加层.fromDivPixelToLatLng(pixel:GPoint)根据含有可拖动地图的 div 中的像素坐标计算地理坐标. 此方法可能有助于 GLatLng 实现与不扩展 GOverlay 接口的自定义叠加层的交互.如果此方法没有给出 预期输出,请尝试使用 fromContainerPixelToLatLng 方法.事件事件 addmaptype(type:GMapType) 向地图中添加地图类型时会触发此事件. 说明removemaptype(type:GMapType)从地图中删除地图类型时会触发此事件.用户用鼠标点击地图时会触发此事件.根据所点击的环境的不同以及是否点击了可点击的 叠加层,click 事件会传递不同的参数.如果点击的不是可点击叠加层,overlay 参数为 click(overlay:GOverlay, null 并且 latlng 参数包含点击点的地理坐标.如果点击的是 clickable 叠加层(如 latlng:GLatLng, overlaylatlng:GLatLng) GMarker,GPolygon,GPolyline 或 GInfoWindow),overlay 参数包含叠加层对象,而 overlaylatlng 参数会包含所点击叠加层的坐标.另外,还会在该叠加层自身上触发 click 事件. dblclick(overlay:GOverlay, latlng:GLatLng) 双击地图时会触发此事件.注意,双击标记或其他可点击叠加层时不触发此事件.被双击 的点的地理坐标将被传递到 latlng 参数中.overlay 参数始终设置为 null. (自 2.83 开始) 在地图容器中触发 DOM contextmenu 事件时会触发此事件.如果右键点击某个标记或其 他可点击叠加层,则该叠加层会传递到 overlay 参数的事件处理程序中.右键点击的这 一点的像素坐标(在包含地图的 DOM 元素中)和 DOM 事件的源元素会分别传递到 point 和 src 参数中.注意,如果在启用了双击缩放的情况下进行右键双击,那么,地图会缩 小,并且不触发 singlerightclick 事件.但是,如果禁用了双击缩放,会触发两个 singlerightclick 事件. (自 2.84 开始) movestart() move() moveend() zoomend(oldLevel:Number, newLevel:Number) 地图视图开始更改时会触发此事件.执行拖动操作时或调用更改地图视图的方法时也会触 发此事件,前者还同时触发 dragstart 事件. 更改地图视图时会触发此事件,并且可能是重复触发. 结束地图视图的更改时会触发此事件. 地图到达新的缩放级别时会触发此事件.事件处理程序接收先前的缩放级别和新缩放级别 作为参数.singlerightclick(point:GPoint, src:Element, overlay?:GOverlay)maptypechanged() infowindowopen() infowindowbeforeclose()选择另一地图类型时会触发此事件. 打开信息窗口时会触发此事件. 关闭信息窗口前会触发此事件. (自 2.83 开始)infowindowclose()关闭信息窗口时会触发此事件.此事件在触发前会触发 infowindowbeforeclose 事件. 如果通过再次调用 openInfoWindow*() 在其他点重新打开当前已打开的信息窗口,则会 先后触发 infowindowbeforeclose,infowindowclose 和 infowindowopen 事件. 当使用 addOverlay() 方法向地图中添加单个叠加层时会触发此事件.新的叠加层会作为 参数 overlay 传递到事件处理程序中. 当使用 removeOverlay() 方法删除单个叠加层时会触发此事件.删除的叠加层会作为参 数 overlay 传递到事件处理程序中. 当使用 clearOverlays() 方法一次性删除全部叠加层时会触发此事件. 当用户将鼠标从地图外移动到地图上时会触发此事件. 当用户将鼠标移离地图时会触发此事件. 当用户在地图中移动鼠标时会触发此事件. 当用户开始拖动地图时会触发此事件. 当用户拖动地图时会重复触发此事件. 当用户停止拖动地图时会触发此事件. 当完成地图设置时会触发此事件,并且 isLoaded() 会返回 true.这表示位置,缩放和 地图类型都已完成初始化,但可能还在载入图块. (自 2.52 开始)addoverlay(overlay:GOverlay) removeoverlay(overlay:GOverlay) clearoverlays() mouseover(latlng:GLatLng) mouseout(latlng:GLatLng) mousemove(latlng:GLatLng) dragstart() drag() dragend() load()GMapOptions 类此类代表 GMap2 构造函数的可选参数.它没有构造函数,但可实例化为对象常量.属性属性 size GSize 类型 说明 以像素为单位设置地图大小.传递到地图构造函数的容器会调整为指定大小.默认情况下,地 图会采用其容器的大小. 此地图要使用的地图类型数组.默认情况下使用 G_DEFAULT_MAP_TYPES.使用此选项可以限制 地图中显示的预定义地图类型集合,或者将自有的地图类型传递到地图中.另请参见 GMap2.addMapType(). 地图可拖动时显示的光标. draggableCursor String (自 2.59 开始) 拖动地图时显示的光标. draggingCursor String (自 2.59 开始) 该属性指定配置 GGoogleBar 搜索控件的选项.当构造地图时,会将这些选项传递到 GMapOptions 对象常量,当调用 GMap2.enableGoogleBar() 时,会使用这些选项构造本地 googleBarOptions GGoogleBarOptions GGoogleBar 控件. (自 2.95 开始) backgroundColor String 该属性指定地图图块后要显示的颜色.该颜色可以是任何有效的 W3C 标准颜色值.mapTypesGMapType[](自 2.119 开始)GGoogleBarOptions 类此类表示在 googleBarOptions 参数中传递到 GMapOptions 对象的选项.它没有构造函数,但可实例化为对象常量.请注意,与 GInfoWindow 一样,GGoogleBar 对象不会被构造,但是会自动添加到地图对象中,并通过此处描述的属性启用.属性属性 类型 说明 当设置为 true 时,该属性显示 GoogleBar 中的搜索框(如果启用了控 件并加载了地图).默认情况下,控件中的搜索框是隐藏的,只有当点击 该控件的放大镜时才会展开. (自 2.95 开始) 该属性允许指定嵌入 GoogleBar 的搜索结果中的链接目标.默认值为 G_GOOGLEBAR_LINK_TARGET_BLANK,该默认值指定这些链接将在新窗口中 GGoogleBarLinkTarget 打开. (自 2.95 开始) resultList 该属性可让您指定 GoogleBar 的搜索结果列表的样式,该样式可能为以 GGoogleBarResultList 下样式的一种:G_GOOGLEBAR_RESULT_LIST_INLINE(默认样式)将结果列 or Element 表放入搜索框上的表中;G_GOOGLEBAR_RESULT_LIST_SUPPRESS 使用&下showOnLoadBooleanlinkTarget一个&/&上一个&按钮替换该列表;传递块级别的 DOM 的 Element 将 列表放入您选择的容器(通常为 &div& 元素)中. (自 2.95 开始) suppressInitialResultSelection Boolean 系统完成 GoogleBar 中的搜索后就会在其信息窗口中显示第一个结果 (这是默认行为),该属性抑制这种行为. (自 2.95 开始) suppressZoomToBounds Boolean 该属性还抑制完成 GoogleBar 中的搜索后自动平移和缩放以适合结果集 的操作.(该属性抑制默认行为.) (自 2.95 开始) 该属性指定 GoogleBar 完成搜索且搜索结果关闭时要调用的回调函数. onIdleCallback Function (自 2.95 开始) 该属性指定 GoogleBar 完成搜索且搜索结果完全显示时要调用的回调函 数向该函数传递与搜索控件相关的 GlocalSearch 对象.在结果放到地图 上或结果列表中之前调用该回调函数. (自 2.95 开始) 此属性可让您指定打开搜索结果标记的信息窗口时要调用的回调函数.应 该向该函数先后传递 GMarker,生成的 HTML 字符串和 GlocalSearchResult,并且该函数必须返回要显示在信息窗口中的已修改 HTML 字符串. (自 2.95 开始)onSearchCompleteCallbackFunctiononGenerateMarkerHtmlCallbackFunctiononMarkersSetCallbackFunction该属性可让您指定 GGoogleBar 完成创建标记并将标记放到地图上时要 调用的回调函数.必须向该函数传递一个表格对象数组 {result: GlocalSearch, marker: GMarker}. (自 2.95 开始)枚举 GGoogleBarListingTypes这些常数指定用户在使用 GGoogleBar 进行本地搜索时返回结果的类型.在 GGoogleBarOptions.listingTypes 属性中设置该搜索行 为.常数常数 G_GOOGLEBAR_TYPE_BLENDED_RESULTS 说明 该常数表示 GGoogleBar 的搜索结果仅返回从已经编入索引的 KML/KMZ/GeoRSS 等文件中得 到的结果. (自 2.113 开始) G_GOOGLEBAR_TYPE_KMLONLY_RESULTS 该常数表示 GGoogleBar 的搜索结果仅返回从已经编入索引的 KML/KMZ/GeoRSS 等文件中得 到的结果. (自 2.113 开始) G_GOOGLEBAR_TYPE_LOCALONLY_RESULTS 该常数表示 GGoogleBar 的搜索结果仅返回商业结果和地址解析结果.(自 2.113 开始)枚举 GGoogleBarLinkTarget这些常数被传递到 GGoogleBarOptions.linkTarget 中,定义结果信息窗口中的默认链接目标.常数常数 说明 G_GOOGLEBAR_LINK_TARGET_BLANK 等同于 target = '_blank'. G_GOOGLEBAR_LINK_TARGET_PARENT 等同于 target = '_parent'. G_GOOGLEBAR_LINK_TARGET_SELF G_GOOGLEBAR_LINK_TARGET_TOP 等同于 target = '_self'. 等同于 target = '_top'.枚举 GGoogleBarResultList这些常数被传递到 GGoogleBarOptions.resultList 中,定义怎样显示结果列表.常数常数 G_GOOGLEBAR_RESULT_LIST_INLINE说明 这是默认样式,其结果使用列表形式显示在地图上.G_GOOGLEBAR_RESULT_LIST_SUPPRESS 这是默认样式,其结果列表是隐藏的并替换为下一个 上一个 下一个/上一个 下一个 上一个按钮.枚举 GMapPane这些常数定义地图及地图上的对象为了显示而使用的堆叠顺序(z 顺序).每个窗格定义一组要显示在地图上的类似显示对象,并且 还会在地图上定义唯一的 z 顺序.z 顺序较高的窗格会显示在 z 顺序较低的窗格的&顶部&.(请注意,指定窗格内的对象也可能 有自身的 z 顺序优先级;有的对象可能显示在同窗格中其他对象的顶部.) 如果您通过 GOverlay 进行子类化,则需要使用这些常数,从而可以将自定义叠加层放入某个窗格中. 按照 z 顺序从最低(底部)到最高(顶部)的顺序列出以下常数.常数常数 G_MAP_MAP_PANE G_MAP_OVERLAY_LAYER_PANE (自 2.127 开始) G_MAP_MARKER_SHADOW_PANE G_MAP_MARKER_PANE 该窗格包含标记阴影. 该窗格包含标记前景图. 该窗格是 z 顺序最低的窗格,在图块之上. 该窗格包含折线,多边形,底面叠加层和图块叠加层. 说明G_MAP_FLOAT_SHADOW_PANE G_MAP_MARKER_MOUSE_TARGET_PANE G_MAP_FLOAT_PANE该窗格包含信息窗口阴影.它在 G_MAP_MARKER_PANE 之上,使得标记可以位于信息窗口的阴影中. 此窗格包含透明元素,可为标记接收 DOM 鼠标事件.它在 G_MAP_FLOAT_SHADOW_PANE 之上,以便 可以点击信息窗口阴影中的标记. 此窗格包含信息窗口.它在所有地图叠加层之上.GKeyboardHandler 类对此类进行实例化,以便向地图中添加键盘绑定.该键盘绑定类似于地图应用程序的键盘绑定. 键 操作向上箭头键, 向下箭头键, 向左箭 按下这些键时可连续移动地图.同时按下其中两个键可对角移动. 头键,向右箭头键 page down 键,page up 键,home 以相应方向将地图平移其 3/4 大小,以漂亮的动画显示.其作用等同于 键,end 键 GLargeMapControl 和 GsmallMapControl 中的箭头按钮. +,分别放大或缩小一个级别. 其作用等同于 GLargeMapControl 和 GsmallMapControl 中 的 + 和 - 按钮.构造函数构造函数 说明 GKeyboardHandler(map:GMap2) 为作为参数传递的地图安装键盘事件处理程序.接口 GOverlay地图 API 库中的 GMarker,GPolyline,GTileLayerOverlay 和 GInfoWindow 类都是通过此接口实现的.如果希望在地图上显示自定 义的叠加层对象类型,可以实现这一功能.可使用 GMap2.addOverlay() 方法将 GOverlay 的实例放置于地图上.然后,地图在叠加 层实例上调用 GOverlay.initialize() 方法,先将自己显示在地图上.每当地图显示更改时,地图都会调用 GOverlay.redraw(),这 样叠加层就可以在需要时对自己进行重新放置.叠加层实例可使用方法 GMap2.getPane() 获取一个或多个自己要附加的 DOM 容器元 素.构造函数构造函数 GOverlay() 说明 此构造函数为这些方法创建哑元实现.尽管如此,当有继承自此类的派生类时,派生类的构造函数会调用此构造函数以完 成实现.静态方法方法 返回 值 说明 返回指定纬度的 CSS z-index 值.它计算 z 索引,使靠南的叠加层在靠北的叠加层 之上,从而创建标记叠加层的三维外观.GOverlay.getZIndex(latitude:Number) Number抽象方法方法返回值说明 使用 GMap2.addOverlay() 向地图中添加叠加层后,由地图调用此方法.叠加层对象可以将其本身 拖到地图的各个窗格中,这些窗格可使用 GMap2.getPane() 获取. 使用 GMap2.removeOverlay() 或 GMap2.clearOverlays() 从地图中删除叠加层后,由地图调用此 方法.此时,叠加层必须将自己从地图窗格中删除 此方法在地图显示更改后由地图调用. 如果更改了地图视图的缩放级别或像素偏移量, 则参数 force 将为 true,这样需要重新计算像素坐标.initialize(map:GMap2) None remove() copy() NoneGOverlay 返回叠加层的未初始化副本,可添加到地图中.redraw(force:Boolean) NoneGInfoWindow 类GInfoWindow 没有构造函数.它是由地图创建的,可使用 GMap2.getInfoWindow() 方法访问.方法方法 selectTab(index:Number) hide() show() isHidden() reset(latlng:GLatLng, None None None Boolean None 返回值 说明 选择指定索引对应的标签.它的效果等同于点击相应标签. 隐藏信息窗口.注意:这不会关闭信息窗口.使用 show() 可重新显示 信息窗口. 如果信息窗口当前处于隐藏状态,则可显示信息窗口. 当且仅当信息窗口处于隐藏状态时,返回 true.这包括关闭状态. 重置信息窗口的状态.每个参数都可能为 null,因此其值仍将保持为当tabs:GInfoWindowTab[], size:GSize, offset?:GSize, selectedTab?:Number) getPoint() getPixelOffset() getSelectedTab() getTabs() GLatLng GSize Number GInfoWindowTabs[]前值. 返回信息窗口锚定位置的地理坐标.窗口的箭头指向地图中的该点(对 像素偏移取整). 返回信息窗口的箭头距离信息窗口在地图上所锚定的地理坐标点的像素 偏移量. 返回当前选定的标签的索引(从 0 开始). 返回此信息窗口的标签数组. (自 2.59 开始) 返回包含此信息窗口的标签内容的 DOM 节点数组.getContentContainers()Node[] (自 2.59 开始) 启用信息窗口最大化.可最大化的信息窗口会展开,使用通过 GInfoWindowOptions 的 maxContent 和 maxTitle 属性指定的内容填 充大部分地图.必须使用 maxContent 或 maxTitle 选项打开信息窗口, enableMaximize() 或 disableMaximize 才能生效.默认情况下,使用 maxContent 或 maxTitle 打开的信息窗口会启用最大化. (自 2.93 开始) 禁用信息窗口最大化.必须使用 maxContent 或 maxTitle 选项打开信 息窗口.注意,如果信息窗口当前是打开的,则此函数会移除最大化按 钮,但不会将该窗口恢复为最小化状态. (自 2.93 开始)enableMaximize()NonedisableMaximize()Nonemaximize()None最大化信息窗口.必须使用 maxContent 或 maxTitle 选项打开信息窗 口,并且确保没有通过 disableMaximize 禁用信息窗口最大化. (自 2.93 开始)restore()None将信息窗口恢复到其默认(非最大化)状态.必须使用 maxContent 或 maxTitle 选项打开信息窗口. (自 2.93 开始)事件事件 closeclick() maximizeclick() (自 2.93 开始) 表示此信息窗口已完成最大化. maximizeend() (自 2.93 开始) 表示此信息窗口将要恢复到非最大化状态. restoreclick() (自 2.93 开始) 表示此信息窗口已完成恢复到非最大化状态的操作. restoreend() (自 2.93 开始) 说明 点击信息窗口关闭按钮时会触发此事件. 表示此信息窗口将要最大化.GInfoWindowTab 类此类的实例数组可以作为 tabs 参数传递到方法 GMap2.openInfoWindowTabs(),GMap2.openInfoWindowTabsHtml(), GMarker.openInfoWindowTabs(),GMarker.openInfoWindowTabsHtml() 以及 GMarker.bindInfoWindow*() 变体中.如果数组包含多 个元素, 则将显示带有标签的信息窗口. 每个 InfoWindowTab 对象都包含两个项目: content 定义选中标签时信息窗口的内容, label 定义标签的标签.这些属性将作为参数传递到构造函数中.对于 openInfoWindowTabs() 方法,content 为 DOM 节点.对于 openInfoWindowTabsHtml() 方法,content 为包含 HTML 文字的字符串.构造函数构造函数 GInfoWindowTab(label:String, content:Node or String) 说明 创建一个可以在 tabs 参数中传递到 openInfoWindowTabs*() 方法的信息窗口 标签数据结构.GInfoWindowOptions 类此类的实例可用于类 GMap2 和 GMarker 的方法 openInfoWindow(),openInfoWindowHtml(),openInfoWindowTabs(), openInfoWindowTabsHtml(),变体 bindInfoWindow*() 和 showMapBlowup() 的 opts? 参数中.此类不存在构造函数.但是,此类可 以实例化为 javascript 对象常量.属性正如此类的名称所指明的一样,所有属性都是可选的. 属性 selectedTab maxWidth 类型 Number Number 信息窗口内容的最大宽度(以像素表示). 表明点击地图(未点中标记)时是否应关闭信息窗口.如果设置为 true,则在点击地图时不关闭信息窗口. 默认值为 false. (自 2.83 开始) onOpenFn onCloseFn zoomLevel mapType maxContent Function 打开信息窗口并显示内容后调用函数. Function 关闭信息窗口时调用函数. Number 说明 选择指定索引(从 0 开始)对应的标签,而不是索引 0 对应的第一个标签.noCloseOnClick Boolean仅限于 showMapBlowup().信息窗口中放大地图的缩放级别. GMapType 仅限于 showMapBlowup().信息窗口中放大地图的地图类型.指定最大化信息窗口时要显示的内容.该内容可以为 HTML 字符串或 HTML DOM 元素. String (自 2.93 开始) 指定最大化信息窗口时要显示的标题.该内容可以为 HTML 字符串或 HTML DOM 元素.maxTitleString (自 2.93 开始) 指定要在向上 (x) 方向和向右 (y) 方向从指定的 GLatLng 移动信息窗口所移动的像素数.pixelOffsetGSize (自 2.98 开始)GMarker 类GMarker 标记地图上的位置.它实现 GOverlay 接口,因此可使用 GMap2.addOverlay() 方法添加到地图中. 标记对象包含 latlng(这是标记在地图中锚定的地理位置)和 icon.如果未在构造函数中设置 icon,则会使用默认图标 G_DEFAULT_ICON. 将标记对象添加到地图中后,通过标记可打开该地图的信息窗口.标记对象会触发鼠标事件和信息窗口事件.构造函数构造函数 GMarker(latlng:GLatLng, icon?:GIcon, inert?:Boolean) 说明 在传递的 GPoint 或 GLatLng 的 latlng 上创建带有 icon 或 G_DEFAULT_ICON 的标记. 如果 inert 标记为 true,则标记不可点击,也不会触发任何事件. (自 2.50 开始不推荐使用) GMarker(latlng:GLatLng, opts?:GMarkerOptions) 按 GMarkerOptions 中指定的选项在 latlng 创建标记.默认情况下,标记是可点击的, 并且有默认图标 G_DEFAULT_ICON. (自 2.50 开始)方法将标记添加到地图中后,才能调用这些方法.方法 openInfoWindow(content:Node, opts?:GInfoWindowOptions) openInfoWindowHtml(content:String, opts?:GInfoWindowOptions) openInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)返回值 None None说明 通过标记图标打开地图信息窗口.信息窗口的内容为 DOM 节点 节点.只 适用于 GInfoWindowOptions.maxWidth 选项. 通过标记图标打开地图信息窗口.信息窗口的内容为包含 HTML 文 本的字符串.只适用于 GInfoWindowOptions.maxWidth 选项. 通过标记图标打开带标签的地图信息窗口.信息窗口的内容为标签 数组,这些标签包含 DOM 节点 节点形式的标签内容.只适用于 GInfoWindowOptions.maxWidth 和 InfoWindowOptions.selectedTab 选项. 通过标记图标打开带标签的地图信息窗口.信息窗口的内容为标签 数组,这些标签所包含的标签内容是包含 HTML 文本 文本的字符串.只 适用于 InfoWindowOptions.maxWidth 和 InfoWindowOptions.selectedTab 选项. 将指定的 DOM 节点 节点绑定到此标记.当点击标记时,此节点中的内容 会自动显示在信息窗口中.将 null 作为 content 传递来解除绑 定. (自 2.85 开始)NoneopenInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)NonebindInfoWindow(content:Node, opts?:GInfoWindowOptions)NonebindInfoWindowHtml(content:String, opts?:GInfoWindowOptions) bindInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)None将指定的 HTML 绑定到此标记.当点击标记时,HTML 内容将自动显 示在信息窗口中.将 null 作为 content 传递来解除绑定. (自 2.85 开始)None将指定的 GInfoWindowTab(作为 DOM 节点提供)绑定到此标记. 当点击标记时,这些标签节点中的内容会自动显示在信息窗口中. 将 null 作为 tabs 传递来解除绑定.(自 2.85 开始) bindInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions) 将指定的 GInfoWindowTab (作为 HTML 字符串提供) 绑定到此标记. 当点击标记时, 这些标签中的 HTML 内容会自动显示在信息窗口中. 将 null 作为 tabs 传递来解除绑定. (自 2.85 开始) 仅关闭属于此标记的信息窗口. closeInfoWindow() None (自 2.85 开始) showMapBlowup(opts?:GInfoWindowOptions) getIcon() getTitle() None GIcon String 通过标记图标打开地图信息窗口.信息窗口的内容是标记位置周围 的近景地图.只适用于 InfoWindowOptions.zoomLevel 和 InfoWindowOptions.mapType 选项. 根据构造函数的设置返回此标记的 icon. 根据构造函数通过 GMarkerOptions.title 属性的设置,返回此标 记的标题.如果未传入标题,则返回&undefined&. (自 2.85 开始) 根据构造函数或 setPoint() 的设置, 返回此标记锚定的地理坐标. getPoint() GLatLng (自 2.88 开始不推荐使用) getLatLng() GLatLng 根据构造函数或 setLatLng() 的设置,返回此标记锚定的地理坐 标. (自 2.88 开始)None设置此标记的锚定点的地理坐标. setPoint(latlng:GLatLng) None (自 2.88 开始不推荐使用) 设置此标记的锚定点的地理坐标. setLatLng(latlng:GLatLng) enableDragging() disableDragging() draggable() draggingEnabled() None (自 2.88 开始) None None Boolean 允许在地图上拖放标记.该方法只有在已经用 GMarkerOptions.draggable = true 初始化标记的情况下才生效. 禁止在地图上拖放标记. 如果已使用 GMarkerOptions.draggable = true 通过构造函数对标 记进行了初始化,则返回 true.否则,返回 false. 请求将 url 指定的图像设置为此标记的前景图.注意,不调整打印 图像和阴影图像.因此,此方法主要是为了达到高亮显示或变暗显 示效果,而不是彻底改变标记的外观. (自 2.75 开始) hide() None 如果当前标记可见,则隐藏标记.注意,如果当前标记可见,则此 函数会触发 GMarker.visibilitychanged 事件. (自 2.77 开始) show() None 如果当前标记不可见,则显示标记.请注意,如果当前标记不可见, 则此函数会触发 GMarker.visibilitychanged 事件. (自 2.77 开始)Boolean 如果当前允许用户在地图中拖动标记,则返回 true.setImage(url:String)None如果当前标记不可见,则返回 true.否则,返回 false. isHidden() Boolean (自 2.77 开始)事件只有当标记处于活动状态时,才会触发上述所有事件(请参见构造函数). 事件 click(latlng:GLatLng) dblclick(latlng:GLatLng) mousedown(latlng:GLatLng) 说明 点击标记图标时会触发此事件,从而通过其 latlng 参数传入标记的当前坐标.请注意,同 时还会使地图触发此事件,将标记作为第一个参数传递到那里的事件处理程序中. 双击标记图标时会触发此事件,从而通过其 latlng 参数传入标记的当前坐标.请注意,不 会使地图触发此事件,因为地图双击时居中是固定行为. 在标记图标上触发 DOM mousedown 事件时会触发此事件,从而通过其 latlng 参数传入标 记的当前坐标.请注意,标记会停止 mousedown DOM 事件,这样就不会导致地图开始拖动. 在标记上触发 DOM mouseup 事件时会触发此事件,从而通过其 latlng 参数传入标记的当 前坐标.请注意,标记不会停止 mousedown DOM 事件,因为它不会干扰地图的拖动处理程 序. 当鼠标进入标记图标区域时会触发此事件,从而通过其 latlng 参数传入标记的当前坐标. 当鼠标离开标记图标区域时会触发此事件,从而通过其 latlng 参数传入标记的当前坐标. 当通过此标记打开地图的信息窗口时会触发此事件. 关闭通过此标记打开的地图信息窗口前会触发此事件.mouseup(latlng:GLatLng) mouseover(latlng:GLatLng) mouseout(latlng:GLatLng) infowindowopen() infowindowbeforeclose()(自 2.83 开始) infowindowclose() 关闭通过此标记打开的地图信息窗口时会触发此事件.关闭信息窗口或在其他标记或在地图 上打开信息窗口时,都会触发此事件.此事件在触发前会触发 infowindowbeforeclose 事 件. 使用 GMap2.removeOverlay() 或 GMap2.clearOverlays() 从地图删除标记时会触发此事 件. 如果启用了标记的拖动操作,则在开始拖动标记时会触发此事件,从而通过其 latlng 参数 传入标记的当前坐标. 如果启用了标记的拖动操作,则在拖动标记的过程中会触发此事件,从而通过其 latlng 参 数传入标记的当前坐标. 如果启用了标记的拖动操作,则在停止拖动标记时会触发此事件,从而通过其 latlng 参数 传入标记的当前坐标. 当标记的可见性发生更改时会触发此事件(即可见性从可见更改为隐藏时,或从隐藏更改为 可见时).isVisible 指发生可见性更改后标记的状态. (自 2.77 开始)remove() dragstart(latlng:GLatLng) drag(latlng:GLatLng) dragend(latlng:GLatLng)visibilitychanged(isVisible:Boolean)GMarkerOptions 类此类的实例可用于 GMarker 类构造函数的 opts? 参数中.此类不存在构造函数.但是,此类可以实例化为 javascript 对象常量.属性正如此类的名称所指明的一样,所有属性都是可选的. 属性 icon 类型 GIcon (自 2.50 开始) dragCrossMove Boolean 正常拖动标记时,标记将浮起并离开光标.将此值设置为 true 可以保持标记位于光标的下面,用十字光标 下移代替标记浮起.此选项的默认值为 false. (自 2.63 开始) 此字符串显示为标记的工具提示,也就是它的作用等同于 HTML 元素中的 title 属性. title String (自 2.50 开始) clickable Boolean 切换以选择标记是否可点击.不可点击或拖动的标记是不活动的,它消耗的资源较少但不对任何事件做出响 应.此选项的默认值为 true,即如果未指定该选项,则标记为可点击的. (自 2.50 开始) draggable Boolean 切换以选择用户是否可拖动标记.设置为可拖动的标记比设置为可点击的标记所需的资源更多.可拖动的标 记同时也是可点击的标记,默认情况下启用弹跳效果和自动平移.此选项的默认值为 false. (自 2.61 开始) 切换拖动完标记后是否应上下弹动.此选项的默认值为 false. bouncy Boolean (自 2.61 开始) bounceGravity Number 此数字用于定义完成拖动操作时标记在弹到地面期间的加速度.此选项的默认值为 1. 说明 为此类选择图标.如果未指定,则使用 G_DEFAULT_ICON.(自 2.61 开始) 将标记拖到边缘时自动平移地图.如果标记是可拖动的,则此选项的默认值为 true. autoPan Boolean (自 2.87 开始) zIndexProcess Function 此函数用于在标记叠加到地图上时更改标记的 z-Index 顺序,当其信息窗口打开时也调用该函数.默认顺序 是越靠南的标记越靠上.此函数被传递到 GMarker 对象中,返回一个表示新 z-index 的数字. (自 2.98 开始) hide Boolean 设置为 true 时,表示地图不应一开始就显示 GMarker.要打开叠加层,请调用 GMarker.show().默认情况 下,该值设置为 false. (自 2.139 开始)GPolyline 类这是一种使用浏览器的矢量制图工具(如果可用)在地图上绘制折线的地图叠加层,或者是来自 Google 服务器的图像叠加层.构造函数构造函数 GPolyline(latlngs:GLatLng[], color?:String, weight?:Number, opacity?:Number, opts?:GPolylineOptions) 说明 根据顶点数组创建折线.color 是一个字符串,包含十六进制数字,HTML 样式的颜色, #RRGGBB. 如 weight 是以像素为单位的线宽度. opacity 为 0 到 1 之间的数字.该线条平滑且半透明.工厂方法方法 返回值 说明 根据聚合坐标和级别的编码字符串创建折线. color 是一个字 符串,包含十六进制数字,HTML 样式的颜色,如 #RRGGBB. weight 是以像素为单位的线宽.opacity 是介于 0 和 1 之 间的数字.latlngs 是包含已编码的经度和纬度坐标的字符 GPolyline.fromEncoded(color?:String, weight?:Number, 串.levels 是包含已编码的折线缩放级别组的字符串. opacity?:Number, latlngs:String, zoomFactor:Number, GPolyline numLevels 是已编码的 levels 字符串中包含的缩放级别数. levels:String, numLevels:Number) zoomFactor 是编码的 levels 字符串中相邻缩放级别组合之 间的倍数.这两个值结合使用可确定已编码的折线中 levels 的精确度.该线条是防锯齿且半透明的. (自 2.63 开始)方法方法 deleteVertex(index:Number) 返回值 None 说明 删除折线中含有指定索引值的顶点并相应更新折线的形状.必须已通过 GMap2.addOverlay() 将 GPolyline 添加到地图中. (自 2.111 开始) disableEditing() None 撤消 enableEditing 的效果, 从而删除线上的所有控制点并显示为用户 不可编辑.(自 2.111 开始) 允许用户通过点击地图上的其他点构造(或修改)GPolyline 对象.必 须已通过 GMap2.addOverlay() 将 GPolyline 添加到地图中, 即使折线 最初未填充任何内容,也不包含任何顶点.每点击一次都会向折线链添 加一个附加&顶点&, 可通过双击或再次点击最后添加的点来结束制图, 如果折线顺利绘制完, 会在最后添加的点处触发&endline&事件, 否则, 会触发&cancelline&事件,但是不会从地图上删除折线.如果要修改 现有 GPolyline,则会从现有折线的起点或终点连接顶点,这在可选参 数 GPolyEditingOptions.fromStart 中指定. (自 2.111 开始) 如果启用, 则用户可以选择并拖动现 允许修改点的现有 GPolyline 链. 有顶点.除非在 GPolyEditingOptions 中通过 maxVertices 指定了小 于当前顶点数的顶点限制,否则还将在折线部分的中点处添加&假性控 制&点,从而可让用户通过点击和拖动这些附加顶点加入新顶点.每当 添加或移动顶点时,都会触发&lineupdated&事件. (自 2.111 开始) 返回折线中顶点的数目. getVertexCount() Number (自 2.46 开始) 返回折线中指定索引对应的顶点. getVertex(index:Number) getLength() GLatLng (自 2.46 开始) Number 返回沿地球表面的折线的长度(以米为单位).enableDrawing(opts?:GPolyEditingOptions) NoneenableEditing(opts?:GPolyEditingOptions) None(自 2.85 开始) 返回此折线的边界. getBounds() GLatLngBounds (自 2.85 开始) 如果当前折线可见并且 GPolyline.supportsHide() 返回 true, 则隐藏 此折线.注意,如果当前折线可见,则此函数会触发 GPolyline.visibilitychanged 事件. (自 2.87 开始) insertVertex(index:Number, latlng:GLatLng) None 在折线中的指定索引处插于一个新点并更新其形状.必须已通过 GMap2.addOverlay() 将 GPolyline 添加到地图中. (自 2.111 开始) 如果当前折线不可见,则返回 true.否则,返回 false. isHidden() Boolean (自 2.87 开始) show() None 如果当前折线不可见,则显示该折线.注意,如果当前折线不可见,则 此函数会触发 GPolyline.visibilitychanged 事件. (自 2.87 开始) supportsHide() Boolean 如果当前环境下支持 GPolyline 对象的 GPolyline.hide(),则返回 true.否则,返回 false. (自 2.87 开始)hide()NonesetStrokeStyle(style:GPolyStyleOptions) None更改折线的样式. 必须已通过 GMap2.addOverlay() 将 GPolyline 添加 到地图中. (自 2.111 开始)事件事件 remove() 说明 使用 GMap2.removeOverlay() 或 GMap2.clearOverlays()从地图删除折线时会触发此事 件. 当折线的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件. isVisible 参数反映完成此可见性状态的更改后折线的状态. (自 2.87 开始) click(latlng:GLatLng) 点击折线时会触发此事件,从而通过其 latlng 参数传入线条的已点击坐标.请注意,此事 件随后还会触发地图上的&click&事件,在该事件中折线作为 overlay 参数传递. (自 2.88 开始) 鼠标移动到折线上时会触发此事件. mouseover() (自 2.111 开始) 鼠标离开折线时会触发此事件. mouseout() (自 2.111 开始) lineupdated() 更新折线的样式或形状时会触发此事件.visibilitychanged(isVisible:Boolean)(自 2.111 开始) 用户完成线的绘制(通过调用 GPolyline.enableDrawing 开始)时会触发此事件. endline() (自 2.111 开始) 用户中断线的绘制(通过调用 GPolyline.enableDrawing 开始)时会触发此事件. cancelline() (自 2.111 开始)GPolylineOptions 类此类的实例用于 GPolyline 的构造函数中.此类不存在构造函数.但是,此类可以实例化为 javascript 对象常量.属性正如此类的名称所指明的一样,所有属性都是可选的. 属性 类型 说明 切换以选择折线是否可点击.此选项的默认值为 true,即未指定该选项时,折线可点击. clickable Boolean (自 2.91 开始) geodesic Boolean 将折线的每个边渲染为测地线(大圆的一段).测地线是沿地球表面的两个点之间的最近路径.(自 2.84 开始)GPolyEditingOptions 类此类的实例用于 GPolyline 和 GPolygon 的 enableEditing 方法中. 此类不存在构造函数. 但是, 此类可以实例化为 javascript 对 象常量.属性正如此类的名称所指明的一样,所有属性都是可选的. 属性 类型 说明 此属性指定可用于该折线的最大顶点数.一旦达到此最大数,就不再添加顶点. maxVertices Number (自 2.111 开始) 此属性指定 enableDrawing 是否应从起点而不是端点(默认值)添加点. fromStart Boolean (自 2.111 开始)GPolyStyleOptions 类此类的实例用于 GPolyline 和 GPolygon 的 setStrokeStyle 方法以及 GPolygon 的 setFillStyle 方法中.此类不存在构造函数. 但是,此类可以实例化为 javascript 对象常量.属性正如此类的名称所指明的一样,所有属性都是可选的. 属性 color 类型 String (自 2.111 开始) 此属性指定以像素为单位的线宽. weight Number (自 2.111 开始) 此属性将折线的不透明度指定为 0(透明)和 1(不透明)之间的分数值. opacity Number (自 2.111 开始) 说明 此属性指定一个字符串,包含十六进制数字,HTML 样式的颜色,如 #RRGGBB.GPolygon 类这除了可另外指定填充色和不透明性外,其他方面都非常类似于 GPolyline.构造函数构造函数 GPolygon(latlngs:GLatLng[], strokeColor?:String, strokeWeight?:Number, strokeOpacity?:Number, fillColor?:Number, fillOpacity?:Number, opts?:GPolygonOptions) 说明 根据顶点数组创建多边形.colors 是一个字符串,包含十六 进制数字,HTML 样式的颜色,如 #RRGGBB.weight 是以像素 为单位的线宽度.opacities 为 0 到 1 之间的数字.该线条 平滑且半透明. (自 2.69 开始)工厂方法方法 返回值 说明 根据聚合坐标和级别的编码字符串创建多边形 (由大量折线组成) . polylines 包含组成它的折线的关联数组,其编码格式与 GPolyline.fromEncoded 文档中所描述的格式相同.fill 指定是 否用某种 color 填充该多边形. opacity 和 outline 指定是否用 GPolygon 折线的颜色, 重量和不透明性画多边形. 如果在折线中指定多个值, 则采用折线的第一个值. (自 2.78 开始)GPolygon.fromEncoded(polylines:encoded polylines[], fill?:Boolean, color?:String, opacity?:Number, outline?:Boolean)方法方法 返回值 说明deleteVertex(index:Number)None使用多边形中指定的索引删除顶点并相应更新多边形的形状.必须已通 过 GMap2.addOverlay() 将 GPolygon 添加到地图中. (自 2.111 开始)disableEditing()None撤消 enableEditing 的效果, 从而删除线上的所有控制点并显示为用户 不可编辑. (自 2.111 开始) 允许用户通过点击地图上的附加点构造 GPolygon 对象.必须已通过 GMap2.addOverlay() 将 GPolyline 添加到地图中,即使折线最初未填 充任何内容,也不包含任何顶点.每点击一次都会向多边形边界添加一 个附加&顶点&,可通过双击或点击第一个点来完成形状,从而结束制 图.如果多边形顺利绘制完,会在第一个点处触发&endline&事件,否 则,会触发&cancelline&事件,但是不会从地图上删除折线. (自 2.111 开始) 允许修改现有的 GPolygon 边界.如果启用,则用户可以选择并拖动现 有顶点.除非在 maxVertices 中通过 GPolyEditingOptions 指定了小 于当前顶点数的顶点限制,否则还将在多边形部分的中点处添加&假性 控制&点,从而可让用户通过点击和拖动这些附加顶点加入新顶点.每 当添加或移动顶点时,都会触发&lineupdated&事件. (自 2.111 开始) 返回多边形中的顶点数.enableDrawing(opts?:GPolyEditingOptions) NoneenableEditing(opts?:GPolyEditingOptions) NonegetVertexCount()Number (自 2.69 开始)返回多边形中指定索引对应的顶点. getVertex(index:Number) GLatLng (自 2.69 开始) 返回以平方米表示的多边形面积(假定地球是一个球形). getArea() Number (自 2.85 开始) 返回此多边形的边界. getBounds() GLatLngBounds (自 2.85 开始) 如果多边形可见并且 GPolygon.supportsHide 返回 true,则隐藏该多 边形.请注意,如果当前多边形可见,则此函数会触发 GPolygon.visibilitychanged 事件. (自 2.87 开始) insertVertex(index:Number, latlng:GLatLng) None 在多边形中的指定索引处插入一个新点.必须已通过 GMap2.addOverlay() 将 GPolygon 添加到地图中. (自 2.111 开始) 如果当前多边形不可见,则返回 true.否则,返回 false. isHidden() Boolean (自 2.87 开始) show() None 如果当前多边形不可见,则显示该多边形.请注意,如果当前多边形不 可见,则此函数会触发 GPolygon.visibilitychanged 事件. (自 2.87 开始)hide()NonesupportsHide()Boolean如果当前环境下支持 GPolygon 对象的 GPolygon.hide(),则返回 true.否则,返回 false. (自 2.87 开始)setFillStyle(style:GPolyStyleOptions)None更改多边形的填充样式. 必须已通过 GMap2.addOverlay() 将 GPolygon 添加到地图中. (自 2.111 开始)setStrokeStyle(style:GPolyStyleOptions) None更改多边形的线条样式. 必须已通过 GMap2.addOverlay() 将 GPolygon 添加到地图中. (自 2.111 开始)事件事件 remove() 说明 使用 GMap2.removeOverlay() 或 GMap2.clearOverlays() 从地图删除多边形时会触发此 事件. 当多边形的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件. isVisible 参数反映完成此可见性状态的更改后多边形的状态. (自 2.87 开始) click(latlng:GLatLng) 点击多边形时会触发此事件,从而通过其 latlng 参数传入多边形的已点击坐标.请注意, 此事件随后还会触发地图上的&click&事件,在该事件中多边形作为 overlay 参数传递.visibilitychanged(isVisible:Boolean)(自 2.88 开始) 鼠标移动到多边形区域时会触发此事件. mouseover() (自 2.111 开始) 鼠标离开多边形区域时会触发此事件. mouseout() (自 2.111 开始) 更新多边形的样式或形状时会触发此事件. lineupdated() (自 2.111 开始) 用户完成多边形的绘制(通过调用 GPolyline.enableDrawing 开始)时会触发此事件. endline() (自 2.111 开始) 用户完成多边形的绘制(通过调用 GPolyline.enableDrawing 开始)时会触发此事件. cancelline() (自 2.111 开始)GPolygonOptions 类此类的实例用于 GPolygon 的构造函数中.此类不存在构造函数.但是,此类可以实例化为 javascript 对象常量.属性正如此类的名称所指明的一样,所有属性都是可选的. 属性 类型 说明 切换以选择多边形是否可点击.此选项的默认值为 true,即未指定该选项时,多边形可点击. clickable Boolean (自 2.91 开始)GScreenOverlay 类该对象显示地图上的矩形图像叠加层,其位置不会随视口的改变而变化.用于 ScreenOverlays 的示例有圆规,徽标和智能显示技术.构造函数构造函数 说明 创建来自某个图像网址的屏幕叠加层, 并按照 screenXY, overlayXY 和 size 参 数的指定将其显示在屏幕上.overlayXY 参数确定叠加层图像上(或图像外)的 GScreenOverlay(imageUrl:String, 点,该点坐标为 screenXY.这可用于有效&修剪&图像.screenXY 参数相对于 screenXY:GScreenPoint, overlayXY:GScreenPoint, 屏幕原点(左下角)确定该叠加层图像所对应的点. size:GScreenSize) (自 2.92 开始)方法方法 hide()返回值 None说明 如果当前屏幕叠加层可见,则隐藏它.请注意,如果当前屏幕叠加层可见,则此函数会触发 GScreenOverlay.visibilitychanged 事件. (自 2.92 开始) 如果当前屏幕叠加层不可见,则返回 true.否则,返回 false.isHidden()Boolean (自 2.92 开始) 如果当前屏幕叠加层不可见,则显示该叠加层.请注意,如果当前屏幕叠加层不可见,则此函数会触发 GScreenOverlay.visibilitychanged 事件. (自 2.92 开始) 总是返回 true.show()NonesupportsHide() Boolean (自 2.92 开始)事件事件 visibilitychanged(isVisible:Boolean) 说明 当屏幕叠加层的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件. isVisible 参数反映完成此可见性状态的更改后屏幕叠加层的状态. (自 2.92 开始)GScreenPoint 类GScreenPoint 通过 X 和 Y 坐标标识地图视口上的点,其中每个坐标都可以根据可选构造函数参数的值表示相对或绝对定位.构造函数构造函数 GScreenPoint(x:Number, y:Number, xunits?:String, yunits?:String) 说明 创建 GScreenPoint 对象.x 和 y 坐标也可以通过将&fraction&或&pixels&传入 xunits 和 yunits 参数中表示相对或绝对定位.这些参数的默认值为&pixels&. (自 2.92 开始)属性属性 x y 类型 Number x 坐标向左增大. Number y 坐标向下增大. 指定用于 x 坐标的单位类型.将该单位设置为&fraction&表示相对于地图大小的相对位置,而设置为&pixels&表 示绝对定位.默认情况下为绝对定位. 指定用于 y 坐标的单位类型.将该单位设置为&fractional&表示相对于地图大小的相对位置,而设置为&pixels& 表示绝对定位.默认情况下为绝对定位. 说明xunits String yunits StringGScreenSize 类GScreenSize 表示由 width 和 height 参数确定的地图的矩形区域大小. 这些参数中的每个参数都可以根据可选构造函数参数的值表 示相对或像素大小.构造函数构造函数 GScreenSize(width:Number, height:Number, xunits?:String, yunits?:String) 说明 创建 GScreenSize 对象.width 和 height 坐标可以通过&fraction&或 &pixel&传递到 xunits 和 yunits 参数中表示相对或像素大小.width 和 height 参数的默认值为&pixel&. (自 2.92 开始)属性属性 类型 说明 width Number 屏幕实际使用面积的宽度参数.注意,该值可以根据 GScreen.yunits 属性的值表示相对或绝对像素值. height Number 屏幕实际使用面积的高度参数.注意,该值可以根据 GScreen.yunits 属性的值表示相对或绝对像素值. xunits String yunits String 指定用于 GScreenSize.width 属性的单位类型.将该单位设置为&fractional&表示相对于地图大小的相对位置,而 设置为&pixel&表示像素定位.默认情况下为像素定位. 指定用于 GScreenSize.height 属性的单位类型.将该单位设置为&fractional&表示相对于地图大小的相对位置,而 设置为&pixel&表示像素定位.默认情况下为像素定位.GGroundOverlay 类此对象可在地图中创建矩形图像叠加层,其边界由 GLatLngBounds 定义.构造函数构造函数 GGroundOverlay(imageUrl:String, bounds:GLatLngBounds) (自 2.79 开始) 说明 根据图像网址及其边界创建底面叠加层.方法方法 hide() 返回值 None 说明 如果当前底面叠加层可见,则隐藏它.请注意,如果当前底面叠加层可见,则此函数会触发 GGroundOverlay.visibilitychanged 事件. (自 2.87 开始) 如果当前底面叠加层不可见,则返回 true.否则,返回 false. isHidden() show() Boolean (自 2.87 开始) None 如果当前底面叠加层不可见,则显示它.请注意,如果当前底面叠加层不可见,则此函数会触发 GGroundOverlay.visibilitychanged 事件.(自 2.87 开始) 总是返回 true. supportsHide() Boolean (自 2.87 开始)事件事件 visibilitychanged(isVisible:Boolean) 说明 当底面叠加层的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件. isVisible 参数反映完成此可见性状态的更改后底面叠加层的状态 (自 2.77 开始)GIcon 类图标指定用来在地图上显示 GMarker 的图像.由于浏览器兼容性的原因,要指定一个图标实际上相当复杂.请注意,如果不想指定自 己的图标,则可使用默认 Google 地图图标 G_DEFAULT_ICON.构造函数构造函数 GIcon(copy?:GIcon, 说明 创建新图标对象.如果可选的 copy 参数中给出另一个图标,则将复制其属性,否则将留为空白.可image?:String)选的参数 image 可设置 image 属性的值.常数常数 说明 G_DEFAULT_ICON 标记使用的默认图标.属性属性 image shadow iconSize shadowSize iconAnchor printImage mozPrintImage printShadow transparent imageMap 类型 String String GSize GSize GPoint String String String String 图标的前景图像网址. 图标的阴影图像网址. 图标前景图像的像素大小. 阴影图像的像素大小. 此图标在地图上的锚定点相对于图标图像左上角的像素坐标. 信息窗口在此图标上的锚定点相对于图标图像左上角的像素坐标. 打印地图所用的前景图标图像网址.其大小必须与 image 提供的主图标图像的大小相同. 用 Firefox/Mozilla 打印地图时所用的前景图标图像网址. 其大小必须与 image 提供的主图标图像的大 小相同. 打印地图时所用的阴影图像网址.由于大多数浏览器都无法打印 PNG 图像,所以图像格式应该为 GIF. 在 Internet Explorer 中捕获点击事件时,所用的透明前景图标图像网址.此图像应是具有 1% 不透明 性的 24 位 PNG 格式的主图标图像,但其大小和形状同主图标相同. 说明infoWindowAnchor GPointNumber[] 表示图像地图 x/y 坐标的整数数组,用它指定浏览器(非 Internet Explorer)中图标图像的可点击部分. 指定拖动标记时视觉上垂直&上升&的距离(以像素表示). maxHeight Integer (自 2.79 开始) 指定拖动图标时十字交叉图像的网址. dragCrossImage String (自 2.79 开始) 指定拖动图标时十字交叉图像的像素大小. dragCrossSize GSize (自 2.79 开始) 指定拖动图标时十字交叉图像的像素坐标偏移量(相对于 iconAnchor). dragCrossAnchor GPoint (自 2.79 开始)GPoint 类GPoint 是以像素坐标表示的地图上的一点.请注意,在 v2 中,它不再是以地理坐标表示的地面上的一个点.现在,地理坐标可以用 GLatLng 表示. 在 Google 地图坐标系统中,x 坐标向右增大,y 坐标&向下&增大,不过如果愿意,您也可以使用 GPoint 坐标. 注意:尽管 GPoint 的两个参数可以作为属性 x 和 y 访问,但是请勿修改它们,而是在创建新对象时使用不同的参数.构造函数构造函数 说明 GPoint(x:Number, y:Number) 创建 GPoint 对象.属性属性 类型 x y 说明 Number x 坐标.(在 Google 地图坐标系统中,该值向右增大.) Number y 坐标.(在 Google 地图坐标系统中,该值向下增大.)方法方法 toString() 返回值 说明 equals(other:GPoint) Boolean 当且仅当其他点有相等的坐标时,返回 true. String 返回包含 x 和 y 坐标的字符串,先 x 坐标后 y 坐标,之间用逗号分隔.GSize 类GSize 是地图矩形区域的大小(以像素表示).大小对象有两个参数:width 和 height.宽度是点的 x 坐标的差值,高度是 y 坐标 的差值. 注意:尽管 GSize 的两个参数可以作为属性 width 和 height 访问,但是请勿修改它们,而是在创建新对象时使用不同的参数.构造函数构造函数 说明 GSize(width:Number, height:Number) 创建 GSize 对象.属性属性 类型 说明 width Number 宽度参数. height Number 高度参数.方法方法 toString() 返回值 说明 equals(other:GSize) Boolean 当且仅当另一大小的分量完全相同时,返回 true. String 返回包含宽度和高度参数的字符串,先宽度后高度,之间用逗号分隔.GBounds 类GBounds 是以像素坐标表示的地图矩形区域.请注意,&地理坐标&中的矩形可用 GLatLngBounds 表示.构造函数构造函数说明GBounds(points:GPoint[]) 构造一个包含所有指定 points 的矩形.属性属性 类型 说明 minX Number 矩形左边的 x 坐标. minY Number 矩形上边的 y 坐标. maxX Number 矩形右边的 x 坐标. maxY Number 矩形下边的 y 坐标.方法方法 toString() equals(other:GBounds) 返回值 String Boolean (自 2.98 开始) 返回矩形区域的中心点像素坐标. mid() min() GPoint (自 2.88 开始) GPoint 返回矩形区域的左上角像素坐标. 说明 返回包含框的左上角点坐标和右下角点坐标的字符串,先左上后右下,中间用逗号分隔,前 后用圆括号括起来. 在此矩形中的所有参数都等于另一矩形中的参数时返回 true.max()GPoint 返回矩形区域的右下角像素坐标. 如果矩形区域(含边界)本身包含像素坐标,则返回 true.containsBounds(other:GBounds) Boolean 如果传入的矩形区域完全包含于此矩形区域中,则返回 true. containsPoint(point:GPoint) extend(point:GPoint) Boolean (自 2.88 开始) None 放大此框,使该点也包括在框中.GLatLng 类GLatLng 是以经度和纬度表示的地理坐标点. 请注意,尽管进行地图投影时通常将经度与 x 坐标相关联,将纬度与 y 坐标相关联,但总是先填写纬度坐标,后填写经度坐标,因 为这符合绘图习惯. 另请注意,不能修改 GLatLng 的坐标.如果想要计算另一个点,必须新建一个.构造函数构造函数 GLatLng(lat:Number, lng:Number, unbounded?:Boolean) 说明 注意纬度和经度的顺序.如果 unbounded 标记为 true,则将使用传递的数字,否则纬度会 限定在 -90 度和 +90 度之间,而经度会限定在 -180 度和 +180 度之间.方法方法 lat() lng() latRadians() lngRadians() equals(other:GLatLng) distanceFrom(other:GLatLng)返回值 Number Number Number Number说明 返回以度数表示的纬度坐标(-90 到 +90 之间的数字).如果在构造函数中设置了 unbounded 标记,则纬度坐标可能超出此范围. 返回以度数表示的经度坐标(-180 到 +180 之间的数字).如果在构造函数中设置了 unbounded 标记,则经度坐标可能超出此范围. 返回以弧度为单位的纬度坐标(-PI/2 到 +PI/2 之间的数字).如果在构造函数中设置 了 unbounded 标记,则纬度坐标可能超出此范围. 返回以弧度表示的经度坐标(-PI 到 +PI 之间的数字).如果在构造函数中设置了 unbounded 标记,则经度坐标可能超出此范围. 返回从此点到某个指定点的距离(以米为单位).地球近似一个球体,因此距离可能会 有不会超过 0.3% 的误差.请参见以下信息. (自 2.89 开始不推荐使用)Boolean 当且仅当其他大小具有相同分量(在一定的舍入范围内)时返回 true. NumberdistanceFrom(other:GLatLng, radius?:Number)返回从此点到某个指定点的距离(以米为单位).在默认情况下,根据地球赤道半径的 默认值 6378137 米计算此距离. 地球近似一个球体, 因此距离可能会有不超过 0.3% 的 误差(尤其在两极).也可以传递可选的 radius 参数计算不同于地球半径的球体的 Number GLatLng 坐标之间的距离. (自 2.89 开始)toUrlValue()String不推荐使用此版本的方法,而使用能传递可选 precision 参数的修订版方法(如下所 示). (自 2.78 开始不要使用)toUrlValue(precision?:Number)返回表示此点的字符串, 采用适合用作网址参数值的格式, 中间用逗号分隔且不含空格. 默认情况下,精确度的返回值为 6 位数字,相当于 4 英寸/11 厘米的分辨率.可选的 precision 参数可让您指定更低的精确度以减轻服务器负载.注意:在 2.78 之前,此 String precision 参数不可用. (自 2.78 开始)属性这些属性的存在只是为了实现与 v1 事件处理程序函数的向后兼容.不应使用它们. 这些属性反映 lng() 和 lat() 存取器方法的返回值,还可在 v1 客户端期望的 GPoint 位置显示 GLatLng.如果要使 GLatLng 出现 在事件明细中(即出现在事件处理程序函数的参数中),这是必需的.与方法包装器不同,在当前的基础框架中不可创建事件包装器. 属性 类型 x y 说明Number 不再推荐使用. Number 不再推荐使用.GLatLngBounds 类GLatLngBounds 实例在地理坐标中代表矩形,包括与 180 度子午线相交的矩形.构造函数构造函数 说明 GLatLngBounds(sw?:GLatLng, ne?:GLatLng) 根据西南角和东北角两个点构建矩形.方法方法 equals(other:GLatLngBounds) contains(latlng:GLatLng) 返回值 Boolean Boolean (自 2.88 开始不推荐使用) 当且仅当该点的地理坐标位于此矩形内时,返回 true. containsLatLng(latlng:GLatLng) intersects(other:GLatLngBounds) Boolean (自 2.88 开始) Boolean 如名所述. 放大此矩形,使其包含指定的点.沿经线方向的两种可能的放大方式中,按较小的那 种方式放大.如果两者相等,则放大东部的边界. containsBounds(other:GLatLngBounds) Boolean 如名所述. extend(latlng:GLatLng) getSouthWest() getNorthEast() toSpan() isFullLat() None 说明 当且仅当此矩形中的所有参数都等于其他矩形的参数(在一定的舍入范围内)时,返 回 true. 当且仅当该点的地理坐标位于此矩形内时,返回 true.GLatLng 返回矩形西南角的点. GLatLng 返回矩形东北角的点. GLatLng 返回 GLatLng,其坐标表示此矩形的大小. Boolean 如果此矩形从南极延伸到北极,则返回 true.isFullLng() isEmpty() getCenter()Boolean 如果此矩形沿经线方向环绕地球一周,则返回 true. Boolean 如果此矩形为空,则返回 true. 返回矩形的中心点. GLatLng (自 2.52 开始)接口 GControl所有控件都实现此接口.您可以实现此接口,以便为地图提供自定义控件.使用 GMap2.addControl() 方法向地图添加控件. 与叠加层不同(其相对于地图定位),控件相对于地图视图位置而定位,即移动地图时控件不移动.构造函数构造函数 GControl(printable?:Boolean, selectable?:Boolean) 说明 为新控件类创建原型实例.标志 printable 表示控件在地图的打印输出中应可见.标 志 selectable 表示控件包含可选择的文本.方法当使用 GMap2.addControl() 向地图中添加控件时,地图会调用这些方法.因此,您无法调用这些方法,但可以实现这些方法.方法 printable() selectable()返回值 Boolean Boolean 如果可以打印控件,则返回至地图.说明 如果控件包含可选择文本,则返回至地图. 地图将调用该方法,因此控件可自我初始化.该控件将使用 GMap2.getContainer() 方法 获取包含地图的 DOM 元素,并将自己添加到 DOM 元素中.它返回添加的元素. 向地图返回默认情况下控件在地图视图中出现的位置.这会由 GMap2.addControl() 的第 二个参数所覆盖.initialize(map:GMap2) Node getDefaultPosition() GControlPositionGControlPosition 类此类描述了地图视图中控件的位置.它由相对于控件所在位置的角和确定此位置的偏移量组成.它可以作为可选参数 position 传入 方法 GMap2.addControl(),也可以从方法 GControl.getDefaultPosition() 中返回.构造函数构造函数 说明 GControlPosition(anchor:enum GControlAnchor, offset:GSize) 创建控件位置规范.枚举 GControlAnchor常数常数 G_ANCHOR_TOP_RIGHT G_ANCHOR_TOP_LEFT 说明 控件将锚定到地图的右上角. 控件将锚定到地图的左上角.G_ANCHOR_BOTTOM_RIGHT 控件将锚定到地图的右下角. G_ANCHOR_BOTTOM_LEFT 控件将锚定到地图的左下角.GControl 类存在 interface GControl 的实现方法.构造函数构造函数 GSmallMapControl() GLargeMapControl() GSmallZoomControl() GScaleControl() GMapTypeControl() GMenuMapTypeControl() 说明 创建带有可在四个方向平移,放大和缩小的按钮的控件. 创建带有可在四个方向平移,放大,缩小的按钮以及缩放滑块的控件. 创建带有放大和缩小按钮的控件. 创建显示地图比例尺的控件. 创建一个标准地图类型控件,通过按钮在受支持地图类型之间进行选择和切换. 创建一个下拉地图类型控件,在受支持地图类型之间切换.GHierarchicalMapTypeControl() 创建一个&嵌套&地图类型控件,通过按钮和嵌套复选框在受支持地图类型之间进行选择和切换.GOverviewMapControl()在主地图的一角创建可折叠的迷你型概览地图,以便通过拖动提供位置参考和导航. GOverviewMapControl 创建单像素黑边界的概览地图.注意:与其他控件不同,您只能将此控件放 在地图的右下角 (G_ANCHOR_BOTTOM_RIGHT).GMapTypeControl 类GMapTypeControl 提供用于通过按钮在受支持地图类型之间进行选择和切换的控件.必须在构造这些控件时将其设置为可用于当前附 加到地图的所有地图类型. 默认情况下, 地图支持 G_DEFAULT_MAP_TYPES 集合; 地图还可以通过 GMap2.addMapType() 显式地添加地图类型. 为了节省地图空间, 您可以改为使用 GHierarchicalMapTypeControl 显示&嵌套&地图类型或使用 GMenuMapTypeControl 显示下拉地图类型.构造函数构造函数 GMapTypeControl(useShortNames?:Boolean) 说明 如果 GMapTypeControl 设置为 true,就使用短名称创建 useShortNames,默认是使用 长名称.GMenuMapTypeControl 类GMenuMapTypeControl 提供用于通过下拉菜单在受支持地图类型之间进行选择和切换的控件.必须在构造这些控件时将其设置为可用 于当前附加到地图的所有地图类型.默认情况下,地图支持 G_DEFAULT_MAP_TYPES 集合;地图还可以通过 GMap2.addMapType() 显式地添加地图类型.构造函数构造函数 GMenuMapTypeControl(useShortNames?:Boolean) 说明 如果 GMenuMapTypeControl 设置为 true,就使用短名称创建 useShortNames,默 认是使用长名称.GHierarchicalMapTypeControl 类GHierarchicalMapTypeControl 提供通过按钮和嵌套复选框在受支持地图类型之间进行选择和切换的&嵌套&地图类型控件.必须在 构造这些控件时将其设置为可用于当前附加到地图的所有地图类型. 添加到地图中的地图类型显示为如常规 GMapTypeControl 中所示的按钮.但是,设置为其他地图类型子类型的地图类型(参见下面的 addRelationship() 方法)将显示为父按钮下的复选框子菜单项. 默认情况下,地图支持 G_DEFAULT_MAP_TYPES 集合;地图还可以通过 GMap2.addMapType() 显式地添加地图类型.必须在构造这些控 件时将其设置为可用于当前附加到地图的所有地图类型.请注意,因为子类型显示为复选框,您可以使用子菜单中的其父类型或同级 类型对外观进行切换.构造函数构造函数 说明 GHierarchicalMapTypeControl() 构造该控件.默认情况下,G_HYBRID_MAP 地图类型生成一个 G_SATELLITE_MAP 地图类型的子类型.如果不需要,可以通过调用 clearRelationships() 方法删除该关系.方法方法 返回 值 说明addRelationship(parentType:GMapType, childType:GMapType, childText?:String, isDefault?:Boolean)使用该控件在地图类型之间注册父/子关系.如果给出 childText,则 它会显示在该子地图类型(而非名称)复选框的旁边.如果 isDefault 为 true,则默认选择该子地图类型.请注意,在添加控件前必须设置 None 所有关系.(添加控件后再添加关系是无效的.) (自 2.94 开始) 从控件中删除与某个地图类型有关的所有关系.removeRelationship(mapType:GMapType)None (自 2.94 开始) 从控件中删除所有关系.clearRelationships()None (自 2.94 开始)GMapType 类Google 提供部分预定义地图类型 - 此类用于定义自定义地图类型.要在地图中显示地图类型,请使用 GMap2 构造函数或 GMap2.addMapType() 方法.要添加到(而不是整个替换)地图的图块层,另请参阅 GTileLayerOverlay.还可以对此类进行细分.如果构造函数参数实例化为原型,则可省略它.子类构造函数必须使用 call() 调用 GMapType 构造函数.构造函数构造函数 GMapType(layers:GTileLayer[], projection:GProjection, name:String, opts?:GMapTypeOptions) 说明 用指定的图块层,投影,名称和可选参数构造一 个地图类型.方法这些方法多数由此地图类型传递到的目标地图调用,但部分方法可能也从地图外调用,比如 getBoundsZoomLevel(). 方法 getSpanZoomLevel(center:GLatLng, span:GLatLng, viewSize:GSize) getBoundsZoomLevel(bounds:GLatLngBounds, viewSize:GSize) getName(short?:Boolean) getProjection() getTileSize() getTileLayers() 返回值 Number None String 说明 向地图返回缩放级别,由中心和跨度定义的地图部分按这一缩 放级别适合于指定大小(以像素表示)的地图视图. 向地图返回缩放级别,由边界定义的地图部分按这一缩放级别 适合于指定大小(以像素表示)的地图视图. 向地图返回要在 GMapTypeControl 中用作按钮标签的地图类 型名称. 向地图返回此地图类型的地图图块大小(以像素表示).这些 图块的结构假定为二次的.所有图块层的图块大小相同.GProjection 向地图返回此地图类型的投影. NumberGTileLayer[] 向地图返回图块层数组.getMinimumResolution() getMaximumResolution() getTextColor() getLinkColor() getErrorMessage() getCopyrights(bounds:GLatLngBounds, zoom:Number) getUrlArg() getAlt()Number Number String String String String[] String String向地图返回定义此地图类型的最低缩放级别. 向地图返回定义此地图类型的最高缩放级别. 向地图返回地图上覆盖文本的最适用颜色.用于版权控件所显 示的版权消息文本的颜色. 向地图返回地图上覆盖的超链接的最适用颜色.用于版权控件 所显示的使用条款链接的颜色. 向地图返回区域中显示的错误消息,或有关此地图类型无地图 图块处的区域或缩放级别的错误消息. 向地图返回版权消息,该消息适用于由 bounds 描述的指定缩 放级别的地区.这用于地图上的版权消息. 向地图返回一个值,用作当前地图视图的永久链接中识别此地 图类型的网址参数值.目前,这仅由地图应用程序使用. 向地图返回此地图类型的备选文本. (自 2.86 开始)常数常数 G_NORMAL_MAP G_SATELLITE_MAP G_HYBRID_MAP G_PHYSICAL_MAP 该地图类型显示卫星图像. 该地图类型显示卫星图像上的主要街道透明层. 该地图类型显示带有自然特征(如地形和植被)的地图.默认情况下,该地图类型不显示在地图类型控件中. 说明 该地图类型(默认地图类型)显示普通的街道地图.(自 2.94 开始) G_MOON_ELEVATION_MAP 该地图类型显示月球表面按海拔进行彩色编码的带阴影地形地图.默认情况下,该地图类型不显示在地图类型 控件中. (自 2.95 开始) 此地图类型显示来自月球轨道的照片.默认情况下,该地图类型不显示在地图类型控件中. G_MOON_VISIBLE_MAP (自 2.95 开始) G_MARS_ELEVATION_MAP 该地图类型显示火星表面按海拔进行彩色编码的带阴影地形地图.默认情况下,该地图类型不显示在地图类型 控件中. (自 2.95 开始) 此地图类型显示来自火星轨道的照片.默认情况下,该地图类型不显示在地图类型控件中. G_MARS_VISIBLE_MAP (自 2.95 开始) 此地图类型显示火星表面带阴影的红外线地图,其中较热地区以亮色显示,较冷地区以暗色显示. G_MARS_INFRARED_MAP (自 2.95 开始) 该地图类型显示覆盖整个天体的天空拼接. G_SKY_VISIBLE_MAP (自 2.95 开始) G_SATELLITE_3D_MAP 结合 Google 地球浏览器插件,此地图类型可以通过卫星图像显示地球的完全交互式三维模型.默认情况下, 该地图类型不显示在地图类型控件中.如果将此地图类型添加到您的地图,不仅会为 Google 地球地图类型添加控件,还会在点击用户控件后处理该 地图类型的初始化.如果用户当前没有在浏览器中安装 Google 地球插件,则用户第一次选择该地图类型时, 系统会提示该用户下载安装该插件并重新启动浏览器. 对于尚未安装该插件的用户,选择此地图类型会为地图创建 Google 地球实例并显示 Google 地球的三维视 图.您可以使用 GMap2.getEarthInstance() 检索此 Google 地球实例并使用 Google 地球 API 对其进行处 理. 目前,标记,信息窗口和折线都可用于此三维地图类型,但是尚不支持其他功能.我们计划在以后的版本中支 持更多功能. (自 2.113 开始) G_DEFAULT_MAP_TYPES 上述前三种预定义地图类型数组(G_NORMAL_MAP,G_SATELLITE_MAP 和 G_HYBRID_MAP). G_MOON_MAP_TYPES G_MARS_MAP_TYPES G_SKY_MAP_TYPES 上述两种月球类型数组(G_MOON_ELEVATION_MAP 和 G_MOON_VISIBLE_MAP). 上面定义的三种火星地图类型数组 (G_MARS_ELEVATION_MAP, G_MARS_VISIBLE_MAP 和 G_MARS_INFRARED_MAP) . 上面定义的一种天空地图类型数组 (G_SKY_VISIBLE_MAP).事件事件 说明 newcopyright(copyright:GCopyright) 当向此地图类型中所包含的某个图块层的版权集合添加新版权时会触发此事件.GMapTypeOptions 类此类的实例用作 GMapType 构造函数的 opts? 参数.此类不存在构造函数.但是,此类可以实例化为 javascript 对象常量.属性属性 shortName urlArg 类型 说明 String 设置从 GMapType.getName(true) 中返回的地图类型的短名称.默认值与 name 相同. String 设置从 GMapType.getUrlArg() 中返回的地图类型的网址参数.默认值为空字符串.maxResolution Number 设置由 GMapType.getMaximumResolution() 返回的地图类型的最高缩放级别.默认值为所有图块层的最大值. minResolution Number 设置由 GMapType.getMinimumResolution() 返回的地图类型的最低缩放级别.默认值为所有图块层的最小值. tileSize textColor linkColor Number 设置由 GMapType.getTileSize() 返回的图块大小.默认值是 256. String 设置由 GMapType.getTextColor() 返回的文本颜色.默认值是 &black&. String 设置由 GMapType.getLinkColor() 返回的文本颜色.默认值是 &#7777cc&. 对 GMapType.getAlt() 返回的地图类型设置备选文本.默认值为空字符串. alt String (自 2.64 开始) 按传递的 Number(以米表示)设置地图类型的半径.默认值是 6378137,这是地球的赤道半径(以米表示). radius Number (自 2.89 开始)errorMessage String 设置由 GMapType.getErrorMessage() 返回的错误消息.默认值为空字符串.GLayer 类此类可以实例化预定义的&layer&叠加层(包含相关项目的集合).它实现 GOverlay 接口,因此可使用 GMap2.addOverlay() 方法 添加到地图中.构造函数构造函数 GLayer(layerId:String) 说明 使用指定的唯一层 ID 创建层./pub?key=p9pdwsai2hDN-cAocTLhnag 包 含当前受支持的层列表.方法方法 返回值 hide() None show() None 显示之前隐藏的 GLayer. 说明 隐藏此叠加层使之不可见,但保留它在叠加层堆栈中的位置.静态方法方法 返回 值 说明 如果层叠加层隐藏或未使用 GMap2.addOverlay() 方法添加到地图中, 则返回 true. 否则, 返回 false.GLayer.isHidden(layerId:String) None接口 GTileLayer您可以实现此接口,以通过 GMapType 或 GTileLayerOverlay 提供自定义的地图图块层.此接口的实现应使用 GTileLayer 实例作为 原型,因为这样可以为您实现版权处理.构造函数 构造函数构造函数 GTileLayer(copyrights:GCopyrightCollection, minResolution:Number, maxResolution:Number, options?:GTileLayerOptions) 说明 如果构造函数参数实例化为原型,则可省略它.子类构造函数 必须使用 call() 调用此构造函数.可选 options 参数指定 应作为对象常量传递的 GTileLayerOptions 集合.方法地图和此图块层传递到的地图类型会调用这些方法.当实现自定义图块层时,您需要实现标记为抽象的方法. 方法 minResolution() maxResolution() getTileUrl(tile:GPoint, zoom:Number) isPng() getOpacity() getCopyright(bounds:GLatLngBounds, 返回值 说明Number 向地图类型返回此图块层的最低缩放级别. Number 向地图类型返回此图块层的最高缩放级别. String Boolean 抽象.向地图返回地图图块的网址,图块索引由 GPoint 的 x 和 y 属性在指 定的缩放级别提供. 抽象.向地图返回图块的图像格式是否为 PNG,以及是否因此可能为透明的. 否则,假定是 GIF.Number 抽象. 向地图返回显示此图块层所用的不透明度. 1.0 为不透明, 0.0 为透明. String 抽象.向地图返回此图块层的版权消息,这与指定缩放级别的指定地图地区有zoom:Number)关.这用于生成此图块层所属的 GMapType 的版权消息. (自 2.89 开始)事件事件 说明 newcopyright(copyright:GCopyright) 当向此图块层的版权集合添加新版权时会触发此事件.GTileLayerOptions 类此类代表 GTileLayer 接口的可选参数.它没有构造函数,但可实例化为对象常量.属性属性 opacity isPng 类型 Boolean 指明图块的格式是否为 PNG. 说明 Number 设置图块的不透明度,范围是 0.0(不可见)到 1.0(不透明).默认值为 1.0.指定图块网址模板,该模板可以针对每个图块请求而展开,以根据现有的图块坐标系引用唯一的图块.将模 板置于 GTileLayer 构造函数中可允许您使用此坐标系动态检索图块, 检索方式类似于 Google 地图检索图 tileUrlTemplate String 块的方式. 模板的格式应该为:http://host/tile?x={X}&y={Y}&z={Z}.png ,其中 X 和 Y 分别指纬度和经度图块坐标,Z 指缩放级别,比如 http://host/tile?x=3&y=27&z=5.png. 拖动地图时显示的光标. draggingCursor String (自 2.59 开始)GTileLayerOverlay 类GTileLayerOverlay 通过 GTileLayer 放大地图.它实现 GOverlay 接口,因此可使用 GMap2.addOverlay() 方法添加到地图中.在 现有的地图图像之上显示 GTileLayer,以替换该图像,将 GTileLayer 放置于自定义的 GMapType 中.构造函数构造函数 GTileLayerOverlay(tileLayer:GTileLayer, opts?:GTileLayerOverlayOptions) (自 2.61 开始) 说明 创建封装 GOverlay 的 tileLayer.方法方法 hide() 返回值 None 说明 隐藏此叠加层使之不可见,但保留它在叠加层堆栈中的位置.(自 2.71 开始) 如果图块层叠加层不可见,则返回 true.否则,返回 false. isHidden() None (自 2.87 开始) 显示先前不可见的 GTileLayerOverlay. show() None (自 2.71 开始) 重新加载所有添加到此 GTileLayerOverlay 的可见图块. refresh() None (自 2.132 开始) 总是返回 true. supportsHide() None (自 2.87 开始) 返回此叠加层所使用的图块层. getTileLayer() None (自 2.83 开始)GTileLayerOverlayOptions GTileLayerOverlayOptions 类此类代表 GTileLayerOverlayOptions 构造函数的可选参数.它没有构造函数,但可实例化为对象常量.属性属性类型说明 zPriority 包含确定此 TileLayerOverlay 的相对 z 顺序的值. 优