呼伦贝尔旅游包车网站咋做,海南网站建设及维护,渠道网恋,wordpress图片翻页杨航收集技术资料#xff0c;分享给大家 Google 地图 API 参考 Google 地图 API 现在与 Google AJAX API 载入器集成#xff0c;后者创建了一个公共命名空间#xff0c;以便载入和使用多个 Google AJAX API。该框架可让您将可选 google.maps.* 命名空间用于当前在 Google … 杨航收集技术资料分享给大家 Google 地图 API 参考 Google 地图 API 现在与 Google AJAX API 载入器集成后者创建了一个公共命名空间以便载入和使用多个 Google AJAX API。该框架可让您将可选 google.maps.* 命名空间用于当前在 Google 地图 API 中使用的所有类、方法和属性使用此命名空间替换常规 G 前缀。不要担心现有G 命名空间仍能得到支持。 例如Google 地图 API 中的 GMap2 对象还可以定义为 google.maps.Map2。 请注意此参考文档仅指现有 G 命名空间。 如果只是要使用地图显示内容则需要了解以下类、类型和函数 GMap2GMapOptionsGGoogleBarOptionsGInfoWindowGInfoWindowTabGInfoWindowOptionsGMarkerGMarkerOptionsGPolylineGPolylineOptionsGPolyEditingOptionsGPolyStyleOptionsGPolygonGPolygonOptionsGScreenOverlayGScreenPointGScreenSizeGGroundOverlayGIconGPointGSizeGBounds GLatLngGLatLngBoundsGControlGTileLayerOptionsGTileLayerOverlayOptionsGEventGEventListenerGXmlHttpGXmlGXsltGLogGDraggableObjectGDraggableObjectOptionsGGeoStatusCodeGGeoAddressAccuracyGClientGeocoderGGeocodeCacheGFactualGeocodeCacheGMarkerManagerGMarkerManagerOptionsGGeoXmlGDownloadUrl GBrowserIsCompatibleGDirectionsGDirectionsOptionsGTravelModesGRouteGStepGTrafficOverlayGTrafficOverlayOptionsGAdsManagerGAdsManagerOptionsGStreetviewPanoramaGStreetviewPanoramaOptionsGStreetviewOverlayGStreetviewClientGStreetviewClient.ReturnValuesGStreetviewDataGStreetviewLocationGStreetviewLinkGPovGStreetviewPanorama.ErrorValues 如果您要通过实现自己的控件、叠加层或地图类型来扩展地图 API 的功能则还需要了解以下类和类型 GGoogleBarListingTypesGGoogleBarLinkTargetGGoogleBarResultListGMapPaneGOverlayGControlGControlPosition GControlAnchorGMapTypeControlGMenuMapTypeControlGHierarchicalMapTypeControlGMapTypeGMapTypeOptionsGLayer GTileLayerGTileLayerOverlayGCopyrightCollectionGCopyrightGProjectionGMercatorProjection 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 部分。GMapTyperemoveMapType(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 或 GInfoWindowoverlay 参数包含叠加层对象而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 将列表放入您选择的容器通常为 div 元素中。 自 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 字符串或 HTML DOM 元素。 自 2.93 开始 pixelOffset GSize指定要在向上 (x) 方向和向右 (y) 方向从指定的 GLatLng 移动信息窗口所移动的像素数。 自 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)None通过标记图标打开地图信息窗口。信息窗口的内容为 DOM 节点。只适用于 GInfoWindowOptions.maxWidth 选项。openInfoWindowHtml(content:String, opts?:GInfoWindowOptions)None通过标记图标打开地图信息窗口。信息窗口的内容为包含 HTML 文本的字符串。只适用于 GInfoWindowOptions.maxWidth 选项。openInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)None通过标记图标打开带标签的地图信息窗口。信息窗口的内容为标签数组这些标签包含 DOM 节点形式的标签内容。只适用于 GInfoWindowOptions.maxWidth 和InfoWindowOptions.selectedTab 选项。openInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)None通过标记图标打开带标签的地图信息窗口。信息窗口的内容为标签数组这些标签所包含的标签内容是包含 HTML 文本的字符串。只适用于InfoWindowOptions.maxWidth 和 InfoWindowOptions.selectedTab 选项。bindInfoWindow(content:Node, opts?:GInfoWindowOptions)None将指定的 DOM 节点绑定到此标记。当点击标记时此节点中的内容会自动显示在信息窗口中。将 null 作为content 传递来解除绑定。 自 2.85 开始 bindInfoWindowHtml(content:String, opts?:GInfoWindowOptions)None将指定的 HTML 绑定到此标记。当点击标记时HTML 内容将自动显示在信息窗口中。将 null 作为 content 传递来解除绑定。 自 2.85 开始 bindInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)None将指定的 GInfoWindowTab作为 DOM 节点提供绑定到此标记。当点击标记时这些标签节点中的内容会自动显示在信息窗口中。将null 作为 tabs 传递来解除绑定。 自 2.85 开始 bindInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)None将指定的 GInfoWindowTab作为 HTML 字符串提供绑定到此标记。当点击标记时这些标签中的 HTML 内容会自动显示在信息窗口中。将null 作为 tabs 传递来解除绑定。 自 2.85 开始 closeInfoWindow() None仅关闭属于此标记的信息窗口。 自 2.85 开始 showMapBlowup(opts?:GInfoWindowOptions)None通过标记图标打开地图信息窗口。信息窗口的内容是标记位置周围的近景地图。只适用于 InfoWindowOptions.zoomLevel 和InfoWindowOptions.mapType 选项。getIcon() GIcon根据构造函数的设置返回此标记的 icon。getTitle() String根据构造函数通过 GMarkerOptions.title 属性的设置返回此标记的标题。如果未传入标题则返回“undefined”。 自 2.85 开始 getPoint() GLatLng根据构造函数或 setPoint() 的设置返回此标记锚定的地理坐标。 自 2.88 开始不推荐使用 getLatLng() GLatLng根据构造函数或 setLatLng() 的设置返回此标记锚定的地理坐标。 自 2.88 开始 setPoint(latlng:GLatLng)None设置此标记的锚定点的地理坐标。 自 2.88 开始不推荐使用 setLatLng(latlng:GLatLng)None设置此标记的锚定点的地理坐标。 自 2.88 开始 enableDragging() None允许在地图上拖放标记。该方法只有在已经用 GMarkerOptions.draggable true 初始化标记的情况下才生效。disableDragging() None禁止在地图上拖放标记。draggable() Boolean如果已使用 GMarkerOptions.draggable true 通过构造函数对标记进行了初始化则返回true。否则返回 false。draggingEnabled() Boolean如果当前允许用户在地图中拖动标记则返回 true。setImage(url:String) None请求将 url 指定的图像设置为此标记的前景图。注意不调整打印图像和阴影图像。因此此方法主要是为了达到高亮显示或变暗显示效果而不是彻底改变标记的外观。 自 2.75 开始 hide() None如果当前标记可见则隐藏标记。注意如果当前标记可见则此函数会触发 GMarker.visibilitychanged 事件。 自 2.77 开始 show() None如果当前标记不可见则显示标记。请注意如果当前标记不可见则此函数会触发 GMarker.visibilitychanged 事件。 自 2.77 开始 isHidden() Boolean如果当前标记不可见则返回 true。否则返回 false。 自 2.77 开始 事件 只有当标记处于活动状态时才会触发上述所有事件请参见构造函数。 事件说明click(latlng:GLatLng)点击标记图标时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。请注意同时还会使地图触发此事件将标记作为第一个参数传递到那里的事件处理程序中。dblclick(latlng:GLatLng)双击标记图标时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。请注意不会使地图触发此事件因为地图双击时居中是固定行为。mousedown(latlng:GLatLng)在标记图标上触发 DOM mousedown 事件时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。请注意标记会停止 mousedown DOM 事件这样就不会导致地图开始拖动。mouseup(latlng:GLatLng)在标记上触发 DOM mouseup 事件时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。请注意标记不会停止 mousedown DOM 事件因为它不会干扰地图的拖动处理程序。mouseover(latlng:GLatLng)当鼠标进入标记图标区域时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。mouseout(latlng:GLatLng)当鼠标离开标记图标区域时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。infowindowopen() 当通过此标记打开地图的信息窗口时会触发此事件。infowindowbeforeclose() 关闭通过此标记打开的地图信息窗口前会触发此事件。 自 2.83 开始 infowindowclose() 关闭通过此标记打开的地图信息窗口时会触发此事件。关闭信息窗口或在其他标记或在地图上打开信息窗口时都会触发此事件。此事件在触发前会触发 infowindowbeforeclose 事件。remove() 使用 GMap2.removeOverlay() 或GMap2.clearOverlays() 从地图删除标记时会触发此事件。dragstart(latlng:GLatLng)如果启用了标记的拖动操作则在开始拖动标记时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。drag(latlng:GLatLng)如果启用了标记的拖动操作则在拖动标记的过程中会触发此事件从而通过其 latlng 参数传入标记的当前坐标。dragend(latlng:GLatLng)如果启用了标记的拖动操作则在停止拖动标记时会触发此事件从而通过其 latlng 参数传入标记的当前坐标。visibilitychanged(isVisible:Boolean)当标记的可见性发生更改时会触发此事件即可见性从可见更改为隐藏时或从隐藏更改为可见时。isVisible 指发生可见性更改后标记的状态。 自 2.77 开始 GMarkerOptions 类 此类的实例可用于 GMarker 类构造函数的opts? 参数中。此类不存在构造函数。但是此类可以实例化为 javascript 对象常量。 属性 正如此类的名称所指明的一样所有属性都是可选的。 属性类型说明icon GIcon为此类选择图标。如果未指定则使用 G_DEFAULT_ICON。 自 2.50 开始 dragCrossMove Boolean正常拖动标记时标记将浮起并离开光标。将此值设置为 true 可以保持标记位于光标的下面用十字光标下移代替标记浮起。此选项的默认值为false。 自 2.63 开始 title String此字符串显示为标记的工具提示也就是它的作用等同于 HTML 元素中的 title 属性。 自 2.50 开始 clickable Boolean切换以选择标记是否可点击。不可点击或拖动的标记是不活动的它消耗的资源较少但不对任何事件做出响应。此选项的默认值为 true即如果未指定该选项则标记为可点击的。 自 2.50 开始 draggable Boolean切换以选择用户是否可拖动标记。设置为可拖动的标记比设置为可点击的标记所需的资源更多。可拖动的标记同时也是可点击的标记默认情况下启用弹跳效果和自动平移。此选项的默认值为false。 自 2.61 开始 bouncy Boolean切换拖动完标记后是否应上下弹动。此选项的默认值为 false。 自 2.61 开始 bounceGravity Number此数字用于定义完成拖动操作时标记在弹到地面期间的加速度。此选项的默认值为 1。 自 2.61 开始 autoPan Boolean将标记拖到边缘时自动平移地图。如果标记是可拖动的则此选项的默认值为 true。 自 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 之间的数字。该线条平滑且半透明。 工厂方法 方法返回值说明GPolyline.fromEncoded(color?:String, weight?:Number, opacity?:Number, latlngs:String, zoomFactor:Number, levels:String, numLevels:Number)GPolyline根据聚合坐标和级别的编码字符串创建折线。color 是一个字符串包含十六进制数字、HTML 样式的颜色如 #RRGGBB。weight 是以像素为单位的线宽。opacity 是介于 0 和 1 之间的数字。latlngs 是包含已编码的经度和纬度坐标的字符串。levels 是包含已编码的折线缩放级别组的字符串。numLevels 是已编码的levels 字符串中包含的缩放级别数。zoomFactor 是编码的 levels 字符串中相邻缩放级别组合之间的倍数。这两个值结合使用可确定已编码的折线中levels 的精确度。该线条是防锯齿且半透明的。 自 2.63 开始 方法 方法返回值说明deleteVertex(index:Number) None删除折线中含有指定索引值的顶点并相应更新折线的形状。必须已通过 GMap2.addOverlay() 将GPolyline 添加到地图中。 自 2.111 开始 disableEditing() None撤消 enableEditing 的效果从而删除线上的所有控制点并显示为用户不可编辑。 自 2.111 开始 enableDrawing(opts?:GPolyEditingOptions)None允许用户通过点击地图上的其他点构造或修改GPolyline 对象。必须已通过GMap2.addOverlay() 将GPolyline 添加到地图中即使折线最初未填充任何内容也不包含任何顶点。每点击一次都会向折线链添加一个附加“顶点”可通过双击或再次点击最后添加的点来结束制图如果折线顺利绘制完会在最后添加的点处触发“endline”事件否则会触发“cancelline”事件但是不会从地图上删除折线。如果要修改现有GPolyline则会从现有折线的起点或终点连接顶点这在可选参数GPolyEditingOptions.fromStart 中指定。 自 2.111 开始 enableEditing(opts?:GPolyEditingOptions)None允许修改点的现有 GPolyline 链。如果启用则用户可以选择并拖动现有顶点。除非在GPolyEditingOptions 中通过maxVertices 指定了小于当前顶点数的顶点限制否则还将在折线部分的中点处添加“假性控制”点从而可让用户通过点击和拖动这些附加顶点加入新顶点。每当添加或移动顶点时都会触发“lineupdated”事件。 自 2.111 开始 getVertexCount() Number返回折线中顶点的数目。 自 2.46 开始 getVertex(index:Number) GLatLng返回折线中指定索引对应的顶点。 自 2.46 开始 getLength() Number返回沿地球表面的折线的长度以米为单位。 自 2.85 开始 getBounds() GLatLngBounds返回此折线的边界。 自 2.85 开始 hide() None如果当前折线可见并且 GPolyline.supportsHide() 返回true则隐藏此折线。注意如果当前折线可见则此函数会触发 GPolyline.visibilitychanged 事件。 自 2.87 开始 insertVertex(index:Number, latlng:GLatLng)None在折线中的指定索引处插于一个新点并更新其形状。必须已通过 GMap2.addOverlay() 将GPolyline 添加到地图中。 自 2.111 开始 isHidden() Boolean如果当前折线不可见则返回 true。否则返回 false。 自 2.87 开始 show() None如果当前折线不可见则显示该折线。注意如果当前折线不可见则此函数会触发 GPolyline.visibilitychanged 事件。 自 2.87 开始 supportsHide() Boolean如果当前环境下支持 GPolyline 对象的GPolyline.hide()则返回true。否则返回 false。 自 2.87 开始 setStrokeStyle(style:GPolyStyleOptions)None更改折线的样式。必须已通过 GMap2.addOverlay() 将GPolyline 添加到地图中。 自 2.111 开始 事件 事件说明remove() 使用 GMap2.removeOverlay() 或GMap2.clearOverlays()从地图删除折线时会触发此事件。visibilitychanged(isVisible:Boolean)当折线的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件。isVisible 参数反映完成此可见性状态的更改后折线的状态。 自 2.87 开始 click(latlng:GLatLng)点击折线时会触发此事件从而通过其 latlng 参数传入线条的已点击坐标。请注意此事件随后还会触发地图上的“click”事件在该事件中折线作为overlay 参数传递。 自 2.88 开始 mouseover() 鼠标移动到折线上时会触发此事件。 自 2.111 开始 mouseout() 鼠标离开折线时会触发此事件。 自 2.111 开始 lineupdated() 更新折线的样式或形状时会触发此事件。 自 2.111 开始 endline() 用户完成线的绘制通过调用 GPolyline.enableDrawing 开始时会触发此事件。 自 2.111 开始 cancelline() 用户中断线的绘制通过调用 GPolyline.enableDrawing 开始时会触发此事件。 自 2.111 开始 GPolylineOptions 类 此类的实例用于 GPolyline 的构造函数中。此类不存在构造函数。但是此类可以实例化为 javascript 对象常量。 属性 正如此类的名称所指明的一样所有属性都是可选的。 属性类型说明clickable Boolean切换以选择折线是否可点击。此选项的默认值为 true即未指定该选项时折线可点击。 自 2.91 开始 geodesic Boolean将折线的每个边渲染为测地线大圆的一段。测地线是沿地球表面的两个点之间的最近路径。 自 2.84 开始 GPolyEditingOptions 类 此类的实例用于 GPolyline 和GPolygon 的enableEditing 方法中。此类不存在构造函数。但是此类可以实例化为 javascript 对象常量。 属性 正如此类的名称所指明的一样所有属性都是可选的。 属性类型说明maxVertices Number此属性指定可用于该折线的最大顶点数。一旦达到此最大数就不再添加顶点。 自 2.111 开始 fromStart Boolean此属性指定 enableDrawing 是否应从起点而不是端点默认值添加点。 自 2.111 开始 GPolyStyleOptions 类 此类的实例用于 GPolyline 和GPolygon 的setStrokeStyle 方法以及 GPolygon 的setFillStyle 方法中。此类不存在构造函数。但是此类可以实例化为 javascript 对象常量。 属性 正如此类的名称所指明的一样所有属性都是可选的。 属性类型说明color String此属性指定一个字符串包含十六进制数字、HTML 样式的颜色如 #RRGGBB。 自 2.111 开始 weight Number此属性指定以像素为单位的线宽。 自 2.111 开始 opacity Number此属性将折线的不透明度指定为 0透明和 1不透明之间的分数值。 自 2.111 开始 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 开始 工厂方法 方法返回值说明GPolygon.fromEncoded(polylines:encoded polylines[], fill?:Boolean, color?:String, opacity?:Number, outline?:Boolean)GPolygon根据聚合坐标和级别的编码字符串创建多边形由大量折线组成。polylines 包含组成它的折线的关联数组其编码格式与 GPolyline.fromEncoded 文档中所描述的格式相同。fill 指定是否用某种color 填充该多边形。opacity 和 outline 指定是否用折线的颜色、重量和不透明性画多边形。如果在折线中指定多个值则采用折线的第一个值。 自 2.78 开始 GPolyline.fromEncoded 方法 方法返回值说明deleteVertex(index:Number) None使用多边形中指定的索引删除顶点并相应更新多边形的形状。必须已通过 GMap2.addOverlay() 将GPolygon 添加到地图中。 自 2.111 开始 disableEditing() None撤消 enableEditing 的效果从而删除线上的所有控制点并显示为用户不可编辑。 自 2.111 开始 enableDrawing(opts?:GPolyEditingOptions)None允许用户通过点击地图上的附加点构造 GPolygon 对象。必须已通过GMap2.addOverlay() 将GPolyline 添加到地图中即使折线最初未填充任何内容也不包含任何顶点。每点击一次都会向多边形边界添加一个附加“顶点”可通过双击或点击第一个点来完成形状从而结束制图。如果多边形顺利绘制完会在第一个点处触发“endline”事件否则会触发“cancelline”事件但是不会从地图上删除折线。 自 2.111 开始 enableEditing(opts?:GPolyEditingOptions)None允许修改现有的 GPolygon 边界。如果启用则用户可以选择并拖动现有顶点。除非在maxVertices 中通过 GPolyEditingOptions 指定了小于当前顶点数的顶点限制否则还将在多边形部分的中点处添加“假性控制”点从而可让用户通过点击和拖动这些附加顶点加入新顶点。每当添加或移动顶点时都会触发“lineupdated”事件。 自 2.111 开始 getVertexCount() Number返回多边形中的顶点数。 自 2.69 开始 getVertex(index:Number) GLatLng返回多边形中指定索引对应的顶点。 自 2.69 开始 getArea() Number返回以平方米表示的多边形面积假定地球是一个球形。 自 2.85 开始 getBounds() GLatLngBounds返回此多边形的边界。 自 2.85 开始 hide() None如果多边形可见并且 GPolygon.supportsHide 返回true则隐藏该多边形。请注意如果当前多边形可见则此函数会触发 GPolygon.visibilitychanged 事件。 自 2.87 开始 insertVertex(index:Number, latlng:GLatLng)None在多边形中的指定索引处插入一个新点。必须已通过 GMap2.addOverlay() 将GPolygon 添加到地图中。 自 2.111 开始 isHidden() Boolean如果当前多边形不可见则返回 true。否则返回 false。 自 2.87 开始 show() None如果当前多边形不可见则显示该多边形。请注意如果当前多边形不可见则此函数会触发 GPolygon.visibilitychanged 事件。 自 2.87 开始 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() 从地图删除多边形时会触发此事件。visibilitychanged(isVisible:Boolean)当多边形的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件。isVisible 参数反映完成此可见性状态的更改后多边形的状态。 自 2.87 开始 click(latlng:GLatLng)点击多边形时会触发此事件从而通过其 latlng 参数传入多边形的已点击坐标。请注意此事件随后还会触发地图上的“click”事件在该事件中多边形作为overlay 参数传递。 自 2.88 开始 mouseover() 鼠标移动到多边形区域时会触发此事件。 自 2.111 开始 mouseout() 鼠标离开多边形区域时会触发此事件。 自 2.111 开始 lineupdated() 更新多边形的样式或形状时会触发此事件。 自 2.111 开始 endline() 用户完成多边形的绘制通过调用 GPolyline.enableDrawing 开始时会触发此事件。 自 2.111 开始 cancelline() 用户完成多边形的绘制通过调用 GPolyline.enableDrawing 开始时会触发此事件。 自 2.111 开始 GPolygonOptions 类 此类的实例用于 GPolygon 的构造函数中。此类不存在构造函数。但是此类可以实例化为 javascript 对象常量。 属性 正如此类的名称所指明的一样所有属性都是可选的。 属性类型说明clickable Boolean切换以选择多边形是否可点击。此选项的默认值为 true即未指定该选项时多边形可点击。 自 2.91 开始 GScreenOverlay 类 该对象显示地图上的矩形图像叠加层其位置不会随视口的改变而变化。用于 ScreenOverlays 的示例有圆规、徽标和智能显示技术。 构造函数 构造函数说明GScreenOverlay(imageUrl:String, screenXY:GScreenPoint, overlayXY:GScreenPoint, size:GScreenSize)创建来自某个图像网址的屏幕叠加层并按照 screenXY、overlayXY 和 size 参数的指定将其显示在屏幕上。overlayXY 参数确定叠加层图像上或图像外的点该点坐标为screenXY。这可用于有效“修剪”图像。screenXY 参数相对于屏幕原点左下角确定该叠加层图像所对应的点。 自 2.92 开始 方法 方法返回值说明hide() None如果当前屏幕叠加层可见则隐藏它。请注意如果当前屏幕叠加层可见则此函数会触发 GScreenOverlay.visibilitychanged 事件。 自 2.92 开始 isHidden() Boolean如果当前屏幕叠加层不可见则返回 true。否则返回 false。 自 2.92 开始 show() None如果当前屏幕叠加层不可见则显示该叠加层。请注意如果当前屏幕叠加层不可见则此函数会触发 GScreenOverlay.visibilitychanged 事件。 自 2.92 开始 supportsHide() Boolean总是返回 true。 自 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 Numberx 坐标向左增大。y Numbery 坐标向下增大。xunits String指定用于 x 坐标的单位类型。将该单位设置为“fraction”表示相对于地图大小的相对位置而设置为“pixels”表示绝对定位。默认情况下为绝对定位。yunits String指定用于 y 坐标的单位类型。将该单位设置为“fractional”表示相对于地图大小的相对位置而设置为“pixels”表示绝对定位。默认情况下为绝对定位。 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指定用于 GScreenSize.width 属性的单位类型。将该单位设置为“fractional”表示相对于地图大小的相对位置而设置为“pixel”表示像素定位。默认情况下为像素定位。yunits String指定用于 GScreenSize.height 属性的单位类型。将该单位设置为“fractional”表示相对于地图大小的相对位置而设置为“pixel”表示像素定位。默认情况下为像素定位。 GGroundOverlay 类 此对象可在地图中创建矩形图像叠加层其边界由 GLatLngBounds 定义。 构造函数 构造函数说明GGroundOverlay(imageUrl:String, bounds:GLatLngBounds)根据图像网址及其边界创建底面叠加层。 自 2.79 开始 方法 方法返回值说明hide() None如果当前底面叠加层可见则隐藏它。请注意如果当前底面叠加层可见则此函数会触发 GGroundOverlay.visibilitychanged 事件。 自 2.87 开始 isHidden() Boolean如果当前底面叠加层不可见则返回 true。否则返回 false。 自 2.87 开始 show() None如果当前底面叠加层不可见则显示它。请注意如果当前底面叠加层不可见则此函数会触发 GGroundOverlay.visibilitychanged 事件。 自 2.87 开始 supportsHide() Boolean总是返回 true。 自 2.87 开始 事件 事件说明visibilitychanged(isVisible:Boolean)当底面叠加层的可见性状态从可见更改为不可见或从不可见更改为可见时会触发此事件。isVisible 参数反映完成此可见性状态的更改后底面叠加层的状态 自 2.77 开始 GIcon 类 图标指定用来在地图上显示 GMarker 的图像。由于浏览器兼容性的原因要指定一个图标实际上相当复杂。请注意如果不想指定自己的图标则可使用默认 Google 地图图标G_DEFAULT_ICON。 构造函数 构造函数说明GIcon(copy?:GIcon, image?:String)创建新图标对象。如果可选的 copy 参数中给出另一个图标则将复制其属性否则将留为空白。可选的参数 image 可设置image 属性的值。 常数 常数说明G_DEFAULT_ICON 标记使用的默认图标。 属性 属性类型说明image String图标的前景图像网址。shadow String图标的阴影图像网址。iconSize GSize图标前景图像的像素大小。shadowSize GSize阴影图像的像素大小。iconAnchor GPoint此图标在地图上的锚定点相对于图标图像左上角的像素坐标。infoWindowAnchor GPoint信息窗口在此图标上的锚定点相对于图标图像左上角的像素坐标。printImage String打印地图所用的前景图标图像网址。其大小必须与 image 提供的主图标图像的大小相同。mozPrintImage String用 Firefox/Mozilla 打印地图时所用的前景图标图像网址。其大小必须与 image 提供的主图标图像的大小相同。printShadow String打印地图时所用的阴影图像网址。由于大多数浏览器都无法打印 PNG 图像所以图像格式应该为 GIF。transparent String在 Internet Explorer 中捕获点击事件时所用的透明前景图标图像网址。此图像应是具有 1% 不透明性的 24 位 PNG 格式的主图标图像但其大小和形状同主图标相同。imageMap Number[]表示图像地图 x/y 坐标的整数数组用它指定浏览器非 Internet Explorer中图标图像的可点击部分。maxHeight Integer指定拖动标记时视觉上垂直“上升”的距离以像素表示。 自 2.79 开始 dragCrossImage String指定拖动图标时十字交叉图像的网址。 自 2.79 开始 dragCrossSize GSize指定拖动图标时十字交叉图像的像素大小。 自 2.79 开始 dragCrossAnchor GPoint指定拖动图标时十字交叉图像的像素坐标偏移量相对于 iconAnchor。 自 2.79 开始 GPoint 类 GPoint 是以像素坐标表示的地图上的一点。请注意在 v2 中它不再是以地理坐标表示的地面上的一个点。现在地理坐标可以用GLatLng 表示。 在 Google 地图坐标系统中x 坐标向右增大y 坐标“向下”增大不过如果愿意您也可以使用 GPoint 坐标。 注意尽管 GPoint 的两个参数可以作为属性x 和 y 访问但是请勿修改它们而是在创建新对象时使用不同的参数。 构造函数 构造函数说明GPoint(x:Number, y:Number) 创建 GPoint 对象。 属性 属性类型说明x Numberx 坐标。在 Google 地图坐标系统中该值向右增大。y Numbery 坐标。在 Google 地图坐标系统中该值向下增大。 方法 方法返回值说明equals(other:GPoint)Boolean当且仅当其他点有相等的坐标时返回 true。toString() String返回包含 x 和 y 坐标的字符串先 x 坐标后 y 坐标之间用逗号分隔。 GSize 类 GSize 是地图矩形区域的大小以像素表示。大小对象有两个参数width 和height。宽度是点的 x 坐标的差值高度是 y 坐标的差值。 注意尽管 GSize 的两个参数可以作为属性width 和 height 访问但是请勿修改它们而是在创建新对象时使用不同的参数。 构造函数 构造函数说明GSize(width:Number, height:Number)创建 GSize 对象。 属性 属性类型说明width Number宽度参数。height Number高度参数。 方法 方法返回值说明equals(other:GSize)Boolean当且仅当另一大小的分量完全相同时返回 true。toString() String返回包含宽度和高度参数的字符串先宽度后高度之间用逗号分隔。 GBounds 类 GBounds 是以像素坐标表示的地图矩形区域。请注意“地理坐标”中的矩形可用GLatLngBounds 表示。 构造函数 构造函数说明GBounds(points:GPoint[])构造一个包含所有指定 points 的矩形。 属性 属性类型说明minX Number矩形左边的 x 坐标。minY Number矩形上边的 y 坐标。maxX Number矩形右边的 x 坐标。maxY Number矩形下边的 y 坐标。 方法 方法返回值说明toString() String返回包含框的左上角点坐标和右下角点坐标的字符串先左上后右下中间用逗号分隔前后用圆括号括起来。equals(other:GBounds)Boolean在此矩形中的所有参数都等于另一矩形中的参数时返回 true。 自 2.98 开始 mid() GPoint返回矩形区域的中心点像素坐标。 自 2.88 开始 min() GPoint返回矩形区域的左上角像素坐标。max() GPoint返回矩形区域的右下角像素坐标。containsBounds(other:GBounds)Boolean如果传入的矩形区域完全包含于此矩形区域中则返回 true。containsPoint(point:GPoint)Boolean如果矩形区域含边界本身包含像素坐标则返回 true。 自 2.88 开始 extend(point:GPoint)None放大此框使该点也包括在框中。 GLatLng 类 GLatLng 是以经度和纬度表示的地理坐标点。 请注意尽管进行地图投影时通常将经度与 x 坐标相关联将纬度与 y 坐标相关联但总是先填写纬度坐标后填写经度坐标因为这符合绘图习惯。 另请注意不能修改 GLatLng 的坐标。如果想要计算另一个点必须新建一个。 构造函数 构造函数说明GLatLng(lat:Number, lng:Number, unbounded?:Boolean)注意纬度和经度的顺序。如果 unbounded 标记为 true则将使用传递的数字否则纬度会限定在 -90 度和 90 度之间而经度会限定在 -180 度和 180 度之间。 方法 方法返回值说明lat() Number返回以度数表示的纬度坐标-90 到 90 之间的数字。如果在构造函数中设置了 unbounded 标记则纬度坐标可能超出此范围。lng() Number返回以度数表示的经度坐标-180 到 180 之间的数字。如果在构造函数中设置了 unbounded 标记则经度坐标可能超出此范围。latRadians() Number返回以弧度为单位的纬度坐标-PI/2 到 PI/2之间的数字。如果在构造函数中设置了 unbounded 标记则纬度坐标可能超出此范围。lngRadians() Number返回以弧度表示的经度坐标-PI 到 PI 之间的数字。如果在构造函数中设置了 unbounded 标记则经度坐标可能超出此范围。equals(other:GLatLng)Boolean当且仅当其他大小具有相同分量在一定的舍入范围内时返回 true。distanceFrom(other:GLatLng)Number返回从此点到某个指定点的距离以米为单位。地球近似一个球体因此距离可能会有不会超过 0.3% 的误差。请参见以下信息。 自 2.89 开始不推荐使用 distanceFrom(other:GLatLng, radius?:Number)Number返回从此点到某个指定点的距离以米为单位。在默认情况下根据地球赤道半径的默认值 6378137 米计算此距离。地球近似一个球体因此距离可能会有不超过 0.3% 的误差尤其在两极。也可以传递可选的radius 参数计算不同于地球半径的球体的 GLatLng 坐标之间的距离。 自 2.89 开始 toUrlValue() String不推荐使用此版本的方法而使用能传递可选 precision 参数的修订版方法如下所示。 自 2.78 开始不要使用 toUrlValue(precision?:Number) String返回表示此点的字符串采用适合用作网址参数值的格式中间用逗号分隔且不含空格。默认情况下精确度的返回值为 6 位数字相当于 4 英寸/11 厘米的分辨率。可选的precision 参数可让您指定更低的精确度以减轻服务器负载。注意在 2.78 之前此 precision 参数不可用。 自 2.78 开始 属性 这些属性的存在只是为了实现与 v1 事件处理程序函数的向后兼容。不应使用它们。 这些属性反映 lng() 和 lat() 存取器方法的返回值还可在 v1 客户端期望的 GPoint 位置显示GLatLng。如果要使 GLatLng 出现在事件明细中即出现在事件处理程序函数的参数中这是必需的。与方法包装器不同在当前的基础框架中不可创建事件包装器。 属性类型说明x Number不再推荐使用。y Number不再推荐使用。 GLatLngBounds 类 GLatLngBounds 实例在地理坐标中代表矩形包括与 180 度子午线相交的矩形。 构造函数 构造函数说明GLatLngBounds(sw?:GLatLng, ne?:GLatLng)根据西南角和东北角两个点构建矩形。 方法 方法返回值说明equals(other:GLatLngBounds)Boolean当且仅当此矩形中的所有参数都等于其他矩形的参数在一定的舍入范围内时返回 true。contains(latlng:GLatLng)Boolean当且仅当该点的地理坐标位于此矩形内时返回 true。 自 2.88 开始不推荐使用 containsLatLng(latlng:GLatLng)Boolean当且仅当该点的地理坐标位于此矩形内时返回 true。 自 2.88 开始 intersects(other:GLatLngBounds)Boolean如名所述。containsBounds(other:GLatLngBounds)Boolean如名所述。extend(latlng:GLatLng)None放大此矩形使其包含指定的点。沿经线方向的两种可能的放大方式中按较小的那种方式放大。如果两者相等则放大东部的边界。getSouthWest() GLatLng返回矩形西南角的点。getNorthEast() GLatLng返回矩形东北角的点。toSpan() GLatLng返回 GLatLng其坐标表示此矩形的大小。isFullLat() Boolean如果此矩形从南极延伸到北极则返回 true。isFullLng() Boolean如果此矩形沿经线方向环绕地球一周则返回 true。isEmpty() Boolean如果此矩形为空则返回 true。getCenter() GLatLng返回矩形的中心点。 自 2.52 开始 接口 GControl 所有控件都实现此接口。您可以实现此接口以便为地图提供自定义控件。使用 GMap2.addControl() 方法向地图添加控件。 与叠加层不同其相对于地图定位控件相对于地图视图位置而定位即移动地图时控件不移动。 构造函数 构造函数说明GControl(printable?:Boolean, selectable?:Boolean)为新控件类创建原型实例。标志 printable 表示控件在地图的打印输出中应可见。标志 selectable 表示控件包含可选择的文本。 方法 当使用 GMap2.addControl() 向地图中添加控件时地图会调用这些方法。因此您无法调用这些方法但可以实现这些方法。 方法返回值说明printable() Boolean如果可以打印控件则返回至地图。selectable() Boolean如果控件包含可选择文本则返回至地图。initialize(map:GMap2)Node地图将调用该方法因此控件可自我初始化。该控件将使用 GMap2.getContainer() 方法获取包含地图的 DOM 元素并将自己添加到 DOM 元素中。它返回添加的元素。getDefaultPosition() GControlPosition向地图返回默认情况下控件在地图视图中出现的位置。这会由 GMap2.addControl() 的第二个参数所覆盖。 GControlPosition 类 此类描述了地图视图中控件的位置。它由相对于控件所在位置的角和确定此位置的偏移量组成。它可以作为可选参数 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) None使用该控件在地图类型之间注册父/子关系。如果给出 childText则它会显示在该子地图类型而非名称复选框的旁边。如果 isDefault 为 true则默认选择该子地图类型。请注意在添加控件前必须设置所有关系。添加控件后再添加关系是无效的。 自 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)Number向地图返回缩放级别由中心和跨度定义的地图部分按这一缩放级别适合于指定大小以像素表示的地图视图。getBoundsZoomLevel(bounds:GLatLngBounds, viewSize:GSize)None向地图返回缩放级别由边界定义的地图部分按这一缩放级别适合于指定大小以像素表示的地图视图。getName(short?:Boolean) String向地图返回要在 GMapTypeControl 中用作按钮标签的地图类型名称。getProjection() GProjection向地图返回此地图类型的投影。getTileSize() Number向地图返回此地图类型的地图图块大小以像素表示。这些图块的结构假定为二次的。所有图块层的图块大小相同。getTileLayers() GTileLayer[]向地图返回图块层数组。getMinimumResolution() Number向地图返回定义此地图类型的最低缩放级别。getMaximumResolution() Number向地图返回定义此地图类型的最高缩放级别。getTextColor() String向地图返回地图上覆盖文本的最适用颜色。用于版权控件所显示的版权消息文本的颜色。getLinkColor() String向地图返回地图上覆盖的超链接的最适用颜色。用于版权控件所显示的使用条款链接的颜色。getErrorMessage() String向地图返回区域中显示的错误消息或有关此地图类型无地图图块处的区域或缩放级别的错误消息。getCopyrights(bounds:GLatLngBounds, zoom:Number)String[]向地图返回版权消息该消息适用于由 bounds 描述的指定缩放级别的地区。这用于地图上的版权消息。getUrlArg() String向地图返回一个值用作当前地图视图的永久链接中识别此地图类型的网址参数值。目前这仅由地图应用程序使用。getAlt() String向地图返回此地图类型的备选文本。 自 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_MOON_ELEVATION_MAP 和 G_MOON_VISIBLE_MAP。G_MARS_MAP_TYPES 上面定义的三种火星地图类型数组G_MARS_ELEVATION_MAP、G_MARS_VISIBLE_MAP 和 G_MARS_INFRARED_MAP。G_SKY_MAP_TYPES 上面定义的一种天空地图类型数组 (G_SKY_VISIBLE_MAP)。 事件 事件说明newcopyright(copyright:GCopyright)当向此地图类型中所包含的某个图块层的版权集合添加新版权时会触发此事件。 GMapTypeOptions 类 此类的实例用作 GMapType 构造函数的opts? 参数。此类不存在构造函数。但是此类可以实例化为 javascript 对象常量。 属性 属性类型说明shortName String设置从 GMapType.getName(true) 中返回的地图类型的短名称。默认值与name 相同。urlArg String设置从 GMapType.getUrlArg() 中返回的地图类型的网址参数。默认值为空字符串。maxResolution Number设置由 GMapType.getMaximumResolution() 返回的地图类型的最高缩放级别。默认值为所有图块层的最大值。minResolution Number设置由 GMapType.getMinimumResolution() 返回的地图类型的最低缩放级别。默认值为所有图块层的最小值。tileSize Number设置由 GMapType.getTileSize() 返回的图块大小。默认值是256。textColor String设置由 GMapType.getTextColor() 返回的文本颜色。默认值是black。linkColor String设置由 GMapType.getLinkColor() 返回的文本颜色。默认值是#7777cc。errorMessage String设置由 GMapType.getErrorMessage() 返回的错误消息。默认值为空字符串。alt String对 GMapType.getAlt() 返回的地图类型设置备选文本。默认值为空字符串。 自 2.64 开始 radius Number按传递的 Number以米表示设置地图类型的半径。默认值是 6378137这是地球的赤道半径以米表示。 自 2.89 开始 GLayer 类 此类可以实例化预定义的“layer”叠加层包含相关项目的集合。它实现 GOverlay 接口因此可使用GMap2.addOverlay() 方法添加到地图中。 构造函数 构造函数说明GLayer(layerId:String) 使用指定的唯一层 ID 创建层。http://spreadsheets.google.com/pub?keyp9pdwsai2hDN-cAocTLhnag 包含当前受支持的层列表。 方法 方法返回值说明hide() None隐藏此叠加层使之不可见但保留它在叠加层堆栈中的位置。show() None显示之前隐藏的 GLayer。 静态方法 方法返回值说明GLayer.isHidden(layerId:String) None如果层叠加层隐藏或未使用 GMap2.addOverlay() 方法添加到地图中则返回true。否则返回 false。 接口 GTileLayer 您可以实现此接口以通过 GMapType 或GTileLayerOverlay 提供自定义的地图图块层。此接口的实现应使用GTileLayer 实例作为原型因为这样可以为您实现版权处理。 构造函数 构造函数说明GTileLayer(copyrights:GCopyrightCollection, minResolution:Number, maxResolution:Number, options?:GTileLayerOptions)如果构造函数参数实例化为原型则可省略它。子类构造函数必须使用 call() 调用此构造函数。可选 options 参数指定应作为对象常量传递的GTileLayerOptions 集合。 方法 地图和此图块层传递到的地图类型会调用这些方法。当实现自定义图块层时您需要实现标记为抽象的方法。 方法返回值说明minResolution() Number向地图类型返回此图块层的最低缩放级别。maxResolution() Number向地图类型返回此图块层的最高缩放级别。getTileUrl(tile:GPoint, zoom:Number)String抽象。向地图返回地图图块的网址图块索引由 GPoint 的x 和 y 属性在指定的缩放级别提供。isPng() Boolean抽象。向地图返回图块的图像格式是否为 PNG以及是否因此可能为透明的。否则假定是 GIF。getOpacity() Number抽象。向地图返回显示此图块层所用的不透明度。1.0 为不透明0.0 为透明。getCopyright(bounds:GLatLngBounds, zoom:Number)String抽象。向地图返回此图块层的版权消息这与指定缩放级别的指定地图地区有关。这用于生成此图块层所属的 GMapType 的版权消息。 自 2.89 开始 事件 事件说明newcopyright(copyright:GCopyright)当向此图块层的版权集合添加新版权时会触发此事件。 GTileLayerOptions 类 此类代表 GTileLayer 接口的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明opacity Number设置图块的不透明度范围是 0.0不可见到 1.0不透明。默认值为 1.0。isPng Boolean指明图块的格式是否为 PNG。tileUrlTemplate String指定图块网址模板该模板可以针对每个图块请求而展开以根据现有的图块坐标系引用唯一的图块。将模板置于 GTileLayer 构造函数中可允许您使用此坐标系动态检索图块检索方式类似于 Google 地图检索图块的方式。 模板的格式应该为 http://host/tile?x{X}y{Y}z{Z}.png 其中 X 和 Y 分别指纬度和经度图块坐标Z 指缩放级别比如 http://host/tile?x3y27z5.png。draggingCursor String拖动地图时显示的光标。 自 2.59 开始 GTileLayerOverlay 类 GTileLayerOverlay 通过GTileLayer 放大地图。它实现GOverlay 接口因此可使用GMap2.addOverlay() 方法添加到地图中。在现有的地图图像之上显示GTileLayer以替换该图像将GTileLayer 放置于自定义的GMapType 中。 构造函数 构造函数说明GTileLayerOverlay(tileLayer:GTileLayer, opts?:GTileLayerOverlayOptions)创建封装 GOverlay 的tileLayer。 自 2.61 开始 方法 方法返回值说明hide() None隐藏此叠加层使之不可见但保留它在叠加层堆栈中的位置。 自 2.71 开始 isHidden() None如果图块层叠加层不可见则返回 true。否则返回 false。 自 2.87 开始 show() None显示先前不可见的 GTileLayerOverlay。 自 2.71 开始 refresh() None重新加载所有添加到此 GTileLayerOverlay 的可见图块。 自 2.132 开始 supportsHide() None总是返回 true。 自 2.87 开始 getTileLayer() None返回此叠加层所使用的图块层。 自 2.83 开始 GTileLayerOverlayOptions 类 此类代表 GTileLayerOverlayOptions 构造函数的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明zPriority NumberzPriority 包含确定此 TileLayerOverlay 的相对 z 顺序的值。优先级较高的图块层将显示在优先级较低的图块层之上。 自 2.110 开始 GCopyrightCollection 类 您可以使用此类管理自定义地图类型的地图上显示的版权消息。如果不实现自定义地图类型则无需使用此类。版权集合包含以下信息在哪个缩放级别的地图上为哪个地区显示哪个版权。这对显示异源数据如卫星地图类型的地图类型非常重要。 构造函数 构造函数说明GCopyrightCollection(prefix?:String)从此版权集合所产生的版权消息包含以参数形式给出的通用前缀。 示例“Imagery (C) 2006” 方法 方法返回值说明addCopyright(copyright:GCopyright)None将版权信息对象添加到集合中。getCopyrights(bounds:GLatLngBounds, zoom:Number)String[]返回所有版权字符串它与指定缩放级别的指定地图地区有关。 示例[ Google, Keyhole ]getCopyrightNotice(bounds:GLatLngBounds, zoom:Number)String返回前缀和所有相关的版权字符串它们与指定缩放级别的指定地图地区有关。 示例“Imagery (C) 2006 Google, Keyhole” 事件 事件说明newcopyright(copyright:GCopyright)当向此版权集合添加新的版权时会触发此事件。 GCopyright 类 版权对象包含以下信息哪个版权消息适用于指定缩放级别的矩形地图地区。只有在实现自定义地图类型或图块层时才需要此对象。 构造函数 构造函数说明GCopyright(id:Number, bounds:GLatLngBounds, minZoom:Number, text:String)用指定的属性创建版权信息对象。 属性 属性类型说明id Number此版权信息的唯一标识符。minZoom Number此信息所适用的最低缩放级别。bounds GLatLngBounds此信息所适用的地区。text String版权消息文本。 接口 GProjection 这是地图投影接口。将地图投影实例传递到 GMapType 构造函数中。class GMercatorProjection 是通过此接口实现的所有预定义地图类型都可使用。如果希望用不同的地图投影定义地图类型则可实现此接口。 方法 这些方法由地图调用。您需要实现它们。 方法返回值说明fromLatLngToPixel(latlng:GLatLng, zoom:Number)GPoint返回指定的缩放级别上指定的地理坐标对应的点的地图坐标以像素表示。fromPixelToLatLng(pixel:GPoint, zoom:Number, unbounded?:Boolean)GLatLng返回指定缩放级别上指定的地图坐标点以像素表示的地理坐标。标志 unbounded 在地理经度坐标超出 -180 或 180 度子午线时使地理经度坐标不重叠。tileCheckRange(tile:GPoint, zoom:Number, tilesize:Number)Boolean向地图返回图块索引是否在地图类型的有效范围内。否则地图将会显示空图块。如果地图包含多个地球副本它还可修改指向相同图块的另一实例的 tile 索引从而修改不同图块坐标的同一图块。getWrapWidth(zoom:Number) Number向地图返回 x 方向的周期即地图绕地球一周所需的像素数。默认情况下返回 Infinity即地图不会重复。地图使用该方法在包含多个地球副本的地图视图上计算叠加层的放置位置这种情况通常只出现在缩放级别较低时。 自 2.46 开始 GMercatorProjection 类 所有预定义的地图类型都可以使用墨卡托投影的 GProjection 接口的这一实现方法。 构造函数 构造函数说明GMercatorProjection(zoomlevels:Number)为指定的缩放级别数创建墨卡托投影。 方法 方法返回值说明fromLatLngToPixel(latlng:GLatLng, zoom:Number)GPoint请参见 GProjection。fromPixelToLatLng(pixel:GPoint, zoom:Number, unbounded?:Boolean)GLatLng请参见 GProjection。tileCheckRange(tile:GPoint, zoom:Number, tilesize:Number)None请参见 GProjection。getWrapWidth(zoom:Number) None请参见 GProjection。墨卡托投影在经度方向是周期性的因此它返回指定缩放级别下的整个地球的地图宽度以像素表示。 自 2.46 开始 命名空间 GEvent 此命名空间包含的函数可用于注册事件处理程序既处理自定义事件也处理 DOM 事件和触发自定义事件。此 API 定义的所有事件都是由 GEvent.trigger() 内部触发的自定义事件。 静态方法 方法返回值说明GEvent.addListener(source:Object, event:String, handler:Function)GEventListener为源对象的自定义事件注册事件处理程序。返回一个可用于最终注销处理程序的句柄。可使用源对象的 this 集合调用事件处理程序。GEvent.addDomListener(source:Node, event:String, handler:Function)GEventListener为源对象的 DOM 事件注册事件处理程序。源对象必须为 DOM 节点。返回一个可用于最终注销处理程序的句柄。可使用源对象的 this 集合调用事件处理程序。此函数将 DOM 方法用于当前浏览器来注册事件处理程序。GEvent.removeListener(handle:GEventListener)None删除使用 addListener() 或 addDomListener() 安装的处理程序。GEvent.clearListeners(source:Object or Node, event:String)None删除使用 addListener() 或 addDomListener() 在指定对象上为指定事件安装的所有处理程序。GEvent.clearInstanceListeners(source:Object or Node)None删除使用 addListener() 或 addDomListener() 在指定对象上为所有事件安装的所有处理程序。GEvent.clearNode(source:Node) None对某个节点及其所有子节点递归调用 clearInstanceListeners。GEvent.trigger(source:Object, event:String, ...)None在源对象上触发自定义事件。在将 event 作为参数轮流传递到事件处理程序函数后所有剩余的可选参数。GEvent.bind(source:Object, event:String, object:Object, method:Function)GEventListener将指定对象的方法调用注册为源对象自定义事件的事件处理程序。返回一个可用于最终注销处理程序的句柄。GEvent.bindDom(source:Node, event:String, object:Object, method:Function)GEventListener将指定对象的方法调用注册为源对象自定义事件的事件处理程序。返回一个可用于最终注销处理程序的句柄。GEvent.callback(object:Object, method:Function)Function返回调用 object 上的 method 的闭包。GEvent.callbackArgs(object:Object, method:Function, ...)Function返回调用 object 上的 method 的闭包。返回的函数被调用时会将 method 后的所有其他可选参数作为参数method 依次传递。 事件 事件说明clearlisteners(event?:String) 调用对象上的 clearListeners() 或 clearInstanceListeners() 时会在该对象上触发此事件。当然在执行函数“前”也会触发该事件。 GEventListener 类 此类是不透明的。它不包含方法和构造函数。其实例从 GEvent.addListener() 或GEvent.addDomListener() 返回并最终传递回GEvent.removeListener()。 命名空间 GXmlHttp 此命名空间提供一种工厂方法可以用一种与浏览器无关的方式创建 XmlHttpRequest 实例。 静态方法 方法返回值说明GXmlHttp.create() GXmlHttp创建 XmlHttpRequest 新实例的工厂。 命名空间 GXml 此命名空间提供一种静态方法可用于处理 XML 文档和文档片段。 静态方法 方法返回值说明GXml.parse(xmltext:String) Node将指定的字符串解析为 XML 文本并返回 DOM 表示。如果浏览器不支持本地 XML 解析则会返回空 DIV 元素的 DOM 节点。GXml.value(xmlnode:Node) String返回以 DOM 表示的 XML 文档片段的文本值即仅纯文本内容。 GXslt 类 此类提供的方法可以用一种与浏览器无关的方式将 XSLT 应用于 XML。 静态方法 方法返回值说明GXslt.create(xsltnode:Node) GXslt从以 DOM 表示的 XSLT 样式表创建 GXslt 实例。GXslt.transformToHtml(xmlnode:Node, htmlnode:Node)Boolean使用在此 GXslt 实例的构造函数中指定的 XSLT 样式表转换xmlnode 中以 DOM 表示的 XML 文档。将产生的 HTML 文档片段追加到指定的 htmlnode 中。只有在浏览器本身支持 XSL 转换的情况下才可实现上述转换它将返回true。否则此函数不起任何作用并返回 false。 命名空间 GLog 此命名空间包含部分静态方法可帮助您调试网络应用程序。当第一次使用其中一种 write*() 方法时页面上将打开浮动窗口并显示写入的消息。 静态方法 方法返回值说明GLog.write(message:String, color?:String)None将消息以纯文本形式写入日志窗口。对 HTML 标记字符进行转义使其成为可见字符。GLog.writeUrl(url:String) None将指定网址的链接写入日志窗口。GLog.writeHtml(html:String) None将文本以 HTML 形式写入日志窗口。 GDraggableObject 类 此类使 DOM 元素可拖动。更改拖动光标的静态成员会影响随后创建的所有可拖动对象如地图、缩放控制滑块和概览地图矩形。每个实例成员仅影响其特定的实例。例如在创建地图前您可以调用GDraggableObject.setDraggableCursor(default) 和GDraggableObject.setDraggingCursor(move) 来获取 API 2.56 之前的样式。或者地图构造函数可采用一些选项来设置其 DraggableObject 的光标样式。有关允许的光标值请参见W3C CSS 规范。 构造函数 构造函数说明GDraggableObject(src:Node, opts?:GDraggableObjectOptions)设置事件处理程序以使源元素可拖动。将元素视需要放置于左上位置可选的容器用作边界框。 自 2.59 开始 静态方法 方法返回值说明GDraggableObject.setDraggableCursor(cursor:String)None为随后创建的可拖动对象设置可拖动光标。 自 2.59 开始 GDraggableObject.setDraggingCursor(cursor:String)None为随后创建的可拖动对象设置拖动光标。 自 2.59 开始 GDraggableObject.getDraggingCursor()String返回地图当前正在使用的拖动光标。如果不通过 setDraggingCursor() 静态方法进行设置则将返回地图在控件和标记中使用的默认光标。 自 2.87 开始 GDraggableObject.getDraggableCursor()String返回地图当前正在使用的可拖动光标。如果不通过 setDraggableCursor() 静态方法进行设置则将返回地图在控件和标记中使用的默认光标。 自 2.87 开始 方法 方法返回值说明setDraggableCursor(cursor:String)None设置鼠标置于此可拖动对象之上时的光标。 自 2.59 开始 setDraggingCursor(cursor:String)None设置按下鼠标并拖动此可拖动对象时的光标。 自 2.59 开始 moveTo(point:GPoint)None将 GDraggableObject 移动到指定的绝对位置。该位置以相对于父节点的像素坐标表示。此方法使用 DOM 坐标系即 X 坐标向左增大Y 坐标向下增大。 自 2.89 开始 moveBy(size:GSize)None将 GDraggableObject 移动指定的大小偏移量。此方法使用 DOM 坐标系即宽度向左增大高度向下增大。 自 2.89 开始 事件 事件说明mousedown() 触发此事件以响应 DOM mousedown 事件。处理此事件将阻止 DOM mousedown 事件的默认操作。 自 2.84 开始 mouseup() 触发此事件在可拖动对象上响应 DOM mouseup 事件。处理此事件将阻止 DOM mouseup 事件的默认操作。 自 2.84 开始 click() 点击可拖动对象时会触发此事件。 自 2.84 开始 dragstart() 可拖动对象的拖动事件开始时当用户通过点击并拖动可拖动对象来启动拖动时会触发此事件。 自 2.84 开始 drag() 当用户拖动可拖动对象时会重复触发此事件。 自 2.84 开始 dragend() 在可拖动对象的拖动事件结束时用户释放拖动时会触发此事件。 自 2.84 开始 GDraggableObjectOptions 类 此类代表 GDraggableObject 构造函数的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明left Number对象的左侧起始位置 自 2.59 开始 top Number对象的顶端起始位置。 自 2.59 开始 container Node充当可拖动对象边界框的 DOM 元素 自 2.59 开始 draggableCursor String在鼠标悬停时显示的光标。 自 2.59 开始 draggingCursor String拖动时显示的光标。 自 2.59 开始 delayDrag Boolean默认情况下可拖动 DOM 元素上触发的 DOM mousedown 事件时会触发 dragstart 事件。同样当触发 DOMmouseup 事件时会触发 dragend 事件。将此值设置为 true 会延迟触发拖动事件直到鼠标从生成mousedown 或 mouseup 的位置移开为止。此属性的默认值为 false。 自 2.84 开始 枚举 GGeoStatusCode 在圆括号中指定每个符号常数对应的数值。 常数 常数说明G_GEO_SUCCESS 200 未出现错误已对地址成功地进行了解析并返回其地址解析。 自 2.55 开始 G_GEO_BAD_REQUEST 400 无法成功解析行车路线请求。例如如果此请求包含的路标数大于允许的最大最大数则该请求可能已被拒绝。 自 2.81 开始 G_GEO_SERVER_ERROR 500 无法成功处理地址解析或行车路线请求但是确切的失败原因未知。 自 2.55 开始 G_GEO_MISSING_QUERY 601 HTTP q 参数缺失或没有值。对于地址解析请求这意味着将空地址指定为输入。对于行车路线请求这意味着在输入中未指定查询。 自 2.81 开始 G_GEO_MISSING_ADDRESS 601 G_GEO_MISSING_QUERY 的同义名。 自 2.55 开始 G_GEO_UNKNOWN_ADDRESS 602 找不到指定地址的对应地理位置。这可能是地址比较新或地址不正确。 自 2.55 开始 G_GEO_UNAVAILABLE_ADDRESS 603 由于合法性或合同原因无法返回指定地址的地址解析或指定行车路线查询的路线。 自 2.55 开始 G_GEO_UNKNOWN_DIRECTIONS 604 Gdirections 对象无法计算查询中提到的两点之间的行车路线。这通常是因为两点之间无可用路线或我们没有该地区的路线数据。 自 2.81 开始 G_GEO_BAD_KEY 610 指定的密钥无效或与指定的域不匹配。 自 2.55 开始 G_GEO_TOO_MANY_QUERIES 620 指定的密钥超出了 24 小时的请求限制或在过短的一段时间内提交了过多的请求。如果您要同时或循环发送多个请求请在代码中使用计时器或暂停以确保不会过快地发送请求。 自 2.55 开始 枚举 GGeoAddressAccuracy 不存在为此枚举定义的符号常数。 常数 常数说明0 未知的地点。 自 2.59 开始 1 国家级准确度。 自 2.59 开始 2 地区省/自治区/直辖市、辖区等级准确度。 自 2.59 开始 3 子地区县、市等级准确度。 自 2.59 开始 4 城镇城市、村镇级准确度。 自 2.59 开始 5 邮政编码级准确度。 自 2.59 开始 6 街道级准确度。 自 2.59 开始 7 十字路口级准确度。 自 2.59 开始 8 地址级准确度。 自 2.59 开始 9 建筑物楼房名称、物业名称、购物中心等级准确度。 自 2.105 开始 GClientGeocoder 类 此类用于和 Google 服务器建立直接通信以获取用户指定地址的地址解析。另外地址解析器可维护自己的地址缓存可以无需往返于服务器而回答重复的查询。作为常用的最佳做法建议不要在回路中使用GClientGeocoder 函数。有多个地址要进行地址解析的开发人员或许应改为使用我们的HTTP 地址解析器。 构造函数 构造函数说明GClientGeocoder(cache?:GGeocodeCache)创建地址解析器的新实例直接与 Google 服务器对话。可选的缓存参数允许指定已知地址的自定义客户端缓存。如果未指定缓存则使用 GFactualGeocodeCache。 自 2.55 开始 方法 方法返回值说明getLatLng(address:String, callback:function)None向 Google 服务器发送请求对指定的地址进行地址解析。如果地址已成功定位则用 GLatLng 点调用用户指定的回调函数。否则向回调函数提供一个null 点。如果地址不明确则仅向回调函数传递最匹配的点。 自 2.55 开始 getLocations(query:String|GLatLng, callback:function)None此方法向 Google 地址解析服务发送请求要求该服务对指定的 query 进行解析并在指定的 callback 中处理响应。“地址解析”是指将用户可读的地址转换成经度/纬度值。Google 地址解析服务还支持“反向地址解析”其中提供的地理点会转换成用户可读的地址。要使用此地址解析服务请调用此方法将其传递给query 以进行地址解析。如果将查询作为可寻址的 String 提供则该服务将进行标准的地址解析。但是如果query 包含 GLatLng则该服务将进行反转地址解析。此方法需要调用 Google 服务器因此您还必须传递callback 方法以处理响应。此响应将包含 Status 代码如果成功则会包含一个或多个 Placemark 对象。与 GClientGeocoder.getLatLng 方法不同此回调函数可以通过检查Status 字段来确定失败的原因。 自 2.55 开始 getCache() GGeocodeCache返回当前使用的地址解析缓存或 null如果不执行客户端缓存。 自 2.55 开始 setCache(cache:GGeocodeCache)None设置新的客户端缓存。如果用设置为 null 的缓存调用此方法则禁用客户端缓存。设置新的缓存将会放弃以前存储的地址。 自 2.55 开始 setViewport(bounds:GLatLngBounds)None设置地址解析器以便在指定的视口内或附近放大地址解析结果。该视口表示为 GLatLngBounds 矩形。请注意尽管设置视口会提升结果优先级但不会将结果限制到该边界框内。 自 2.82 开始 getViewport() GLatLngBounds返回视口用于放大该地址解析器内的地址解析结果。该视口表示为 GLatLngBounds 矩形。 自 2.82 开始 setBaseCountryCode(countryCode:String)None 设置地址解析器以偏移搜索结果就像这些搜索结果是从指定国家/地区代码顶级域 (ccTLD) 指定的域发送而来。地址解析仅在 Google 地图本身支持地址解析的那些国家/地区中受支持。多数 ccTLD 代码与 ISO 3166-1 代码相同但有部分例外应予以注意。例如英国的 ccTLD 为“uk”(.co.uk)而其 ISO 3166-1 代码为“GB”。 请注意默认域是最初从中载入地图 API 的域。国家/地区代码不区分大小写。 自 2.82 开始 getBaseCountryCode() String返回指定地址解析器使用的当前国家/地区代码。如果无有效国家/地区代码则此方法返回 null。 自 2.82 开始 reset() None重置地址解析器。具体而言如果此地址解析器使用客户端缓存则此方法对其调用 GGeocodeCache.reset() 方法。 自 2.55 开始 GGeocodeCache 类 此类维护从地址到已知地点的地图。当此类完全生效时它可作为一个从中派生更完善的缓存的基类。 构造函数 构造函数说明GGeocodeCache() 创建新的缓存以便存储从地址到地点的地图。构造函数立即调用 GGeocodeCache.reset 方法。 自 2.55 开始 方法 方法返回值说明get(address:String) Object返回指定 address 下存储的答复。如果未曾为指定的地址存储过答复则此方法返回 null。 自 2.55 开始 isCachable(reply:Object) Boolean返回是否应缓存指定的答复。默认情况下对 reply 对象执行初步检查。具体而言此类将确保对象不为 null 并且具有name 字段。可以通过扩展类以提供有关 reply 对象的更准确的条件来覆盖此方法。 自 2.55 开始 put(address:String, reply:Object)None在指定的 address 下存储指定的 reply。此方法将调用 GGeocodeCache.isCachable 方法来验证是否可以缓存reply。如果得到允许此方法会在借助 GGeocodeCache.toCanoninical 方法规范化的地址下缓存reply。 自 2.55 开始 reset() None从缓存中清除所有答复。在此方法返回后缓存为空。 自 2.55 开始 toCanonical(address:String) String返回认为是规范的地址版本。该地址版本将 address 参数转换为小写用空格替换逗号并用一个空格替换多个空格。 自 2.55 开始 GFactualGeocodeCache 类 此类通过对缓存答复设定更严格的条件来进一步优化基本的 GGeocodeCache 类。它仅缓存短期内更改可能性极小的答复。 构造函数 构造函数说明GFactualGeocodeCache() 创建新的缓存仅存储视为实际存在的答复。 自 2.55 开始 方法 方法返回值说明isCachable(reply:Object) Boolean覆盖此方法的默认实现以便对状态代码执行更彻底的检查。只有 Status.code 设置为 G_GEO_SUCCESS 的答复或确认无效的答复才视为可缓存。不缓存超时或导致常规服务器错误的答复。 自 2.55 开始 GMarkerManager 类 此类可根据地图的当前视口和缩放级别管理地图上数百个标记的可见性。不推荐使用此类建议开发人员改为使用开源 MarkerManager。 构造函数 构造函数说明GMarkerManager(map:GMap, opts?:GMarkerManagerOptions)创建新的标记管理器控制指定地图的标记可见性。 自 2.67 开始 方法 方法返回值说明addMarkers(markers:GMarker[], minZoom:Number, maxZoom?:Number)None向此标记管理器添加一批标记。直到调用 refresh() 方法时才会向地图添加这批标记。将标记置于地图中后如果这些标记都在地图的当前视口范围内并且地图的缩放级别高于或等于指定的minZoom则显示标记。如果给出了 maxZoom则在地图的缩放级别高于或等于指定级别时自动删除标记。 自 2.67 开始 addMarker(marker:GMarker, minZoom:Number, maxZoom?:Number)None向此管理器控制的标记集合添加单个标记。如果标记的位置在地图的当前视口范围内并且地图的缩放级别属于指定的缩放级别范围则立即向地图添加标记。与 addMarkers 方法类似minZoom 和可选的 maxZoom 参数指定显示标记的缩放级别范围。 自 2.67 开始 refresh() None强制管理器更新地图上显示的标记。如果是使用 addMarkers 方法添加的标记则必须调用此方法。 自 2.67 开始 getMarkerCount(zoom:Number) Number返回在指定缩放级别潜在可见的标记总数。这可能包括较低缩放级别的标记。 自 2.67 开始 事件 事件说明changed(bounds:GBounds, markerCount:Number)在地图中添加或删除了管理器所管理的标记后会触发此事件。。事件处理程序函数应准备接受两个参数。第一个参数是定义可见网格边界的矩形。第二个参数传递地图上当前显示的标记数目。 GMarkerManagerOptions 类 此类代表 GMarkerManager 构造函数的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明borderPadding Number指定管理器所监控的地图当前视口以外的额外填充以像素表示。即使此额外填充范围内的标记不完全可见也会将它们添加到地图中。 自 2.67 开始 maxZoom Number设置标记管理器所监控的最高缩放级别。如果未指定则管理器采用最高地图缩放级别。如果将标记添加到管理器时没有使用可选 maxZoom 参数也要使用此值。 自 2.67 开始 trackMarkers Boolean指定标记管理器是否应跟踪标记移动。如果希望使用 setPoint 方法移动受管理的标记则应将此选项设置为 true。默认值为false。 自 2.67 开始 GGeoXml 类 GGeoXml 对象将可公开访问的网络服务器上托管的 XML 文件如 KML 文件中的地理内容添加到地图上。它实现GOverlay 接口因此可使用GMap2.addOverlay() 方法添加到地图中。 构造函数 构造函数说明GGeoXml(urlOfXml:String, callback?:function)创建表示该 XML 文件的 GOverlay。当GGeoXml 对象完成载入 XML 文件时会调用可选的回调函数。。 自 2.108 开始不推荐使用 GGeoXml(urlOfXml:String) 创建表示该 XML 文件的 GOverlay。 自 2.108 开始 方法 方法返回值说明getTileLayerOverlay() GTileLayerOverlayGGeoXml 对象可创建图块叠加层在某些情况下可起到优化作用。此方法将返回此图块层叠加层如果有。请注意如果不需要图块叠加层或GGeoXml 文件尚未完成载入则图块叠加层可能null。 自 2.84 开始 getDefaultCenter() GLatLng以 lat/lng 返回默认视口的中心点。只有在载入完文件后才可调用此函数。 自 2.84 开始 getDefaultSpan() GLatLng以 lat/lng 返回默认视口的跨度。只有在载入完文件后才可调用此函数。 自 2.84 开始 getDefaultBounds() GLatLngBounds返回默认视口的边界框。只有在载入完文件后才可调用此函数。 自 2.84 开始 gotoDefaultViewport(map:GMap2)None将地图的视口设置为 XML 文件的默认视口。 自 2.84 开始 hasLoaded() Boolean检查 XML 文件是否已完成载入如果完成则返回 true。如果尚未载入完 XML 文件则此方法返回 false。 自 2.84 开始 hide() None如果叠加层当前可见并且叠加层的 supportsHide() 方法返回 true则隐藏 GGeoXml 对象创建的子叠加层。请注意此方法会针对每个触发了该事件例如GMarker.visibilitychanged 和GGroundOverlay.visibilitychanged 等的子叠加层分别触发visibilitychanged 事件。如果当前没有使 supportsHide() 返回 true 的可见叠加层则此方法无效。 自 2.87 开始 isHidden() Boolean如果 GGeoXml 对象当前因被GGeoXml.hide() 方法进行了更改而不可见则返回true。否则返回 false。 自 2.87 开始 loadedCorrectly() Boolean检查 XML 文件是否已正确载入如果是则返回 true。如果 XML 文件未正确载入则此方法返回 false。如果 XML 文件尚未完成载入则此方法的返回值是“undefined”。 自 2.84 开始 show() None如果 GGeoXml 对象创建的子叠加层当前不可见则显示它们。请注意此方法会针对每个触发了该事件例如GMarker.visibilitychanged 和GGroundOverlay.visibilitychanged 等的子叠加层分别触发visibilitychanged 事件。 自 2.87 开始 supportsHide() Boolean总是返回 true。 自 2.87 开始 事件 事件说明load() 已完整载入 GGeoXml 的 XML 文件并且所有关联的叠加层已在地图上显示时或者 XML 文件未正确载入时会触发此事件。 自 2.108 开始 函数 GDownloadUrl 此函数提供一种便利方式可异步检索按网址标识的资源。请注意由于 XmlHttpRequest 对象用于执行请求因此它受跨站脚本的同源限制即网址必须指向与当前执行此代码的文档的网址相同的服务器。因此对url 参数使用绝对网址通常是多余的最好仅使用绝对或相对路径。处理抛出的任何异常如安全错误都是调用者的职责。 函数 方法返回值说明GDownloadUrl(url:String, onload:Function, postBody?:String, postContentType?:String)None从指定的网址中检索资源然后通过将文档文本作为第一参数、将 HTTP 响应状态代码作为第二参数来调用 onload 函数。如果请求超时则可将 null 作为第一参数、-1 作为第二参数调用 onload 函数。此函数在默认情况下会发送 HTTP GET 请求。要发送 HTTP POST 请求请传递可选postBody 参数中的数据。如果发送的数据的类型不是“application/x-www-form-urlencoded”则将内容类型作为字符串传递到postContentType 参数中。此方法受跨站脚本限制。请注意此方法使用浏览器的底层 XmlHttpRequest 实现。 函数 GBrowserIsCompatible 此函数确定地图 API 是否可用于当前的浏览器中。 函数 方法返回值说明GBrowserIsCompatible() Boolean如果当前浏览器支持地图 API 库则返回 true。 函数 GUnload 您可调用此函数使地图 API 清理内部数据结构以释放内存。这有助于解除可导致网络应用程序中内存泄漏的各种浏览器故障。您应在页面的 unload 事件处理程序中调用此函数。调用此函数后在此页面中创建的地图对象会出现功能混乱。 函数 方法返回值说明GUnload() None删除所有注册的事件处理程序以防止内存泄漏。应作为 unload 事件的处理程序进行调用。 GDirections 类 此类用于获取行车路线的结果并将它显示在地图上和/或文本面板中。 构造函数 构造函数说明GDirections(map?:GMap2, panel?:Element)创建行车路线对象的新实例以请求和存储行车路线的结果。如果使用 GDirections.load() 方法进行查询则此行车路线对象可创建行车路线。 构造函数采用可选的地图对象显示计算出的行车路线的折线和/或面板 DIV 元素以文本形式显示行车路线结果。 如果传递了 map 参数则只要计算出新的行车路线结果与结果关联的折线和标记就会作为叠加层自动添加到地图上。同样传递了 panel 参数后与结果关联的文本格式的行车路线就会添加到指定的 DIV 中以替换 DIV 中任何现有内容。 如果上述参数中有任何一个为 null则直到使用 GDirections.load() 方法发出显式请求后才检索相关元素。如下所示。 此外该对象还包含三个事件侦听器可以截获 “load”通过 GDirections.load() 发布的行车路线查询结果可用时会触发此事件。请注意load() 方法会启动一个新的查询该查询一旦完成载入又会触发一个“load”事件。将任何叠加层元素添加到地图/面板之前都会触发“load”事件。“addoverlay”在将折线和/或文本格式的行车路线组件添加到地图和/或 DIV 元素之后会触发此事件。请注意如果不将其中任何一个元素附加到GDirections 对象则不会触发“addoverlay”事件。“error”如果行车路线请求导致错误则触发此事件。调用者可以使用 GDirections.getStatus() 获取有关该错误的详细信息。当发生“error”事件时不会触发“load”或“addoverlay”事件。 自 2.81 开始 方法 方法返回值说明load(query:String, queryOpts?:GDirectionsOptions)None此方法将发布新的行车路线查询。query 参数为字符串包含所有有效的行车路线查询例如“from: Seattle to: San Francisco”或“from: Toronto to: Ottawa to: New York”。默认情况下如果在构造GDirections 对象时指定了地图则该查询将请求折线结果。同样如果指定了文本面板该查询也会请求详细的文本结果。否则结果只包含已找到路线的摘要信息。 为了覆盖此行为比如即使未将地图附加到此对象也可请求折线信息调用者可使用 queryOpts 可选参数。有关详细信息请参见 GDirectionsOptions 文档。 收到行车路线结果时此对象清除旧结果代之以新结果并用新结果更新地图和/或面板。行车路线结果由多条路线组成GRoute 类型的对象查询中指定的每个连续路标/地址对都有一条路线。而路线又由多个路段组成GStep 类型的对象。 如果在重新调用 load() 时还未完成前一 load() 请求则取消先前的请求。因此可以使用单个 GDirections 对象连续发布行车路线请求但要并行生成多个请求则必须使用多个GDirections 对象。 自 2.81 开始 loadFromWaypoints(waypoints:Array, queryOpts?:GDirectionsOptions)None使用路标数组而不是单一查询字符串作为输入来发布新的行车路线查询。此数组最多可包含 25 个路标条目。数组中的每一项都是一个表示输入地址或纬度经度点的字符串。有关此方法行为的详细信息请参见GDirections.load()。 自 2.81 开始 clear() None清除全部现有的行车路线结果从地图和面板中删除叠加层并取消任何未决 load() 请求。 自 2.81 开始 getStatus() Object返回行车路线请求状态。返回的对象具有以下形式 { code: 200 request: directions } 该状态代码可以采用 GGeoStatusCode 中定义的任意值。 自 2.81 开始 getBounds() GLatLngBounds此方法用于获取此行车路线查询结果的边界框。如果无法提供成功的结果则返回 GLatLngBounds 对象或 null。 自 2.81 开始 getNumRoutes() Number返回结果中可用的路线数目。对于成功的查询该数目应该是输入路标总数减 1。当没有可用结果时因为未发布查询或先前的查询失败此方法返回 0。 自 2.81 开始 getRoute(i:Number) GRoute在响应中为第 i 条路线返回 GRoute 对象。 自 2.81 开始 getNumGeocodes() Number返回结果中可用的地址解析项的数目。对于成功的查询此数目应等于输入路标的总数目。当不存在可用结果时因为未发布查询或先前的查询失败此方法返回 0。 自 2.81 开始 getGeocode(i:Number) Object返回第 i 个路标的地址解析结果。此对象的结构与 GClientGeocoder 对象的响应中单个地标的结构相同。 自 2.81 开始 getCopyrightsHtml() String返回 HTML 字符串它包含此结果的版权信息。 自 2.81 开始 getSummaryHtml() String返回包含对整个行车路线请求的距离和时间的概述的 HTML 代码段。请注意此摘要是返回给构造时无关联地图或 DIV 元素的 GDirections 对象的唯一信息。 自 2.81 开始 getDistance() Object返回一个表示行车路线请求总距离跨所有路线的对象常量。对象包含两个字段一个是称为“meters”的数字表示距离的数值以米为单位一个是称为“html”的字符串包含本地化的距离字符串表示以此行车路线组合的出发国家/地区的通用度量单位为单位。 自 2.81 开始 getDuration() Object返回一个表示行车路线请求总时间跨所有路线的对象常量。对象包含两个字段一个是称为“seconds”的数字表示时间的数值以秒为单位另一个是称为“html”的字符串包含时间的本地化字符串表示。 自 2.81 开始 getPolyline() GPolyline返回与整个行车路线响应相关联的 GPolyline 对象。请注意在响应中有一条表示所有路线的折线。只有在载入了行车路线结果即触发“load”事件后才能定义此对象。 自 2.81 开始 getMarker(i:Number) GMarker返回与第 i 条地址解析相关联的标记。只有在载入了行车路线结果即触发“load”事件后此方法才能返回非空值。 自 2.81 开始 GDirectionsOptions 类 此类表示 GDirections.load() 和GDirections.loadFromWaypoints() 方法的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明locale String用于行车路线结果的区域。例如“en_US”、“fr”和“fr_CA”等。travelMode GTravelModes出行模式如驾车默认值或步行。 自 2.129 开始 avoidHighways Boolean如果为 true则行车路线会在计算行车路线时试图排除高速公路。请注意如果没有可行方案则行车路线可能仍会选择高速公路。 自 2.124 开始 getPolyline Boolean默认情况下仅在地图与 GDirections 对象关联时GDirections.load*() 方法才会抓取折线数据。此字段可用于覆盖此行为使得即使地图不与 Directions 对象关联也可检索折线数据。getSteps Boolean默认情况下仅在面板与 GDirections.load*() 对象关联时GDirections 方法才会抓取步骤数据。此字段可用于覆盖此行为使得即使不向 Directions 对象添加面板也可检索路段数据。preserveViewport Boolean默认情况下当 Directions 对象包含地图时地图将处于中心位置并缩放到行车路线结果的边界框大小。当此选项设置为 true 时只为此请求保留视口除非在第一个位置从未设置它。 枚举 GTravelModes 常数 常数说明G_TRAVEL_MODE_WALKING 步行 自 2.129 开始 G_TRAVEL_MODE_DRIVING 驾车 自 2.129 开始 GRoute 类 此类的对象由 GDirections 对象创建可在行车路线结果中存储单条路线的信息。此类没有公共构造函数。客户端不应直接创建此类的对象。 方法 方法返回值说明getNumSteps() Number返回此路线的路段数。 自 2.81 开始 getStep(i:Number) GStep返回此路线中第 i 条路段的 Gstep 对象。 自 2.81 开始 getStartGeocode() Object返回此路线出发点的地址解析结果。此对象的结构与 GClientGeocoder 对象的响应中单个地标的结构相同。 自 2.83 开始 getEndGeocode() Object返回此路线终点的地址解析结果。此对象的结构与 GClientGeocoder 对象的响应中单个地标的结构相同。 自 2.83 开始 getEndLatLng() GLatLng为此路线的折线最后一点返回 GLatLng 对象。请注意此点可能不同于GRoute.getEndGeocode() 中的“经度, 纬度”因为getEndLatLng() 总是返回对齐到路网的点。没有对应的 getStartLatLng() 方法因为其与调用GRoute.getStep(0).getLatLng() 相同。 自 2.81 开始 getSummaryHtml() String返回包含此路线的距离和时间概述的 HTML 代码段。 自 2.81 开始 getDistance() Object返回表示此路线总距离的对象常量。有关此对象的结构请参见 GDirections.getDistance()。 自 2.81 开始 getDuration() Object返回表示此路线总时间的对象常量。有关此对象的结构请参见 GDirections.getDuration()。 自 2.81 开始 GStep 类 此类的对象由 GDirections 对象创建可在行车路线结果中存储一条路线中单个路段的信息。此类没有公共构造函数。客户端不应直接创建此类的对象。 方法 方法返回值说明getLatLng() GLatLng为此路段的折线开始点返回 GLatLng 对象。 自 2.81 开始 getPolylineIndex() Number返回此路段的折线开始点的索引。 自 2.81 开始 getDescriptionHtml() String返回包含此路段描述的 HTML 字符串。 自 2.81 开始 getDistance() Object返回表示此路段总距离的对象常量。有关此对象的结构请参见 GDirections.getDistance()。 自 2.81 开始 getDuration() Object返回表示此路段总时间的对象常量。有关此对象的结构请参见 GDirections.getDuration()。 自 2.81 开始 GTrafficOverlay 类 GTrafficOverlay 对象将显示道路交通信息的叠加层添加到地图中。它实现GOverlay 接口因此可使用GMap2.addOverlay() 方法添加到地图中并可使用GMap2.removeOverlay() 方法删除。GTrafficOverlay 仅显示受支持城市的交通信息。 构造函数 构造函数说明GTrafficOverlay(opts?:GTrafficOverlayOptions)创建新的 GTrafficOverlay 对象显示道路交通信息。 自 2.81 开始 方法 方法返回值说明hide() None隐藏交通叠加层。 自 2.81 开始 show() None显示交通叠加层。 自 2.81 开始 事件 事件说明changed(hasTrafficInView:Boolean)在当前的视口中更改交通数据的状态时会触发此事件。在含有交通数据和不含有交通数据的两个地区之间移动地图时或向地图添加 GTrafficOverlay 导致交通数据显示在当前视口中时会触发此事件。如果视口包含交通数据则hasTrafficInView 参数为 true否则为 false。不管是隐藏还是显示该层此事件都会起作用。 自 2.85 开始 GTrafficOverlayOptions 类 此类代表 GTrafficOverlay 构造函数的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明incidents Boolean设置为 true 时表示 GTrafficOverlay 应在地图相应位置上显示交通事故。默认情况下该值设置为false。 自 2.121 开始 hide Boolean设置为 true 时表示地图不应一开始就显示 GTrafficOverlay。要打开叠加层请调用GTrafficOverlay.show()。默认情况下该值设置为false。 自 2.121 开始 GAdsManager 类 GAdsManager 对象抓取AdSense 广告并将它们显示在指定的地图中。广告显示为 GMarker点击它可在标记信息窗口显示广告。GAdsManager 根据当前视口大小和周围的页面文本内容选择 AdSense 广告。请注意向地图添加 GAdsManager 时还必须使用enable() 方法专门启用它。 构造函数 构造函数说明GAdsManager(map:GMap2, publisherId:String, adsManagerOptions?:GAdsManagerOptions)创建新的 GAdsManager 对象从 Google 服务器请求 AdSense 广告。map 参数可识别此GAdsManager 应在其上显示广告的地图。publisherId 参数指定开发人员的 AdSense 帐户。adsManagerOptions 参数是GAdsManagerOptions 对象常量。 自 2.85 开始 方法 方法返回值说明enable() None启用抓取广告。默认情况下不抓取广告。 自 2.85 开始 disable() None禁用抓取广告。 自 2.85 开始 GAdsManagerOptions 类 此类存储 GAdsManager 构造函数的可选参数。它没有构造函数但可实例化为对象常量。 属性 属性类型说明maxAdsOnMap Number任何时候可在地图上显示的最大广告数。默认值是 3。 自 2.85 开始 channel Number用于抓取广告的 AdSense 渠道数。渠道是 AdSense 发行人可用来从多个来源跟踪广告收入的可选功能。 自 2.85 开始 minZoomLevel Number显示广告的最低缩放级别。默认值是 6。 自 2.85 开始 GStreetviewPanorama 类 GStreetviewPanorama 对象包含 Flash? Street View Panorama 查看器的实例。此类的每个对象都包含一个单独的实例显示唯一视图。该对象通常嵌入诸如DIV 的容器对象中并且可以使用此类的方法更改其视图。并不是所有位置都有街道视图数据。使用 GStreetviewClient 对象或GStreetviewOverlay 对象确定是否有您的位置的街道视图数据。 构造函数 构造函数说明GStreetviewPanorama(container:Node, opts?:GStreetviewPanoramaOptions)使用所提供容器中相应的 flash 查看器创建新的 GStreetviewPanorama 对象。在可选的GStreetviewPanoramaOptionsopts 对象中或通过调用 setLocationAndPOV 指定位置之前将不会显示该查看器。 自 2.104 开始 方法 方法返回值说明remove() None从 DOM 中删除当前与此对象关联的 flash 查看器的实例。在删除 HTML 容器元素之前必须调用此函数否则有些浏览器将无法对该flash 查看器进行垃圾收集。 自 2.104 开始 setContainer(container:Node) None为该 flash 查看器设置容器元素如果该查看器当前是打开的则从其旧位置对它进行移动。 自 2.104 开始 checkResize() None通知 flash 查看器其容器大小已更改。在更改了容器 DOM 对象的大小后调用此方法以便查看器能够适合于新的大小。 自 2.104 开始 hide() None隐藏该 flash 查看器。要删除该查看器请调用 .remove()。 自 2.104 开始 show() None显示该 flash 查看器。 自 2.104 开始 isHidden() boolean如果与此对象相关联的 flash 查看器不可见则返回 true否则返回 false。 自 2.104 开始 getPOV() GPov返回该 flash 查看器中显示的当前视点 (POV)。 自 2.104 开始 setPOV(pov:GPov)None在不更改其位置的情况下更改该 flash 查看器中显示的当前视点 (POV)。 自 2.104 开始 panTo(pov:GPov, opt_longRoute:Boolean)None在不更改其位置的情况下更改该 flash 查看器中显示的当前视点 (POV)。执行从当前 POV 到新 POV 的平滑动画。如果设置了 opt_longRoute则动画会沿球体的长路线否则沿最短的路线。 自 2.104 开始 setLocationAndPOV(latlng:GLatLng, opt_pov:GPov)None设置该 flash 查看器的位置和 POV。调用该函数后查看器会显示距离提供的 latlng若存在最近的位置。如果该位置没有数据那么该 flash 播放器会保持不变并显示错误代码。有关可能的响应代码请参见GStreetviewClient.ReturnValues。 自 2.104 开始 followLink(yaw:Number) None点击从当前全景到相邻全景的链接。yaw 指定相邻全景的方向如果存在多个相邻全景则采用最近的匹配。 自 2.104 开始 事件 事件说明yawchanged(yaw:Number) flash 查看器中显示的偏角更改时触发该事件。 自 2.104 开始 pitchchanged(pitch:Number) flash 查看器中显示的倾斜度更改时触发该事件。 自 2.104 开始 zoomchanged(zoom:Number) flash 查看器的缩放级别更改时触发该事件。 自 2.104 开始 error(errorCode:GStreetviewPanorama.ErrorValues)发生错误时触发该事件。有关错误类型的列表请参见 GStreetviewPanorama.ErrorValues。 自 2.104 开始 initialized(location:GStreetviewLocation)移动到新位置后初始化全景时触发该事件。该位置是一个 GStreetviewLocation 对象。注意首次显示全景时不会发送initialized 事件这是一个已知问题我们计划在以后的版本中对其进行修正。 自 2.104 开始 GStreetviewPanoramaOptions 类 此类表示传递到 GStreetviewPanorama 构造函数的选项。该类没有构造函数但可实例化为对象常量。所有属性都是“可选的”。 属性 属性类型说明latlng GLatLng打开 flash 查看器的 latlng。 自 2.104 开始 pov GPov打开 flash 查看器的照相机方向。 自 2.104 开始 GStreetviewOverlay 类 GStreetviewOverlay 对象是一个图块集突出显示有街道视图数据的位置。此类实现GOverlay 接口并且可使用map.addOverlay 添加到地图中使用 map.removeOverlay 删除。 构造函数 构造函数说明GStreetviewOverlay() 创建实现 GOverlay 接口的新GStreetviewOverlay。 自 2.104 开始 事件 事件说明changed(hasStreetviewData:Boolean)当前视口中街道视图数据的状态变化时会触发此事件。将地图从具有街道视图数据的区域移动到没有街道视图数据的区域时会触发此事件反之亦然。当向地图添加 GStreetviewOverlay 导致在视口中显示街道视图数据时也会触发此事件。如果视口包含街道视图数据则hasStreetviewData 参数为 true否则为 false。 自 2.120 开始 GStreetviewClient 类 GStreetviewClient 对象基于传递到其方法的参数搜索街道视图数据。 构造函数 构造函数说明GStreetviewClient() 创建新的 GStreetviewClient 自 2.104 开始 方法 方法返回值说明getNearestPanoramaLatLng(latlng:GLatLng, callback:Function(GLatLng))None查找离指定点最近的全景的 GLatLng并将其传递给提供的回调函数。如果附近没有全景或者服务器发生错误则为提供的回调函数传递 null 值。 自 2.104 开始 getNearestPanorama(latlng:GLatLng, callback:Function(GStreetviewData))None检索离指定的 latlng 最近的全景的数据并将其作为 GStreetviewData 对象传递给提供的回调函数。 自 2.104 开始 getPanoramaById(panoId:string, callback:Function(GStreetviewData))None检索指定全景 ID 的数据并将其作为 GStreetviewData 对象传递给提供的回调函数。每个全景的 ID 是唯一的在某个会话的生命期内是稳定的但是很有可能在不同会话之间会改变。 自 2.104 开始 枚举 GStreetviewClient.ReturnValues 在圆括号中指定每个符号常数对应的数值。 常数 常数说明SUCCESS 200 成功 自 2.104 开始 SERVER_ERROR 500 服务器没有响应查询。 自 2.104 开始 NO_NEARBY_PANO 600 没有找到全景数据。 自 2.104 开始 GStreetviewData 类 此类表示与全景相关的数据。它没有构造函数但可实例化为对象常量。 属性 属性类型说明location GStreetviewLocation位置数据。 自 2.104 开始 copyright String本地化的版权归属。 自 2.104 开始 links GStreetviewLink[]到相邻全景的链接如果有。 自 2.104 开始 code GStreetviewClient.ReturnValues状态代码。请参见 GStreetviewClient.ReturnValues. 自 2.104 开始 GStreetviewLocation 类 此类表示一个街道视图位置。它没有构造函数但可实例化为对象常量。 属性 属性类型说明latlng GLatLng全景的 latlng。 自 2.104 开始 pov GPov初始视点。 自 2.104 开始 description String描述该位置的本地化字符串。 自 2.104 开始 panoId String全景的唯一标识符。该标识符在某个会话内是稳定的但是在会话之间不稳定。 自 2.104 开始 GStreetviewLink 类 此类表示从一个 GStreetviewLocation 到相邻GStreetviewLocation 的链接。它没有构造函数但可实例化为对象常量。 属性 属性类型说明yaw Number从当前位置到相邻位置的偏角。 自 2.104 开始 description String描述相邻位置的本地化字符串。 自 2.104 开始 panoId String相邻全景的唯一标识符。该标识符在某个会话内是稳定的但是在会话之间不稳定。 自 2.104 开始 GPov 类 此类表示街道视图所使用的照相机视点结构。它没有构造函数但可实例化为对象常量。所有属性都是“可选的”。 属性 属性类型说明yaw Number相对于正北方的照相机偏角。正北方为 0 度东方为 90 度南方为 180 度西方为 270 度。 自 2.104 开始 pitch Number相对于街道视图工具的照相机偏角度数。范围从90 度垂直向上到 -90 度垂直向下。 自 2.104 开始 zoom Number缩放级别。完全缩小为 0 级别放大会增大级别。 自 2.104 开始 枚举 GStreetviewPanorama.ErrorValues 在圆括号中指定每个符号常数对应的数值。 常数 常数说明NO_NEARBY_PANO 600 没有找到全景数据。 自 2.104 开始 FLASH_UNAVAILABLE 603 flash 查看器不可用通常是因为用户的浏览器不支持 flash。 自 2.104 开始 杨航收集技术资料分享给大家
