Google地图使用API.doc

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 GPolyEditingOptions GPolyStyleOptions GPolygon GPolygonOptions GScreenOverlay GScreenPoint GScreenSize GGroundOverlay GIcon GPoint GSize GBounds GLatLng GLatLngBounds GControl GTileLayerOptions GTileLayerOverlayOptions GEvent GEventListener GXmlHttp GXml GXslt GLog GDraggableObject GDraggableObjectOptions GGeoStatusCode GGeoAddressAccuracy GClientGeocoder GGeocodeCache GFactualGeocodeCache GMarkerManager GMarkerManagerOptions GGeoXml GDownloadUrl GBrowserIsCompatible GDirections GDirectionsOptions GTravelModes GRoute GStep GTrafficOverlay GTrafficOverlayOptions GAdsManager GAdsManagerOptions 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() None启用地图拖动（默认情况下启用）。disableDragging() None禁用地图拖动。draggingEnabled() Boolean当且仅当启用了地图拖动时，返回 true。enableInfoWindow() None启用地图上的信息窗口操作（默认情况下启用）。disableInfoWindow() None如果信息窗口处于打开状态，请关闭它并禁用打开新信息窗口。infoWindowEnabled() Boolean当且仅当启用了信息窗口时，返回 true。enableDoubleClickZoom() None启用双击缩放地图（默认情况下启用）。 （自 2.58 开始）disableDoubleClickZoom() None禁用双击缩放地图。 （自 2.58 开始）doubleClickZoomEnabled() Boolean当且仅当启用了双击缩放地图时，返回 true。 （自 2.58 开始）enableContinuousZoom() None启用选择浏览器的连续平滑缩放（默认情况下禁用）。 （自 2.58 开始）disableContinuousZoom() None禁用连续平滑缩放。 （自 2.58 开始）continuousZoomEnabled() Boolean如果启用了连续平滑缩放，则返回 true。 （自 2.58 开始）enableGoogleBar() None为地图启用集成搜索控件 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) None将控件添加到地图。地图上的位置由可选的 position 参数确定。如果此参数不存在，则使用由 GControl.getDefaultPosition() 方法确定的控件默认位置。一个控件实例只能向地图中添加一次。removeControl(control:GControl) None从地图中删除控件。如果控件从未被添加到地图中，则该删除不起任何作用。getContainer() Node返回包含地图的 DOM 对象。由 GControl.initialize() 使用。地图类型方法返回值说明getMapTypes() GMapType返回在此地图中注册的地图类型数组。getCurrentMapType() GMapType返回当前选中的地图类型。setMapType(type:GMapType) None选择指定的新地图类型。类型必须是地图已知的类型。请参见构造函数和方法 addMapType()。addMapType(type:GMapType) None将新地图类型添加到地图中。有关怎样定义自定义地图类型的信息，请参见 GMapType 部分。removeMapType(type:GMapType) None从地图中删除地图类型。会更新由 GMapTypeControl 或 GHierarchicalMapTypeControl 显示的按钮集并触发 removemaptype 事件。地图状态方法返回值说明isLoaded() Boolean当且仅当地图在创建后使用 setCenter() 进行初始化时，返回 true。getCenter() GLatLng返回地图视图中心点的地理坐标。getBounds() GLatLngBounds返回地图视图的可视矩形区域（以地理坐标表示）。getBoundsZoomLevel(bounds:GLatLngBounds) Number返回指定矩形区域在地图视图中的缩放级别。缩放级别要按当前选中的地图类型计算。如果还未选择地图类型，将使用地图类型列表中列出的第一个类型。getSize() GSize返回地图视图的大小（以像素表示）。getZoom() Number返回当前的缩放级别。getDragObject() GDraggableObject返回此地图使用的可拖放对象。 （自 2.93 开始）getEarthInstance(callback:Function(instance: GEPlugin) None检索附加到此地图的 Google 地球浏览器插件的实例，并在该实例准备好接收命令时调用传递的回调函数，从而将地球实例（GEPlugin 对象）作为参数传递。如果 Google 地球实例以前已通过设置 Google 地球地图类型（通过 GMap2.setMapType(G_SATELLITE_3D_MAP)）进行了实例化，可能会立即触发该回调函数。如果实例尚未创建，调用 getEarthInstance 会初始化 Google 地球插件。（这种异步行为就是该方法需要回调的原因。）注意：如果初始化遇到错误，回调函数将传递 null 参数。请注意，尽管该方法会创建 Google 地球实例，但不会将 Google 地球地图类型设置为当前视图。要执行此操作，请显式地调用 GMap2.setMapType(G_SATELLITE_3D_MAP)，或让用户通过 MapTypeControl 选择此地图类型。请参见 Google 地球 API 开发人员指南，以获取有关怎样使用 GEPlugin 对象的详细信息。 （自 2.113 开始）修改地图状态方法返回值说明setCenter(center:GLatLng, zoom?:Number, type?:GMapType) None按指定的中心设置地图视图。也可以同时设置缩放级别和地图类型。地图类型必须是地图已知的类型。请参见构造函数和方法 addMapType()。必须在构造后先调用此方法，才能设置地图的初始状态。在调用此函数之前调用对新构造的 GMap2 对象执行的操作，这是错误的。 panTo(center:GLatLng) None将地图的中心点更改为指定的点。如果该点已经在当前的地图视图中可见，则会以平滑动画的方式移动中心点。panBy(distance:GSize) None以动画方式平移指定的距离（以像素为单位）。panDirection(dx:one of -1 0 +1, dy:one of -1 0 +1) None以动画方式向指示方向平移地图宽度的一半。+1 是向右向下，-1 是向左向上。setZoom(level:Number) None将缩放级别设置为指定的新值。zoomIn() None将缩放级别加 1。zoomOut() None将缩放级别减 1。savePosition() None存储当前的地图位置和缩放级别，以便以后用 returnToSavedPosition() 重新调用。returnToSavedPosition() None恢复用 savePosition() 保存的地图视图。checkResize() None通知地图其容器大小已更改。在更改了容器 DOM 对象的大小后调用此方法，以便地图能够调整自己适合于新的大小。叠加层方法返回值说明addOverlay(overlay:GOverlay) None将叠加层添加到地图中，并触发 addoverlay 事件。removeOverlay(overlay:GOverlay) None从地图中删除叠加层。尝试删除不在地图上的叠加层是错误的。如果调用成功，会触发 removeoverlay 事件。clearOverlays() None从地图中删除所有叠加层，并触发 clearoverlays 事件。getPane(pane:GMapPane) Node返回层中包含 pane 识别的对象的 DIV。由 GOverlay 实例用于方法 GOverlay.initialize() 的实例中，以在地图上绘制它们自身。信息窗口方法返回值说明openInfoWindow(latlng:GLatLng, node:Node, opts?:GInfoWindowOptions) None在指定点处打开一个简单的信息窗口。平移地图，使得打开的信息窗口完全可见。信息窗口的内容为 DOM 节点。openInfoWindowHtml(latlng:GLatLng, html:String, opts?:GInfoWindowOptions) None在指定点处打开一个简单的信息窗口。平移地图，使得打开的信息窗口完全可见。信息窗口的内容为 HTML 文本。openInfoWindowTabs(latlng:GLatLng, tabs:GInfoWindowTab, opts?:GinfoWindowOptions) None在指定点处打开一个带标签的信息窗口。平移地图，使得打开的信息窗口完全可见。信息窗口的内容为 DOM 节点。openInfoWindowTabsHtml(latlng:GLatLng, tabs:GInfoWindowTab, opts?:GInfoWindowOptions) None在指定点处打开一个带标签的信息窗口。平移地图，使得打开的信息窗口完全可见。信息窗口的内容为 HTML 文本。showMapBlowup(latlng:GLatLng, opts?:GInfoWindowOptions) None在指定的点打开信息窗口，它包含地图上该点附近的近景视图。updateInfoWindow(tabs:GInfoWindowTab, onupdate?:Function) None更新当前打开的 GInfoWindow 对象的内容，而不重新放置。信息窗口的大小将被调整，以便与新内容相符。对信息窗口内容实际进行更改后，将调用可选的 onupdate 回调函数。 （自 2.85 开始）updateCurrentTab(modifier:Function, onupdate?:Function) None会更新当前选中的标签，从而调整 GInfoWindow 对象的大小，而不重新放置。modifier 函数用于修改当前选中的标签并将 GInfoWindowTab 作为参数传递。在信息窗口显示新内容后，调用可选的 onupdate 回调函数。 （自 2.85 开始）closeInfoWindow() None关闭当前打开的信息窗口。getInfoWindow() GInfoWindow返回此地图的信息窗口对象。如果还没有信息窗口，会创建一个，但该窗口不显示。此操作不受 enableInfoWindow() 影响。坐标变换方法返回值说明fromContainerPixelToLatLng(pixel:GPoint) GLatLng在含有页面地图的 DOM 元素中计算指定像素坐标点的地理坐标。此方法有助于实现自定义控件与地图的交互。fromLatLngToContainerPixel(latlng:GLatLng) GPoint在包含该页面地图的 DOM 元素中计算指定的地理位置的像素坐标。 （自 2.100 开始）fromLatLngToDivPixel(latlng:GLatLng) GPoint计算指定地理位置在含有可拖动地图的 DOM 元素中的像素坐标。为自定义叠加层实现 GOverlay.redraw() 方法时，需要用此方法定位自定义叠加层。fromDivPixelToLatLng(pixel:GPoint) GLatLng根据含有可拖动地图的 div 中的像素坐标计算地理坐标。此方法可能有助于实现与不扩展 GOverlay 接口的自定义叠加层的交互。如果此方法没有给出预期输出，请尝试使用 fromContainerPixelToLatLng 方法。事件事件说明addmaptype(type:GMapType) 向地图中添加地图类型时会触发此事件。removemaptype(type:GMapType) 从地图中删除地图类型时会触发此事件。click(overlay:GOverlay, latlng:GLatLng, overlaylatlng:GLatLng) 用户用鼠标点击地图时会触发此事件。根据所点击的环境的不同以及是否点击了可点击的叠加层，click 事件会传递不同的参数。如果点击的不是可点击叠加层，overlay 参数为 null 并且 latlng 参数包含点击点的地理坐标。如果点击的是clickable叠加层（如 GMarker、GPolygon、GPolyline 或 GInfoWindow），overlay 参数包含叠加层对象，而 overlaylatlng 参数会包含所点击叠加层的坐标。另外，还会在该叠加层自身上触发 click 事件。 dblclick(overlay:GOverlay, latlng:GLatLng) 双击地图时会触发此事件。注意，双击标记或其他可点击叠加层时不触发此事件。被双击的点的地理坐标将被传递到 latlng 参数中。overlay 参数始终设置为 null。 （自 2.83 开始）singlerightclick(point:GPoint, src:Element, overlay?:GOverlay) 在地图容器中触发 DOM contextmenu 事件时会触发此事件。如果右键点击某个标记或其他可点击叠加层，则该叠加层会传递到 overlay 参数的事件处理程序中。右键点击的这一点的像素坐标（在包含地图的 DOM 元素中）和 DOM 事件的源元素会分别传递到 point 和 src 参数中。注意，如果在启用了双击缩放的情况下进行右键双击，那么，地图会缩小，并且不触发 singlerightclick 事件。但是，如果禁用了双击缩放，会触发两个 singlerightclick 事件。 （自 2.84 开始）movestart() 地图视图开始更改时会触发此事件。执行拖动操作时或调用更改地图视图的方法时也会触发此事件，前者还同时触发 dragstart 事件。move() 更改地图视图时会触发此事件，并且可能是重复触发。moveend() 结束地图视图的更改时会触发此事件。zoomend(oldLevel:Number, newLevel:Number) 地图到达新的缩放级别时会触发此事件。事件处理程序接收先前的缩放级别和新缩放级别作为参数。maptypechanged() 选择另一地图类型时会触发此事件。infowindowopen() 打开信息窗口时会触发此事件。infowindowbeforeclose() 关闭信息窗口前会触发此事件。 （自 2.83 开始）infowindowclose() 关闭信息窗口时会触发此事件。此事件在触发前会触发 infowindowbeforeclose 事件。如果通过再次调用 openInfoWindow*() 在其他点重新打开当前已打开的信息窗口，则会先后触发 infowindowbeforeclose、infowindowclose 和 infowindowopen 事件。addoverlay(overlay:GOverlay) 当使用 addOverlay() 方法向地图中添加单个叠加层时会触发此事件。新的叠加层会作为参数 overlay 传递到事件处理程序中。removeoverlay(overlay:GOverlay) 当使用 removeOverlay() 方法删除单个叠加层时会触发此事件。删除的叠加层会作为参数 overlay 传递到事件处理程序中。clearoverlays() 当使用 clearOverlays() 方法一次性删除全部叠加层时会触发此事件。mouseover(latlng:GLatLng) 当用户将鼠标从地图外移动到地图上时会触发此事件。mouseout(latlng:GLatLng) 当用户将鼠标移离地图时会触发此事件。mousemove(latlng:GLatLng) 当用户在地图中移动鼠标时会触发此事件。dragstart() 当用户开始拖动地图时会触发此事件。drag() 当用户拖动地图时会重复触发此事件。dragend() 当用户停止拖动地图时会触发此事件。load() 当完成地图设置时会触发此事件，并且 isLoaded() 会返回 true。这表示位置、缩放和地图类型都已完成初始化，但可能还在载入图块。 （自 2.52 开始）GMapOptions 类此类代表 GMap2 构造函数的可选参数。它没有构造函数，但可实例化为对象常量。属性属性类型说明size GSize以像素为单位设置地图大小。传递到地图构造函数的容器会调整为指定大小。默认情况下，地图会采用其容器的大小。mapTypes GMapType此地图要使用的地图类型数组。默认情况下使用 G_DEFAULT_MAP_TYPES。使用此选项可以限制地图中显示的预定义地图类型集合，或者将自有的地图类型传递到地图中。另请参见 GMap2.addMapType()。draggableCursor String地图可拖动时显示的光标。 （自 2.59 开始）draggingCursor String拖动地图时显示的光标。 （自 2.59 开始）googleBarOptions GGoogleBarOptions该属性指定配置 GGoogleBar 搜索控件的选项。当构造地图时，会将这些选项传递到 GMapOptions 对象常量，当调用 GMap2.enableGoogleBar() 时，会使用这些选项构造本地 GGoogleBar 控件。 （自 2.95 开始）backgroundColor String该属性指定地图图块后要显示的颜色。该颜色可以是任何有效的 W3C 标准颜色值。 （自 2.119 开始）GGoogleBarOptions 类此类表示在 googleBarOptions 参数中传递到 GMapOptions 对象的选项。它没有构造函数，但可实例化为对象常量。请注意，与 GInfoWindow 一样，GGoogleBar 对象不会被构造，但是会自动添加到地图对象中，并通过此处描述的属性启用。属性属性类型说明showOnLoad Boolean当设置为 true 时，该属性显示 GoogleBar 中的搜索框（如果启用了控件并加载了地图）。默认情况下，控件中的搜索框是隐藏的，只有当点击该控件的放大镜时才会展开。 （自 2.95 开始）linkTarget GGoogleBarLinkTarget该属性允许指定嵌入 GoogleBar 的搜索结果中的链接目标。默认值为 G_GOOGLEBAR_LINK_TARGET_BLANK，该默认值指定这些链接将在新窗口中打开。 （自 2.95 开始）resultList GGoogleBarResultList or Element该属性可让您指定 GoogleBar 的搜索结果列表的样式，该样式可能为以下样式的一种：G_GOOGLEBAR_RESULT_LIST_INLINE（默认样式）将结果列表放入搜索框上的表中；G_GOOGLEBAR_RESULT_LIST_SUPPRESS 使用“下一个”/“上一个”按钮替换该列表；传递块级别的 DOM 的 Element 将列表放入您选择的容器（通常为 元素）中。 （自 2.95 开始）suppressInitialResultSelection Boolean系统完成 GoogleBar 中的搜索后就会在其信息窗口中显示第一个结果（这是默认行为），该属性抑制这种行为。 （自 2.95 开始）suppressZoomToBounds Boolean该属性还抑制完成 GoogleBar 中的搜索后自动平移和缩放以适合结果集的操作。（该属性抑制默认行为。） （自 2.95 开始）onIdleCallback Function该属性指定 GoogleBar 完成搜索且搜索结果关闭时要调用的回调函数。 （自 2.95 开始）onSearchCompleteCallback Function该属性指定 GoogleBar 完成搜索且搜索结果完全显示时要调用的回调函数向该函数传递与搜索控件相关的 GlocalSearch 对象。在结果放到地图上或结果列表中之前调用该回调函数。 （自 2.95 开始）onGenerateMarkerHtmlCallback Function此属性可让您指定打开搜索结果标记的信息窗口时要调用的回调函数。应该向该函数先后传递 GMarker、生成的 HTML 字符串和 GlocalSearchResult，并且该函数必须返回要显示在信息窗口中的已修改 HTML 字符串。 （自 2.95 开始）onMarkersSetCallback Function该属性可让您指定 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 等同于 target = _self。G_GOOGLEBAR_LINK_TARGET_TOP 等同于 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 该窗格是 z 顺序最低的窗格，在图块之上。G_MAP_OVERLAY_LAYER_PANE 该窗格包含折线、多边形、底面叠加层和图块叠加层。 （自 2.127 开始）G_MAP_MARKER_SHADOW_PANE 该窗格包含标记阴影。G_MAP_MARKER_PANE 该窗格包含标记前景图。G_MAP_FLOAT_SHADOW_PANE 该窗格包含信息窗口阴影。它在 G_MAP_MARKER_PANE 之上，使得标记可以位于信息窗口的阴影中。G_MAP_MARKER_MOUSE_TARGET_PANE 此窗格包含透明元素，可为标记接收 DOM 鼠标事件。它在 G_MAP_FLOAT_SHADOW_PANE 之上，以便可以点击信息窗口阴影中的标记。G_MAP_FLOAT_PANE 此窗格包含信息窗口。它在所有地图叠加层之上。GKeyboardHandler 类对此类进行实例化，以便向地图中添加键盘绑定。该键盘绑定类似于地图应用程序的键盘绑定。键操作向上箭头键，向下箭头键，向左箭头键，向右箭头键按下这些键时可连续移动地图。同时按下其中两个键可对角移动。page down 键，page up 键，home 键，end 键以相应方向将地图平移其 3/4 大小，以漂亮的动画显示。其作用等同于 GLargeMapControl 和 GsmallMapControl 中的箭头按钮。+，-分别放大或缩小一个级别。其作用等同于 GLargeMapControl 和 GsmallMapControl 中的 + 和 - 按钮。构造函数构造函数说明GKeyboardHandler(map:GMap2) 为作为参数传递的地图安装键盘事件处理程序。接口 GOverlay地图 API 库中的 GMarker、GPolyline、GTileLayerOverlay 和 GInfoWindow 类都是通过此接口实现的。如果希望在地图上显示自定义的叠加层对象类型，可以实现这一功能。可使用 GMap2.addOverlay() 方法将 GOverlay 的实例放置于地图上。然后，地图在叠加层实例上调用 GOverlay.initialize() 方法，先将自己显示在地图上。每当地图显示更改时，地图都会调用 GOverlay.redraw()，这样叠加层就可以在需要时对自己进行重新放置。叠加层实例可使用方法 GMap2.getPane() 获取一个或多个自己要附加的 DOM 容器元素。构造函数构造函数说明GOverlay() 此构造函数为这些方法创建哑元实现。尽管如此，当有继承自此类的派生类时，派生类的构造函数会调用此构造函数以完成实现。静态方法方法返回值说明GOverlay.getZIndex(latitude:Number) Number返回指定纬度的 CSS z-index 值。它计算 z 索引，使靠南的叠加层在靠北的叠加层之上，从而创建标记叠加层的三维外观。抽象方法方法返回值说明initialize(map:GMap2) None使用 GMap2.addOverlay() 向地图中添加叠加层后，由地图调用此方法。叠加层对象可以将其本身拖到地图的各个窗格中，这些窗格可使用 GMap2.getPane() 获取。remove() None使用 GMap2.removeOverlay() 或 GMap2.clearOverlays() 从地图中删除叠加层后，由地图调用此方法。此时，叠加层必须将自己从地图窗格中删除copy() GOverlay返回叠加层的未初始化副本，可添加到地图中。redraw(force:Boolean) None此方法在地图显示更改后由地图调用。如果更改了地图视图的缩放级别或像素偏移量，则参数 force 将为 true，这样需要重新计算像素坐标。GInfoWindow 类GInfoWindow 没有构造函数。它是由地图创建的，可使用 GMap2.getInfoWindow() 方法访问。方法方法返回值说明selectTab(index:Number) None选择指定索引对应的标签。它的效果等同于点击相应标签。hide() None隐藏信息窗口。注意：这不会关闭信息窗口。使用 show() 可重新显示信息窗口。show() None如果信息窗口当前处于隐藏状态，则可显示信息窗口。isHidden() Boolean当且仅当信息窗口处于隐藏状态时，返回 true。这包括关闭状态。reset(latlng:GLatLng, tabs:GInfoWindowTab, size:GSize, offset?:GSize, selectedTab?:Number) None重置信息窗口的状态。每个参数都可能为 null，因此其值仍将保持为当前值。getPoint() GLatLng返回信息窗口锚定位置的地理坐标。窗口的箭头指向地图中的该点（对像素偏移取整）。getPixelOffset() GSize返回信息窗口的箭头距离信息窗口在地图上所锚定的地理坐标点的像素偏移量。getSelectedTab() Number返回当前选定的标签的索引（从 0 开始）。getTabs() GInfoWindowTabs返回此信息窗口的标签数组。 （自 2.59 开始）getContentContainers() Node返回包含此信息窗口的标签内容的 DOM 节点数组。 （自 2.59 开始）enableMaximize() None启用信息窗口最大化。可最大化的信息窗口会展开，使用通过 GInfoWindowOptions 的 maxContent 和 maxTitle 属性指定的内容填充大部分地图。必须使用 maxContent 或 maxTitle 选项打开信息窗口，enableMaximize() 或 disableMaximize 才能生效。默认情况下，使用 maxContent 或 maxTitle 打开的信息窗口会启用最大化。 （自 2.93 开始）disableMaximize() None禁用信息窗口最大化。必须使用 maxContent 或 maxTitle 选项打开信息窗口。注意，如果信息窗口当前是打开的，则此函数会移除最大化按钮，但不会将该窗口恢复为最小化状态。 （自 2.93 开始）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 Number选择指定索引（从 0 开始）对应的标签，而不是索引 0 对应的第一个标签。maxWidth Number信息窗口内容的最大宽度（以像素表示）。noCloseOnClick Boolean表明点击地图（未点中标记）时是否应关闭信息窗口。如果设置为 true，则在点击地图时不关闭信息窗口。默认值为 false。 （自 2.83 开始）onOpenFn Function打开信息窗口并显示内容后调用函数。onCloseFn Function关闭信息窗口时调用函数。zoomLevel Number仅限于 showMapBlowup()。信息窗口中放大地图的缩放级别。mapType GMapType仅限于 showMapBlowup()。信息窗口中放大地图的地图类型。maxContent String指定最大化信息窗口时要显示的内容。该内容可以为 HTML 字符串或 HTML DOM 元素。 （自 2.93 开始）maxTitle String指定最大化信息窗口时要显示的标题。该内容可以为 HTML 字符