楊航收集技術(shù)資料，分享給大家

Google 地圖 API 參考

Google 地圖 API 現(xiàn)在與 Google AJAX API 載入器集成，后者創(chuàng)建了一個(gè)公共命名空間，以便載入和使用多個(gè) Google AJAX API。該框架可讓您將可選 google.maps.* 命名空間用于當(dāng)前在 Google 地圖 API 中使用的所有類、方法和屬性，使用此命名空間替換常規(guī) G 前綴。不要擔(dān)心，現(xiàn)有G 命名空間仍能得到支持。

例如，Google 地圖 API 中的 GMap2 對(duì)象還可以定義為 google.maps.Map2。

請(qǐng)注意，此參考文檔僅指現(xiàn)有 G 命名空間。

如果只是要使用地圖顯示內(nèi)容，則需要了解以下類、類型和函數(shù)：

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

如果您要通過(guò)實(shí)現(xiàn)自己的控件、疊加層或地圖類型來(lái)擴(kuò)展地圖 API 的功能，則還需要了解以下類和類型：

GGoogleBarListingTypes GGoogleBarLinkTarget GGoogleBarResultList GMapPane GOverlay GControl GControlPosition

GControlAnchor GMapTypeControl GMenuMapTypeControl GHierarchicalMapTypeControl GMapType GMapTypeOptions GLayer

GTileLayer GTileLayerOverlay GCopyrightCollection GCopyright GProjection GMercatorProjection

GMap2 類

對(duì) GMap2 類進(jìn)行實(shí)例化以創(chuàng)建地圖。這是 API 中的中心類。其他都是輔助類。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMap2(container:Node, opts?:GMapOptions)	在指定的 HTML 容器中創(chuàng)建新的地圖，該容器通常是一個(gè) DIV 元素。如果可選參數(shù) opts.mapTypes 中沒(méi)有給出地圖類型集合，則使用默認(rèn)的集合G_DEFAULT_MAP_TYPES。如果可選參數(shù) opts.size 中沒(méi)有給出大小，則使用 container 的大小。如果給出了 opts.size，則相應(yīng)地調(diào)整地圖容器元素的大小。請(qǐng)參見(jiàn) class GMapOptions。注意：需要先將地圖居中，才能使用該地圖。您應(yīng)該立即調(diào)用GMap2.setCenter() 來(lái)初始化使用該構(gòu)造函數(shù)創(chuàng)建的地圖。

方法

配置

方法返回值說(shuō)明

enableDragging()	None	啟用地圖拖動(dòng)（默認(rèn)情況下啟用）。
disableDragging()	None	禁用地圖拖動(dòng)。
draggingEnabled()	Boolean	當(dāng)且僅當(dāng)啟用了地圖拖動(dòng)時(shí)，返回 true。
enableInfoWindow()	None	啟用地圖上的信息窗口操作（默認(rèn)情況下啟用）。
disableInfoWindow()	None	如果信息窗口處于打開(kāi)狀態(tài)，請(qǐng)關(guān)閉它并禁用打開(kāi)新信息窗口。
infoWindowEnabled()	Boolean	當(dāng)且僅當(dāng)啟用了信息窗口時(shí)，返回 true。
enableDoubleClickZoom()	None	啟用雙擊縮放地圖（默認(rèn)情況下啟用）。 （自 2.58 開(kāi)始）
disableDoubleClickZoom()	None	禁用雙擊縮放地圖。 （自 2.58 開(kāi)始）
doubleClickZoomEnabled()	Boolean	當(dāng)且僅當(dāng)啟用了雙擊縮放地圖時(shí)，返回 true。 （自 2.58 開(kāi)始）
enableContinuousZoom()	None	啟用選擇瀏覽器的連續(xù)平滑縮放（默認(rèn)情況下禁用）。 （自 2.58 開(kāi)始）
disableContinuousZoom()	None	禁用連續(xù)平滑縮放。 （自 2.58 開(kāi)始）
continuousZoomEnabled()	Boolean	如果啟用了連續(xù)平滑縮放，則返回 true。 （自 2.58 開(kāi)始）
enableGoogleBar()	None	為地圖啟用集成搜索控件 GoogleBar。如果啟用，該控件會(huì)取代默認(rèn)的“由 Google 強(qiáng)力驅(qū)動(dòng)”徽標(biāo)。?請(qǐng)注意，該控件默認(rèn)情況下未啟用。 （自 2.92 開(kāi)始）
disableGoogleBar()	None	禁用 GoogleBar 集成搜索控件。如果禁用，默認(rèn)的“由 Google 強(qiáng)力驅(qū)動(dòng)”徽標(biāo)會(huì)占據(jù)以前放置此控件的位置。?請(qǐng)注意，該控件已經(jīng)默認(rèn)禁用。 （自 2.92 開(kāi)始）
enableScrollWheelZoom()	None	啟用使用鼠標(biāo)滾輪縮放。注意：默認(rèn)情況下禁用滾輪縮放。 （自 2.78 開(kāi)始）
disableScrollWheelZoom()	None	禁用使用鼠標(biāo)滾輪縮放。注意：默認(rèn)情況下禁用滾輪縮放。 （自 2.78 開(kāi)始）
scrollWheelZoomEnabled()	Boolean	返回一個(gè)表示是否啟用滾輪縮放的布爾值。 （自 2.78 開(kāi)始）

控件

方法返回值說(shuō)明

addControl(control:GControl, position?:GControlPosition)	None	將控件添加到地圖。地圖上的位置由可選的 position 參數(shù)確定。如果此參數(shù)不存在，則使用由 GControl.getDefaultPosition() 方法確定的控件默認(rèn)位置。一個(gè)控件實(shí)例只能向地圖中添加一次。
removeControl(control:GControl)	None	從地圖中刪除控件。如果控件從未被添加到地圖中，則該刪除不起任何作用。
getContainer()	Node	返回包含地圖的 DOM 對(duì)象。由 GControl.initialize() 使用。

地圖類型

方法返回值說(shuō)明

getMapTypes()	GMapType[]	返回在此地圖中注冊(cè)的地圖類型數(shù)組。
getCurrentMapType()	GMapType	返回當(dāng)前選中的地圖類型。
setMapType(type:GMapType)	None	選擇指定的新地圖類型。類型必須是地圖已知的類型。請(qǐng)參見(jiàn)構(gòu)造函數(shù)和方法 addMapType()。
addMapType(type:GMapType)	None	將新地圖類型添加到地圖中。有關(guān)怎樣定義自定義地圖類型的信息，請(qǐng)參見(jiàn) GMapType 部分。GMapType
removeMapType(type:GMapType)	None	從地圖中刪除地圖類型。會(huì)更新由 GMapTypeControl 或GHierarchicalMapTypeControl 顯示的按鈕集并觸發(fā)removemaptype 事件。

地圖狀態(tài)

方法返回值說(shuō)明

isLoaded()	Boolean	當(dāng)且僅當(dāng)?shù)貓D在創(chuàng)建后使用 setCenter() 進(jìn)行初始化時(shí)，返回 true。
getCenter()	GLatLng	返回地圖視圖中心點(diǎn)的地理坐標(biāo)。
getBounds()	GLatLngBounds	返回地圖視圖的可視矩形區(qū)域（以地理坐標(biāo)表示）。
getBoundsZoomLevel(bounds:GLatLngBounds)	Number	返回指定矩形區(qū)域在地圖視圖中的縮放級(jí)別。縮放級(jí)別要按當(dāng)前選中的地圖類型計(jì)算。如果還未選擇地圖類型，將使用地圖類型列表中列出的第一個(gè)類型。
getSize()	GSize	返回地圖視圖的大小（以像素表示）。
getZoom()	Number	返回當(dāng)前的縮放級(jí)別。
getDragObject()	GDraggableObject	返回此地圖使用的可拖放對(duì)象。 （自 2.93 開(kāi)始）
getEarthInstance(callback:Function(instance: GEPlugin))	None	檢索附加到此地圖的 Google 地球?yàn)g覽器插件的實(shí)例，并在該實(shí)例準(zhǔn)備好接收命令時(shí)調(diào)用傳遞的回調(diào)函數(shù)，從而將地球?qū)嵗?#xff08;GEPlugin 對(duì)象）作為參數(shù)傳遞。 如果 Google 地球?qū)嵗郧耙淹ㄟ^(guò)設(shè)置 Google 地球地圖類型（通過(guò) GMap2.setMapType(G_SATELLITE_3D_MAP)）進(jìn)行了實(shí)例化，可能會(huì)立即觸發(fā)該回調(diào)函數(shù)。如果實(shí)例尚未創(chuàng)建，調(diào)用getEarthInstance 會(huì)初始化 Google 地球插件。（這種異步行為就是該方法需要回調(diào)的原因。） 注意：如果初始化遇到錯(cuò)誤，回調(diào)函數(shù)將傳遞 null 參數(shù)。 請(qǐng)注意，盡管該方法會(huì)創(chuàng)建 Google 地球?qū)嵗?#xff0c;但不會(huì)將 Google 地球地圖類型設(shè)置為當(dāng)前視圖。要執(zhí)行此操作，請(qǐng)顯式地調(diào)用GMap2.setMapType(G_SATELLITE_3D_MAP)，或讓用戶通過(guò)MapTypeControl 選擇此地圖類型。請(qǐng)參見(jiàn) Google 地球 API 開(kāi)發(fā)人員指南，以獲取有關(guān)怎樣使用 GEPlugin 對(duì)象的詳細(xì)信息。 （自 2.113 開(kāi)始）

修改地圖狀態(tài)

方法返回值說(shuō)明

setCenter(center:GLatLng, zoom?:Number, type?:GMapType)	None	按指定的中心設(shè)置地圖視圖。也可以同時(shí)設(shè)置縮放級(jí)別和地圖類型。地圖類型必須是地圖已知的類型。請(qǐng)參見(jiàn)構(gòu)造函數(shù)和方法 addMapType()。必須在構(gòu)造后先調(diào)用此方法，才能設(shè)置地圖的初始狀態(tài)。在調(diào)用此函數(shù)之前調(diào)用對(duì)新構(gòu)造的GMap2 對(duì)象執(zhí)行的操作，這是錯(cuò)誤的。
panTo(center:GLatLng)	None	將地圖的中心點(diǎn)更改為指定的點(diǎn)。如果該點(diǎn)已經(jīng)在當(dāng)前的地圖視圖中可見(jiàn)，則會(huì)以平滑動(dòng)畫(huà)的方式移動(dòng)中心點(diǎn)。
panBy(distance:GSize)	None	以動(dòng)畫(huà)方式平移指定的距離（以像素為單位）。
panDirection(dx:one of -1 0 +1, dy:one of -1 0 +1)	None	以動(dòng)畫(huà)方式向指示方向平移地圖寬度的一半。+1 是向右向下，-1 是向左向上。
setZoom(level:Number)	None	將縮放級(jí)別設(shè)置為指定的新值。
zoomIn()	None	將縮放級(jí)別加 1。
zoomOut()	None	將縮放級(jí)別減 1。
savePosition()	None	存儲(chǔ)當(dāng)前的地圖位置和縮放級(jí)別，以便以后用 returnToSavedPosition() 重新調(diào)用。
returnToSavedPosition()	None	恢復(fù)用 savePosition() 保存的地圖視圖。
checkResize()	None	通知地圖其容器大小已更改。在更改了容器 DOM 對(duì)象的大小后調(diào)用此方法，以便地圖能夠調(diào)整自己適合于新的大小。

疊加層

方法返回值說(shuō)明

addOverlay(overlay:GOverlay)	None	將疊加層添加到地圖中，并觸發(fā) addoverlay 事件。
removeOverlay(overlay:GOverlay)	None	從地圖中刪除疊加層。嘗試刪除不在地圖上的疊加層是錯(cuò)誤的。如果調(diào)用成功，會(huì)觸發(fā) removeoverlay 事件。
clearOverlays()	None	從地圖中刪除所有疊加層，并觸發(fā) clearoverlays 事件。
getPane(pane:GMapPane)	Node	返回層中包含 pane 識(shí)別的對(duì)象的 DIV。由 GOverlay 實(shí)例用于方法GOverlay.initialize() 的實(shí)例中，以在地圖上繪制它們自身。

信息窗口

方法返回值說(shuō)明

openInfoWindow(latlng:GLatLng, node:Node, opts?:GInfoWindowOptions)	None	在指定點(diǎn)處打開(kāi)一個(gè)簡(jiǎn)單的信息窗口。平移地圖，使得打開(kāi)的信息窗口完全可見(jiàn)。信息窗口的內(nèi)容為 DOM 節(jié)點(diǎn)。
openInfoWindowHtml(latlng:GLatLng, html:String, opts?:GInfoWindowOptions)	None	在指定點(diǎn)處打開(kāi)一個(gè)簡(jiǎn)單的信息窗口。平移地圖，使得打開(kāi)的信息窗口完全可見(jiàn)。信息窗口的內(nèi)容為 HTML 文本。
openInfoWindowTabs(latlng:GLatLng, tabs:GInfoWindowTab[], opts?:GinfoWindowOptions)	None	在指定點(diǎn)處打開(kāi)一個(gè)帶標(biāo)簽的信息窗口。平移地圖，使得打開(kāi)的信息窗口完全可見(jiàn)。信息窗口的內(nèi)容為 DOM 節(jié)點(diǎn)。
openInfoWindowTabsHtml(latlng:GLatLng, tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)	None	在指定點(diǎn)處打開(kāi)一個(gè)帶標(biāo)簽的信息窗口。平移地圖，使得打開(kāi)的信息窗口完全可見(jiàn)。信息窗口的內(nèi)容為 HTML 文本。
showMapBlowup(latlng:GLatLng, opts?:GInfoWindowOptions)	None	在指定的點(diǎn)打開(kāi)信息窗口，它包含地圖上該點(diǎn)附近的近景視圖。
updateInfoWindow(tabs:GInfoWindowTab[], onupdate?:Function)	None	更新當(dāng)前打開(kāi)的 GInfoWindow 對(duì)象的內(nèi)容，而不重新放置。信息窗口的大小將被調(diào)整，以便與新內(nèi)容相符。對(duì)信息窗口內(nèi)容實(shí)際進(jìn)行更改后，將調(diào)用可選的onupdate 回調(diào)函數(shù)。 （自 2.85 開(kāi)始）
updateCurrentTab(modifier:Function, onupdate?:Function)	None	會(huì)更新當(dāng)前選中的標(biāo)簽，從而調(diào)整 GInfoWindow 對(duì)象的大小，而不重新放置。modifier 函數(shù)用于修改當(dāng)前選中的標(biāo)簽并將GInfoWindowTab 作為參數(shù)傳遞。在信息窗口顯示新內(nèi)容后，調(diào)用可選的onupdate 回調(diào)函數(shù)。 （自 2.85 開(kāi)始）
closeInfoWindow()	None	關(guān)閉當(dāng)前打開(kāi)的信息窗口。
getInfoWindow()	GInfoWindow	返回此地圖的信息窗口對(duì)象。如果還沒(méi)有信息窗口，會(huì)創(chuàng)建一個(gè)，但該窗口不顯示。此操作不受 enableInfoWindow() 影響。

坐標(biāo)變換

方法返回值說(shuō)明

fromContainerPixelToLatLng(pixel:GPoint)	GLatLng	在含有頁(yè)面地圖的 DOM 元素中計(jì)算指定像素坐標(biāo)點(diǎn)的地理坐標(biāo)。此方法有助于實(shí)現(xiàn)自定義控件與地圖的交互。
fromLatLngToContainerPixel(latlng:GLatLng)	GPoint	在包含該頁(yè)面地圖的 DOM 元素中計(jì)算指定的地理位置的像素坐標(biāo)。 （自 2.100 開(kāi)始）
fromLatLngToDivPixel(latlng:GLatLng)	GPoint	計(jì)算指定地理位置在含有可拖動(dòng)地圖的 DOM 元素中的像素坐標(biāo)。為自定義疊加層實(shí)現(xiàn) GOverlay.redraw() 方法時(shí)，需要用此方法定位自定義疊加層。
fromDivPixelToLatLng(pixel:GPoint)	GLatLng	根據(jù)含有可拖動(dòng)地圖的 div 中的像素坐標(biāo)計(jì)算地理坐標(biāo)。此方法可能有助于實(shí)現(xiàn)與不擴(kuò)展 GOverlay 接口的自定義疊加層的交互。如果此方法沒(méi)有給出預(yù)期輸出，請(qǐng)嘗試使用fromContainerPixelToLatLng 方法。

事件

事件說(shuō)明

addmaptype(type:GMapType)	向地圖中添加地圖類型時(shí)會(huì)觸發(fā)此事件。
removemaptype(type:GMapType)	從地圖中刪除地圖類型時(shí)會(huì)觸發(fā)此事件。
click(overlay:GOverlay, latlng:GLatLng, overlaylatlng:GLatLng)	用戶用鼠標(biāo)點(diǎn)擊地圖時(shí)會(huì)觸發(fā)此事件。根據(jù)所點(diǎn)擊的環(huán)境的不同以及是否點(diǎn)擊了可點(diǎn)擊的疊加層，click 事件會(huì)傳遞不同的參數(shù)。如果點(diǎn)擊的不是可點(diǎn)擊疊加層，overlay 參數(shù)為null 并且 latlng 參數(shù)包含點(diǎn)擊點(diǎn)的地理坐標(biāo)。如果點(diǎn)擊的是clickable疊加層（如GMarker、GPolygon、GPolyline 或 GInfoWindow），overlay 參數(shù)包含疊加層對(duì)象，而overlaylatlng 參數(shù)會(huì)包含所點(diǎn)擊疊加層的坐標(biāo)。另外，還會(huì)在該疊加層自身上觸發(fā) click 事件。
dblclick(overlay:GOverlay, latlng:GLatLng)	雙擊地圖時(shí)會(huì)觸發(fā)此事件。注意，雙擊標(biāo)記或其他可點(diǎn)擊疊加層時(shí)不觸發(fā)此事件。被雙擊的點(diǎn)的地理坐標(biāo)將被傳遞到 latlng 參數(shù)中。overlay 參數(shù)始終設(shè)置為null。 （自 2.83 開(kāi)始）
singlerightclick(point:GPoint, src:Element, overlay?:GOverlay)	在地圖容器中觸發(fā) DOM contextmenu 事件時(shí)會(huì)觸發(fā)此事件。如果右鍵點(diǎn)擊某個(gè)標(biāo)記或其他可點(diǎn)擊疊加層，則該疊加層會(huì)傳遞到overlay 參數(shù)的事件處理程序中。右鍵點(diǎn)擊的這一點(diǎn)的像素坐標(biāo)（在包含地圖的 DOM 元素中）和 DOM 事件的源元素會(huì)分別傳遞到 point 和 src 參數(shù)中。注意，如果在啟用了雙擊縮放的情況下進(jìn)行右鍵雙擊，那么，地圖會(huì)縮小，并且不觸發(fā) singlerightclick 事件。但是，如果禁用了雙擊縮放，會(huì)觸發(fā)兩個(gè) singlerightclick 事件。 （自 2.84 開(kāi)始）
movestart()	地圖視圖開(kāi)始更改時(shí)會(huì)觸發(fā)此事件。執(zhí)行拖動(dòng)操作時(shí)或調(diào)用更改地圖視圖的方法時(shí)也會(huì)觸發(fā)此事件，前者還同時(shí)觸發(fā) dragstart 事件。
move()	更改地圖視圖時(shí)會(huì)觸發(fā)此事件，并且可能是重復(fù)觸發(fā)。
moveend()	結(jié)束地圖視圖的更改時(shí)會(huì)觸發(fā)此事件。
zoomend(oldLevel:Number, newLevel:Number)	地圖到達(dá)新的縮放級(jí)別時(shí)會(huì)觸發(fā)此事件。事件處理程序接收先前的縮放級(jí)別和新縮放級(jí)別作為參數(shù)。
maptypechanged()	選擇另一地圖類型時(shí)會(huì)觸發(fā)此事件。
infowindowopen()	打開(kāi)信息窗口時(shí)會(huì)觸發(fā)此事件。
infowindowbeforeclose()	關(guān)閉信息窗口前會(huì)觸發(fā)此事件。 （自 2.83 開(kāi)始）
infowindowclose()	關(guān)閉信息窗口時(shí)會(huì)觸發(fā)此事件。此事件在觸發(fā)前會(huì)觸發(fā) infowindowbeforeclose 事件。如果通過(guò)再次調(diào)用 openInfoWindow*() 在其他點(diǎn)重新打開(kāi)當(dāng)前已打開(kāi)的信息窗口，則會(huì)先后觸發(fā) infowindowbeforeclose、infowindowclose 和infowindowopen 事件。
addoverlay(overlay:GOverlay)	當(dāng)使用 addOverlay() 方法向地圖中添加單個(gè)疊加層時(shí)會(huì)觸發(fā)此事件。新的疊加層會(huì)作為參數(shù) overlay 傳遞到事件處理程序中。
removeoverlay(overlay:GOverlay)	當(dāng)使用 removeOverlay() 方法刪除單個(gè)疊加層時(shí)會(huì)觸發(fā)此事件。刪除的疊加層會(huì)作為參數(shù) overlay 傳遞到事件處理程序中。
clearoverlays()	當(dāng)使用 clearOverlays() 方法一次性刪除全部疊加層時(shí)會(huì)觸發(fā)此事件。
mouseover(latlng:GLatLng)	當(dāng)用戶將鼠標(biāo)從地圖外移動(dòng)到地圖上時(shí)會(huì)觸發(fā)此事件。
mouseout(latlng:GLatLng)	當(dāng)用戶將鼠標(biāo)移離地圖時(shí)會(huì)觸發(fā)此事件。
mousemove(latlng:GLatLng)	當(dāng)用戶在地圖中移動(dòng)鼠標(biāo)時(shí)會(huì)觸發(fā)此事件。
dragstart()	當(dāng)用戶開(kāi)始拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。
drag()	當(dāng)用戶拖動(dòng)地圖時(shí)會(huì)重復(fù)觸發(fā)此事件。
dragend()	當(dāng)用戶停止拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。
load()	當(dāng)完成地圖設(shè)置時(shí)會(huì)觸發(fā)此事件，并且 isLoaded() 會(huì)返回 true。這表示位置、縮放和地圖類型都已完成初始化，但可能還在載入圖塊。 （自 2.52 開(kāi)始）

GMapOptions 類

此類代表 GMap2 構(gòu)造函數(shù)的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

size	GSize	以像素為單位設(shè)置地圖大小。傳遞到地圖構(gòu)造函數(shù)的容器會(huì)調(diào)整為指定大小。默認(rèn)情況下，地圖會(huì)采用其容器的大小。
mapTypes	GMapType[]	此地圖要使用的地圖類型數(shù)組。默認(rèn)情況下使用 G_DEFAULT_MAP_TYPES。使用此選項(xiàng)可以限制地圖中顯示的預(yù)定義地圖類型集合，或者將自有的地圖類型傳遞到地圖中。另請(qǐng)參見(jiàn)GMap2.addMapType()。
draggableCursor	String	地圖可拖動(dòng)時(shí)顯示的光標(biāo)。 （自 2.59 開(kāi)始）
draggingCursor	String	拖動(dòng)地圖時(shí)顯示的光標(biāo)。 （自 2.59 開(kāi)始）
googleBarOptions	GGoogleBarOptions	該屬性指定配置 GGoogleBar 搜索控件的選項(xiàng)。當(dāng)構(gòu)造地圖時(shí)，會(huì)將這些選項(xiàng)傳遞到 GMapOptions 對(duì)象常量，當(dāng)調(diào)用GMap2.enableGoogleBar() 時(shí)，會(huì)使用這些選項(xiàng)構(gòu)造本地GGoogleBar 控件。 （自 2.95 開(kāi)始）
backgroundColor	String	該屬性指定地圖圖塊后要顯示的顏色。該顏色可以是任何有效的 W3C 標(biāo)準(zhǔn)顏色值。 （自 2.119 開(kāi)始）

GGoogleBarOptions 類

此類表示在 googleBarOptions 參數(shù)中傳遞到 GMapOptions 對(duì)象的選項(xiàng)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。請(qǐng)注意，與GInfoWindow 一樣，GGoogleBar 對(duì)象不會(huì)被構(gòu)造，但是會(huì)自動(dòng)添加到地圖對(duì)象中，并通過(guò)此處描述的屬性啟用。

屬性

屬性類型說(shuō)明

showOnLoad	Boolean	當(dāng)設(shè)置為 true 時(shí)，該屬性顯示 GoogleBar 中的搜索框（如果啟用了控件并加載了地圖）。默認(rèn)情況下，控件中的搜索框是隱藏的，只有當(dāng)點(diǎn)擊該控件的放大鏡時(shí)才會(huì)展開(kāi)。 （自 2.95 開(kāi)始）
linkTarget	GGoogleBarLinkTarget	該屬性允許指定嵌入 GoogleBar 的搜索結(jié)果中的鏈接目標(biāo)。默認(rèn)值為 G_GOOGLEBAR_LINK_TARGET_BLANK，該默認(rèn)值指定這些鏈接將在新窗口中打開(kāi)。 （自 2.95 開(kāi)始）
resultList	GGoogleBarResultList or Element	該屬性可讓您指定 GoogleBar 的搜索結(jié)果列表的樣式，該樣式可能為以下樣式的一種：G_GOOGLEBAR_RESULT_LIST_INLINE（默認(rèn)樣式）將結(jié)果列表放入搜索框上的表中；G_GOOGLEBAR_RESULT_LIST_SUPPRESS 使用“下一個(gè)”/“上一個(gè)”按鈕替換該列表；傳遞塊級(jí)別的 DOM 的Element 將列表放入您選擇的容器（通常為 <div> 元素）中。 （自 2.95 開(kāi)始）
suppressInitialResultSelection	Boolean	系統(tǒng)完成 GoogleBar 中的搜索后就會(huì)在其信息窗口中顯示第一個(gè)結(jié)果（這是默認(rèn)行為），該屬性抑制這種行為。 （自 2.95 開(kāi)始）
suppressZoomToBounds	Boolean	該屬性還抑制完成 GoogleBar 中的搜索后自動(dòng)平移和縮放以適合結(jié)果集的操作。（該屬性抑制默認(rèn)行為。） （自 2.95 開(kāi)始）
onIdleCallback	Function	該屬性指定 GoogleBar 完成搜索且搜索結(jié)果關(guān)閉時(shí)要調(diào)用的回調(diào)函數(shù)。 （自 2.95 開(kāi)始）
onSearchCompleteCallback	Function	該屬性指定 GoogleBar 完成搜索且搜索結(jié)果完全顯示時(shí)要調(diào)用的回調(diào)函數(shù)向該函數(shù)傳遞與搜索控件相關(guān)的 GlocalSearch 對(duì)象。在結(jié)果放到地圖上或結(jié)果列表中之前調(diào)用該回調(diào)函數(shù)。 （自 2.95 開(kāi)始）
onGenerateMarkerHtmlCallback	Function	此屬性可讓您指定打開(kāi)搜索結(jié)果標(biāo)記的信息窗口時(shí)要調(diào)用的回調(diào)函數(shù)。應(yīng)該向該函數(shù)先后傳遞 GMarker、生成的 HTML 字符串和GlocalSearchResult，并且該函數(shù)必須返回要顯示在信息窗口中的已修改 HTML 字符串。 （自 2.95 開(kāi)始）
onMarkersSetCallback	Function	該屬性可讓您指定 GGoogleBar 完成創(chuàng)建標(biāo)記并將標(biāo)記放到地圖上時(shí)要調(diào)用的回調(diào)函數(shù)。必須向該函數(shù)傳遞一個(gè)表格對(duì)象數(shù)組 {result: GlocalSearch, marker: GMarker}。 （自 2.95 開(kāi)始）

枚舉 GGoogleBarListingTypes

這些常數(shù)指定用戶在使用 GGoogleBar進(jìn)行本地搜索時(shí)返回結(jié)果的類型。在 GGoogleBarOptions.listingTypes 屬性中設(shè)置該搜索行為。

常數(shù)

常數(shù)說(shuō)明

G_GOOGLEBAR_TYPE_BLENDED_RESULTS	該常數(shù)表示 GGoogleBar 的搜索結(jié)果僅返回從已經(jīng)編入索引的 KML/KMZ/GeoRSS 等文件中得到的結(jié)果。 （自 2.113 開(kāi)始）
G_GOOGLEBAR_TYPE_KMLONLY_RESULTS	該常數(shù)表示 GGoogleBar 的搜索結(jié)果僅返回從已經(jīng)編入索引的 KML/KMZ/GeoRSS 等文件中得到的結(jié)果。 （自 2.113 開(kāi)始）
G_GOOGLEBAR_TYPE_LOCALONLY_RESULTS	該常數(shù)表示 GGoogleBar 的搜索結(jié)果僅返回商業(yè)結(jié)果和地址解析結(jié)果。 （自 2.113 開(kāi)始）

枚舉 GGoogleBarLinkTarget

這些常數(shù)被傳遞到 GGoogleBarOptions.linkTarget 中，定義結(jié)果信息窗口中的默認(rèn)鏈接目標(biāo)。

常數(shù)

常數(shù)說(shuō)明

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

這些常數(shù)被傳遞到 GGoogleBarOptions.resultList 中，定義怎樣顯示結(jié)果列表。

常數(shù)

常數(shù)說(shuō)明

G_GOOGLEBAR_RESULT_LIST_INLINE	這是默認(rèn)樣式，其結(jié)果使用列表形式顯示在地圖上。
G_GOOGLEBAR_RESULT_LIST_SUPPRESS	這是默認(rèn)樣式，其結(jié)果列表是隱藏的并替換為下一個(gè)/上一個(gè)按鈕。

枚舉 GMapPane

這些常數(shù)定義地圖及地圖上的對(duì)象為了顯示而使用的堆疊順序（z 順序）。每個(gè)窗格定義一組要顯示在地圖上的類似顯示對(duì)象，并且還會(huì)在地圖上定義唯一的 z 順序。z 順序較高的窗格會(huì)顯示在 z 順序較低的窗格的“頂部”。（請(qǐng)注意，指定窗格內(nèi)的對(duì)象也可能有自身的 z 順序優(yōu)先級(jí)；有的對(duì)象可能顯示在同窗格中其他對(duì)象的頂部。）

如果您通過(guò) GOverlay 進(jìn)行子類化，則需要使用這些常數(shù)，從而可以將自定義疊加層放入某個(gè)窗格中。

按照 z 順序從最低（底部）到最高（頂部）的順序列出以下常數(shù)。

常數(shù)

常數(shù)說(shuō)明

G_MAP_MAP_PANE	該窗格是 z 順序最低的窗格，在圖塊之上。
G_MAP_OVERLAY_LAYER_PANE	該窗格包含折線、多邊形、底面疊加層和圖塊疊加層。 （自 2.127 開(kāi)始）
G_MAP_MARKER_SHADOW_PANE	該窗格包含標(biāo)記陰影。
G_MAP_MARKER_PANE	該窗格包含標(biāo)記前景圖。
G_MAP_FLOAT_SHADOW_PANE	該窗格包含信息窗口陰影。它在 G_MAP_MARKER_PANE 之上，使得標(biāo)記可以位于信息窗口的陰影中。
G_MAP_MARKER_MOUSE_TARGET_PANE	此窗格包含透明元素，可為標(biāo)記接收 DOM 鼠標(biāo)事件。它在 G_MAP_FLOAT_SHADOW_PANE 之上，以便可以點(diǎn)擊信息窗口陰影中的標(biāo)記。
G_MAP_FLOAT_PANE	此窗格包含信息窗口。它在所有地圖疊加層之上。

GKeyboardHandler 類

對(duì)此類進(jìn)行實(shí)例化，以便向地圖中添加鍵盤(pán)綁定。該鍵盤(pán)綁定類似于地圖應(yīng)用程序的鍵盤(pán)綁定。

鍵操作

向上箭頭鍵，向下箭頭鍵，向左箭頭鍵，向右箭頭鍵	按下這些鍵時(shí)可連續(xù)移動(dòng)地圖。同時(shí)按下其中兩個(gè)鍵可對(duì)角移動(dòng)。
page down 鍵，page up 鍵，home 鍵，end 鍵	以相應(yīng)方向?qū)⒌貓D平移其 3/4 大小，以漂亮的動(dòng)畫(huà)顯示。其作用等同于 GLargeMapControl 和 GsmallMapControl 中的箭頭按鈕。
+，-	分別放大或縮小一個(gè)級(jí)別。其作用等同于 GLargeMapControl 和 GsmallMapControl 中的 + 和 - 按鈕。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GKeyboardHandler(map:GMap2)	為作為參數(shù)傳遞的地圖安裝鍵盤(pán)事件處理程序。

接口 GOverlay

地圖 API 庫(kù)中的 GMarker、GPolyline、GTileLayerOverlay 和 GInfoWindow 類都是通過(guò)此接口實(shí)現(xiàn)的。如果希望在地圖上顯示自定義的疊加層對(duì)象類型，可以實(shí)現(xiàn)這一功能。可使用GMap2.addOverlay() 方法將GOverlay 的實(shí)例放置于地圖上。然后，地圖在疊加層實(shí)例上調(diào)用GOverlay.initialize() 方法，先將自己顯示在地圖上。每當(dāng)?shù)貓D顯示更改時(shí)，地圖都會(huì)調(diào)用GOverlay.redraw()，這樣疊加層就可以在需要時(shí)對(duì)自己進(jìn)行重新放置。疊加層實(shí)例可使用方法GMap2.getPane() 獲取一個(gè)或多個(gè)自己要附加的 DOM 容器元素。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GOverlay()	此構(gòu)造函數(shù)為這些方法創(chuàng)建啞元實(shí)現(xiàn)。盡管如此，當(dāng)有繼承自此類的派生類時(shí)，派生類的構(gòu)造函數(shù)會(huì)調(diào)用此構(gòu)造函數(shù)以完成實(shí)現(xiàn)。

靜態(tài)方法

方法返回值說(shuō)明

GOverlay.getZIndex(latitude:Number)	Number	返回指定緯度的 CSS z-index 值。它計(jì)算 z 索引，使靠南的疊加層在靠北的疊加層之上，從而創(chuàng)建標(biāo)記疊加層的三維外觀。

抽象方法

方法返回值說(shuō)明

initialize(map:GMap2)	None	使用 GMap2.addOverlay() 向地圖中添加疊加層后，由地圖調(diào)用此方法。疊加層對(duì)象可以將其本身拖到地圖的各個(gè)窗格中，這些窗格可使用GMap2.getPane() 獲取。
remove()	None	使用 GMap2.removeOverlay() 或GMap2.clearOverlays() 從地圖中刪除疊加層后，由地圖調(diào)用此方法。此時(shí)，疊加層必須將自己從地圖窗格中刪除
copy()	GOverlay	返回疊加層的未初始化副本，可添加到地圖中。
redraw(force:Boolean)	None	此方法在地圖顯示更改后由地圖調(diào)用。如果更改了地圖視圖的縮放級(jí)別或像素偏移量，則參數(shù) force 將為 true，這樣需要重新計(jì)算像素坐標(biāo)。

GInfoWindow 類

GInfoWindow 沒(méi)有構(gòu)造函數(shù)。它是由地圖創(chuàng)建的，可使用GMap2.getInfoWindow() 方法訪問(wèn)。

方法

方法返回值說(shuō)明

selectTab(index:Number)	None	選擇指定索引對(duì)應(yīng)的標(biāo)簽。它的效果等同于點(diǎn)擊相應(yīng)標(biāo)簽。
hide()	None	隱藏信息窗口。注意：這不會(huì)關(guān)閉信息窗口。使用 show() 可重新顯示信息窗口。
show()	None	如果信息窗口當(dāng)前處于隱藏狀態(tài)，則可顯示信息窗口。
isHidden()	Boolean	當(dāng)且僅當(dāng)信息窗口處于隱藏狀態(tài)時(shí)，返回 true。這包括關(guān)閉狀態(tài)。
reset(latlng:GLatLng, tabs:GInfoWindowTab[], size:GSize, offset?:GSize, selectedTab?:Number)	None	重置信息窗口的狀態(tài)。每個(gè)參數(shù)都可能為 null，因此其值仍將保持為當(dāng)前值。
getPoint()	GLatLng	返回信息窗口錨定位置的地理坐標(biāo)。窗口的箭頭指向地圖中的該點(diǎn)（對(duì)像素偏移取整）。
getPixelOffset()	GSize	返回信息窗口的箭頭距離信息窗口在地圖上所錨定的地理坐標(biāo)點(diǎn)的像素偏移量。
getSelectedTab()	Number	返回當(dāng)前選定的標(biāo)簽的索引（從 0 開(kāi)始）。
getTabs()	GInfoWindowTabs[]	返回此信息窗口的標(biāo)簽數(shù)組。 （自 2.59 開(kāi)始）
getContentContainers()	Node[]	返回包含此信息窗口的標(biāo)簽內(nèi)容的 DOM 節(jié)點(diǎn)數(shù)組。 （自 2.59 開(kāi)始）
enableMaximize()	None	啟用信息窗口最大化。可最大化的信息窗口會(huì)展開(kāi)，使用通過(guò) GInfoWindowOptions 的maxContent 和 maxTitle 屬性指定的內(nèi)容填充大部分地圖。必須使用 maxContent 或maxTitle 選項(xiàng)打開(kāi)信息窗口，enableMaximize() 或 disableMaximize 才能生效。默認(rèn)情況下，使用maxContent 或 maxTitle 打開(kāi)的信息窗口會(huì)啟用最大化。 （自 2.93 開(kāi)始）
disableMaximize()	None	禁用信息窗口最大化。必須使用 maxContent 或 maxTitle 選項(xiàng)打開(kāi)信息窗口。注意，如果信息窗口當(dāng)前是打開(kāi)的，則此函數(shù)會(huì)移除最大化按鈕，但不會(huì)將該窗口恢復(fù)為最小化狀態(tài)。 （自 2.93 開(kāi)始）
maximize()	None	最大化信息窗口。必須使用 maxContent 或 maxTitle 選項(xiàng)打開(kāi)信息窗口，并且確保沒(méi)有通過(guò)disableMaximize 禁用信息窗口最大化。 （自 2.93 開(kāi)始）
restore()	None	將信息窗口恢復(fù)到其默認(rèn)（非最大化）狀態(tài)。必須使用 maxContent 或 maxTitle 選項(xiàng)打開(kāi)信息窗口。 （自 2.93 開(kāi)始）

事件

事件說(shuō)明

closeclick()	點(diǎn)擊信息窗口關(guān)閉按鈕時(shí)會(huì)觸發(fā)此事件。
maximizeclick()	表示此信息窗口將要最大化。 （自 2.93 開(kāi)始）
maximizeend()	表示此信息窗口已完成最大化。 （自 2.93 開(kāi)始）
restoreclick()	表示此信息窗口將要恢復(fù)到非最大化狀態(tài)。 （自 2.93 開(kāi)始）
restoreend()	表示此信息窗口已完成恢復(fù)到非最大化狀態(tài)的操作。 （自 2.93 開(kāi)始）

GInfoWindowTab 類

此類的實(shí)例數(shù)組可以作為 tabs 參數(shù)傳遞到方法 GMap2.openInfoWindowTabs()、GMap2.openInfoWindowTabsHtml()、GMarker.openInfoWindowTabs()、GMarker.openInfoWindowTabsHtml() 以及 GMarker.bindInfoWindow*() 變體中。如果數(shù)組包含多個(gè)元素，則將顯示帶有標(biāo)簽的信息窗口。每個(gè)InfoWindowTab 對(duì)象都包含兩個(gè)項(xiàng)目：content 定義選中標(biāo)簽時(shí)信息窗口的內(nèi)容，label 定義標(biāo)簽的標(biāo)簽。這些屬性將作為參數(shù)傳遞到構(gòu)造函數(shù)中。對(duì)于openInfoWindowTabs() 方法，content 為 DOM 節(jié)點(diǎn)。對(duì)于 openInfoWindowTabsHtml() 方法，content 為包含 HTML 文字的字符串。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GInfoWindowTab(label:String, content:Node or String)	創(chuàng)建一個(gè)可以在 tabs 參數(shù)中傳遞到 openInfoWindowTabs*() 方法的信息窗口標(biāo)簽數(shù)據(jù)結(jié)構(gòu)。

GInfoWindowOptions 類

此類的實(shí)例可用于類 GMap2 和GMarker 的方法openInfoWindow()、openInfoWindowHtml()、openInfoWindowTabs()、openInfoWindowTabsHtml()、變體bindInfoWindow*() 和 showMapBlowup() 的 opts? 參數(shù)中。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

正如此類的名稱所指明的一樣，所有屬性都是可選的。?

屬性類型說(shuō)明

selectedTab	Number	選擇指定索引（從 0 開(kāi)始）對(duì)應(yīng)的標(biāo)簽，而不是索引 0 對(duì)應(yīng)的第一個(gè)標(biāo)簽。
maxWidth	Number	信息窗口內(nèi)容的最大寬度（以像素表示）。
noCloseOnClick	Boolean	表明點(diǎn)擊地圖（未點(diǎn)中標(biāo)記）時(shí)是否應(yīng)關(guān)閉信息窗口。如果設(shè)置為 true，則在點(diǎn)擊地圖時(shí)不關(guān)閉信息窗口。默認(rèn)值為 false。 （自 2.83 開(kāi)始）
onOpenFn	Function	打開(kāi)信息窗口并顯示內(nèi)容后調(diào)用函數(shù)。
onCloseFn	Function	關(guān)閉信息窗口時(shí)調(diào)用函數(shù)。
zoomLevel	Number	僅限于 showMapBlowup()。信息窗口中放大地圖的縮放級(jí)別。
mapType	GMapType	僅限于 showMapBlowup()。信息窗口中放大地圖的地圖類型。
maxContent	String	指定最大化信息窗口時(shí)要顯示的內(nèi)容。該內(nèi)容可以為 HTML 字符串或 HTML DOM 元素。 （自 2.93 開(kāi)始）
maxTitle	String	指定最大化信息窗口時(shí)要顯示的標(biāo)題。該內(nèi)容可以為 HTML 字符串或 HTML DOM 元素。 （自 2.93 開(kāi)始）
pixelOffset	GSize	指定要在向上 (x) 方向和向右 (y) 方向從指定的 GLatLng 移動(dòng)信息窗口所移動(dòng)的像素?cái)?shù)。 （自 2.98 開(kāi)始）

GMarker 類

GMarker 標(biāo)記地圖上的位置。它實(shí)現(xiàn)GOverlay 接口，因此可使用GMap2.addOverlay() 方法添加到地圖中。

標(biāo)記對(duì)象包含 latlng（這是標(biāo)記在地圖中錨定的地理位置）和 icon。如果未在構(gòu)造函數(shù)中設(shè)置 icon，則會(huì)使用默認(rèn)圖標(biāo) G_DEFAULT_ICON。

將標(biāo)記對(duì)象添加到地圖中后，通過(guò)標(biāo)記可打開(kāi)該地圖的信息窗口。標(biāo)記對(duì)象會(huì)觸發(fā)鼠標(biāo)事件和信息窗口事件。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMarker(latlng:GLatLng, icon?:GIcon, inert?:Boolean)	在傳遞的 GPoint 或GLatLng 的latlng 上創(chuàng)建帶有 icon 或 G_DEFAULT_ICON 的標(biāo)記。如果 inert 標(biāo)記為 true，則標(biāo)記不可點(diǎn)擊，也不會(huì)觸發(fā)任何事件。 （自 2.50 開(kāi)始不推薦使用）
GMarker(latlng:GLatLng, opts?:GMarkerOptions)	按 GMarkerOptions 中指定的選項(xiàng)在latlng 創(chuàng)建標(biāo)記。默認(rèn)情況下，標(biāo)記是可點(diǎn)擊的，并且有默認(rèn)圖標(biāo) G_DEFAULT_ICON。 （自 2.50 開(kāi)始）

方法

將標(biāo)記添加到地圖中后，才能調(diào)用這些方法。

方法返回值說(shuō)明

openInfoWindow(content:Node, opts?:GInfoWindowOptions)	None	通過(guò)標(biāo)記圖標(biāo)打開(kāi)地圖信息窗口。信息窗口的內(nèi)容為 DOM 節(jié)點(diǎn)。只適用于 GInfoWindowOptions.maxWidth 選項(xiàng)。
openInfoWindowHtml(content:String, opts?:GInfoWindowOptions)	None	通過(guò)標(biāo)記圖標(biāo)打開(kāi)地圖信息窗口。信息窗口的內(nèi)容為包含 HTML 文本的字符串。只適用于 GInfoWindowOptions.maxWidth 選項(xiàng)。
openInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)	None	通過(guò)標(biāo)記圖標(biāo)打開(kāi)帶標(biāo)簽的地圖信息窗口。信息窗口的內(nèi)容為標(biāo)簽數(shù)組，這些標(biāo)簽包含 DOM 節(jié)點(diǎn)形式的標(biāo)簽內(nèi)容。只適用于 GInfoWindowOptions.maxWidth 和InfoWindowOptions.selectedTab 選項(xiàng)。
openInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)	None	通過(guò)標(biāo)記圖標(biāo)打開(kāi)帶標(biāo)簽的地圖信息窗口。信息窗口的內(nèi)容為標(biāo)簽數(shù)組，這些標(biāo)簽所包含的標(biāo)簽內(nèi)容是包含 HTML 文本的字符串。只適用于InfoWindowOptions.maxWidth 和 InfoWindowOptions.selectedTab 選項(xiàng)。
bindInfoWindow(content:Node, opts?:GInfoWindowOptions)	None	將指定的 DOM 節(jié)點(diǎn)綁定到此標(biāo)記。當(dāng)點(diǎn)擊標(biāo)記時(shí)，此節(jié)點(diǎn)中的內(nèi)容會(huì)自動(dòng)顯示在信息窗口中。將 null 作為content 傳遞來(lái)解除綁定。 （自 2.85 開(kāi)始）
bindInfoWindowHtml(content:String, opts?:GInfoWindowOptions)	None	將指定的 HTML 綁定到此標(biāo)記。當(dāng)點(diǎn)擊標(biāo)記時(shí)，HTML 內(nèi)容將自動(dòng)顯示在信息窗口中。將 null 作為 content 傳遞來(lái)解除綁定。 （自 2.85 開(kāi)始）
bindInfoWindowTabs(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)	None	將指定的 GInfoWindowTab（作為 DOM 節(jié)點(diǎn)提供）綁定到此標(biāo)記。當(dāng)點(diǎn)擊標(biāo)記時(shí)，這些標(biāo)簽節(jié)點(diǎn)中的內(nèi)容會(huì)自動(dòng)顯示在信息窗口中。將null 作為 tabs 傳遞來(lái)解除綁定。 （自 2.85 開(kāi)始）
bindInfoWindowTabsHtml(tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)	None	將指定的 GInfoWindowTab（作為 HTML 字符串提供）綁定到此標(biāo)記。當(dāng)點(diǎn)擊標(biāo)記時(shí)，這些標(biāo)簽中的 HTML 內(nèi)容會(huì)自動(dòng)顯示在信息窗口中。將null 作為 tabs 傳遞來(lái)解除綁定。 （自 2.85 開(kāi)始）
closeInfoWindow()	None	僅關(guān)閉屬于此標(biāo)記的信息窗口。 （自 2.85 開(kāi)始）
showMapBlowup(opts?:GInfoWindowOptions)	None	通過(guò)標(biāo)記圖標(biāo)打開(kāi)地圖信息窗口。信息窗口的內(nèi)容是標(biāo)記位置周圍的近景地圖。只適用于 InfoWindowOptions.zoomLevel 和InfoWindowOptions.mapType 選項(xiàng)。
getIcon()	GIcon	根據(jù)構(gòu)造函數(shù)的設(shè)置返回此標(biāo)記的 icon。
getTitle()	String	根據(jù)構(gòu)造函數(shù)通過(guò) GMarkerOptions.title 屬性的設(shè)置，返回此標(biāo)記的標(biāo)題。如果未傳入標(biāo)題，則返回“undefined”。 （自 2.85 開(kāi)始）
getPoint()	GLatLng	根據(jù)構(gòu)造函數(shù)或 setPoint() 的設(shè)置，返回此標(biāo)記錨定的地理坐標(biāo)。 （自 2.88 開(kāi)始不推薦使用）
getLatLng()	GLatLng	根據(jù)構(gòu)造函數(shù)或 setLatLng() 的設(shè)置，返回此標(biāo)記錨定的地理坐標(biāo)。 （自 2.88 開(kāi)始）
setPoint(latlng:GLatLng)	None	設(shè)置此標(biāo)記的錨定點(diǎn)的地理坐標(biāo)。 （自 2.88 開(kāi)始不推薦使用）
setLatLng(latlng:GLatLng)	None	設(shè)置此標(biāo)記的錨定點(diǎn)的地理坐標(biāo)。 （自 2.88 開(kāi)始）
enableDragging()	None	允許在地圖上拖放標(biāo)記。該方法只有在已經(jīng)用 GMarkerOptions.draggable = true 初始化標(biāo)記的情況下才生效。
disableDragging()	None	禁止在地圖上拖放標(biāo)記。
draggable()	Boolean	如果已使用 GMarkerOptions.draggable = true 通過(guò)構(gòu)造函數(shù)對(duì)標(biāo)記進(jìn)行了初始化，則返回true。否則，返回 false。
draggingEnabled()	Boolean	如果當(dāng)前允許用戶在地圖中拖動(dòng)標(biāo)記，則返回 true。
setImage(url:String)	None	請(qǐng)求將 url 指定的圖像設(shè)置為此標(biāo)記的前景圖。注意，不調(diào)整打印圖像和陰影圖像。因此，此方法主要是為了達(dá)到高亮顯示或變暗顯示效果，而不是徹底改變標(biāo)記的外觀。 （自 2.75 開(kāi)始）
hide()	None	如果當(dāng)前標(biāo)記可見(jiàn)，則隱藏標(biāo)記。注意，如果當(dāng)前標(biāo)記可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GMarker.visibilitychanged 事件。 （自 2.77 開(kāi)始）
show()	None	如果當(dāng)前標(biāo)記不可見(jiàn)，則顯示標(biāo)記。請(qǐng)注意，如果當(dāng)前標(biāo)記不可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GMarker.visibilitychanged 事件。 （自 2.77 開(kāi)始）
isHidden()	Boolean	如果當(dāng)前標(biāo)記不可見(jiàn)，則返回 true。否則，返回 false。 （自 2.77 開(kāi)始）

事件

只有當(dāng)標(biāo)記處于活動(dòng)狀態(tài)時(shí)，才會(huì)觸發(fā)上述所有事件（請(qǐng)參見(jiàn)構(gòu)造函數(shù)）。

事件說(shuō)明

click(latlng:GLatLng)	點(diǎn)擊標(biāo)記圖標(biāo)時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。請(qǐng)注意，同時(shí)還會(huì)使地圖觸發(fā)此事件，將標(biāo)記作為第一個(gè)參數(shù)傳遞到那里的事件處理程序中。
dblclick(latlng:GLatLng)	雙擊標(biāo)記圖標(biāo)時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。請(qǐng)注意，不會(huì)使地圖觸發(fā)此事件，因?yàn)榈貓D雙擊時(shí)居中是固定行為。
mousedown(latlng:GLatLng)	在標(biāo)記圖標(biāo)上觸發(fā) DOM mousedown 事件時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。請(qǐng)注意，標(biāo)記會(huì)停止 mousedown DOM 事件，這樣就不會(huì)導(dǎo)致地圖開(kāi)始拖動(dòng)。
mouseup(latlng:GLatLng)	在標(biāo)記上觸發(fā) DOM mouseup 事件時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。請(qǐng)注意，標(biāo)記不會(huì)停止 mousedown DOM 事件，因?yàn)樗粫?huì)干擾地圖的拖動(dòng)處理程序。
mouseover(latlng:GLatLng)	當(dāng)鼠標(biāo)進(jìn)入標(biāo)記圖標(biāo)區(qū)域時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。
mouseout(latlng:GLatLng)	當(dāng)鼠標(biāo)離開(kāi)標(biāo)記圖標(biāo)區(qū)域時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。
infowindowopen()	當(dāng)通過(guò)此標(biāo)記打開(kāi)地圖的信息窗口時(shí)會(huì)觸發(fā)此事件。
infowindowbeforeclose()	關(guān)閉通過(guò)此標(biāo)記打開(kāi)的地圖信息窗口前會(huì)觸發(fā)此事件。 （自 2.83 開(kāi)始）
infowindowclose()	關(guān)閉通過(guò)此標(biāo)記打開(kāi)的地圖信息窗口時(shí)會(huì)觸發(fā)此事件。關(guān)閉信息窗口或在其他標(biāo)記或在地圖上打開(kāi)信息窗口時(shí)，都會(huì)觸發(fā)此事件。此事件在觸發(fā)前會(huì)觸發(fā) infowindowbeforeclose 事件。
remove()	使用 GMap2.removeOverlay() 或GMap2.clearOverlays() 從地圖刪除標(biāo)記時(shí)會(huì)觸發(fā)此事件。
dragstart(latlng:GLatLng)	如果啟用了標(biāo)記的拖動(dòng)操作，則在開(kāi)始拖動(dòng)標(biāo)記時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。
drag(latlng:GLatLng)	如果啟用了標(biāo)記的拖動(dòng)操作，則在拖動(dòng)標(biāo)記的過(guò)程中會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。
dragend(latlng:GLatLng)	如果啟用了標(biāo)記的拖動(dòng)操作，則在停止拖動(dòng)標(biāo)記時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入標(biāo)記的當(dāng)前坐標(biāo)。
visibilitychanged(isVisible:Boolean)	當(dāng)標(biāo)記的可見(jiàn)性發(fā)生更改時(shí)會(huì)觸發(fā)此事件（即可見(jiàn)性從可見(jiàn)更改為隱藏時(shí)，或從隱藏更改為可見(jiàn)時(shí)）。isVisible 指發(fā)生可見(jiàn)性更改后標(biāo)記的狀態(tài)。 （自 2.77 開(kāi)始）

GMarkerOptions 類

此類的實(shí)例可用于 GMarker 類構(gòu)造函數(shù)的opts? 參數(shù)中。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

正如此類的名稱所指明的一樣，所有屬性都是可選的。

屬性類型說(shuō)明

icon	GIcon	為此類選擇圖標(biāo)。如果未指定，則使用 G_DEFAULT_ICON。 （自 2.50 開(kāi)始）
dragCrossMove	Boolean	正常拖動(dòng)標(biāo)記時(shí)，標(biāo)記將浮起并離開(kāi)光標(biāo)。將此值設(shè)置為 true 可以保持標(biāo)記位于光標(biāo)的下面，用十字光標(biāo)下移代替標(biāo)記浮起。此選項(xiàng)的默認(rèn)值為false。 （自 2.63 開(kāi)始）
title	String	此字符串顯示為標(biāo)記的工具提示，也就是它的作用等同于 HTML 元素中的 title 屬性。 （自 2.50 開(kāi)始）
clickable	Boolean	切換以選擇標(biāo)記是否可點(diǎn)擊。不可點(diǎn)擊或拖動(dòng)的標(biāo)記是不活動(dòng)的，它消耗的資源較少但不對(duì)任何事件做出響應(yīng)。此選項(xiàng)的默認(rèn)值為 true，即如果未指定該選項(xiàng)，則標(biāo)記為可點(diǎn)擊的。 （自 2.50 開(kāi)始）
draggable	Boolean	切換以選擇用戶是否可拖動(dòng)標(biāo)記。設(shè)置為可拖動(dòng)的標(biāo)記比設(shè)置為可點(diǎn)擊的標(biāo)記所需的資源更多。可拖動(dòng)的標(biāo)記同時(shí)也是可點(diǎn)擊的標(biāo)記，默認(rèn)情況下啟用彈跳效果和自動(dòng)平移。此選項(xiàng)的默認(rèn)值為false。 （自 2.61 開(kāi)始）
bouncy	Boolean	切換拖動(dòng)完標(biāo)記后是否應(yīng)上下彈動(dòng)。此選項(xiàng)的默認(rèn)值為 false。 （自 2.61 開(kāi)始）
bounceGravity	Number	此數(shù)字用于定義完成拖動(dòng)操作時(shí)標(biāo)記在彈到地面期間的加速度。此選項(xiàng)的默認(rèn)值為 1。 （自 2.61 開(kāi)始）
autoPan	Boolean	將標(biāo)記拖到邊緣時(shí)自動(dòng)平移地圖。如果標(biāo)記是可拖動(dòng)的，則此選項(xiàng)的默認(rèn)值為 true。 （自 2.87 開(kāi)始）
zIndexProcess	Function	此函數(shù)用于在標(biāo)記疊加到地圖上時(shí)更改標(biāo)記的 z-Index 順序，當(dāng)其信息窗口打開(kāi)時(shí)也調(diào)用該函數(shù)。默認(rèn)順序是越靠南的標(biāo)記越靠上。此函數(shù)被傳遞到 GMarker 對(duì)象中，返回一個(gè)表示新 z-index 的數(shù)字。 （自 2.98 開(kāi)始）
hide	Boolean	設(shè)置為 true 時(shí)，表示地圖不應(yīng)一開(kāi)始就顯示 GMarker。要打開(kāi)疊加層，請(qǐng)調(diào)用GMarker.show()。默認(rèn)情況下，該值設(shè)置為 false。 （自 2.139 開(kāi)始）

GPolyline 類

這是一種使用瀏覽器的矢量制圖工具（如果可用）在地圖上繪制折線的地圖疊加層，或者是來(lái)自 Google 服務(wù)器的圖像疊加層。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GPolyline(latlngs:GLatLng[], color?:String, weight?:Number, opacity?:Number, opts?:GPolylineOptions)	根據(jù)頂點(diǎn)數(shù)組創(chuàng)建折線。color 是一個(gè)字符串，包含十六進(jìn)制數(shù)字、HTML 樣式的顏色，如 #RRGGBB。weight 是以像素為單位的線寬度。opacity 為 0 到 1 之間的數(shù)字。該線條平滑且半透明。

工廠方法

方法返回值說(shuō)明

GPolyline.fromEncoded(color?:String, weight?:Number, opacity?:Number, latlngs:String, zoomFactor:Number, levels:String, numLevels:Number)	GPolyline	根據(jù)聚合坐標(biāo)和級(jí)別的編碼字符串創(chuàng)建折線。color 是一個(gè)字符串，包含十六進(jìn)制數(shù)字、HTML 樣式的顏色，如 #RRGGBB。weight 是以像素為單位的線寬。opacity 是介于 0 和 1 之間的數(shù)字。latlngs 是包含已編碼的經(jīng)度和緯度坐標(biāo)的字符串。levels 是包含已編碼的折線縮放級(jí)別組的字符串。numLevels 是已編碼的levels 字符串中包含的縮放級(jí)別數(shù)。zoomFactor 是編碼的 levels 字符串中相鄰縮放級(jí)別組合之間的倍數(shù)。這兩個(gè)值結(jié)合使用可確定已編碼的折線中l(wèi)evels 的精確度。該線條是防鋸齒且半透明的。 （自 2.63 開(kāi)始）

方法

方法返回值說(shuō)明

deleteVertex(index:Number)	None	刪除折線中含有指定索引值的頂點(diǎn)并相應(yīng)更新折線的形狀。必須已通過(guò) GMap2.addOverlay() 將GPolyline 添加到地圖中。 （自 2.111 開(kāi)始）
disableEditing()	None	撤消 enableEditing 的效果，從而刪除線上的所有控制點(diǎn)并顯示為用戶不可編輯。 （自 2.111 開(kāi)始）
enableDrawing(opts?:GPolyEditingOptions)	None	允許用戶通過(guò)點(diǎn)擊地圖上的其他點(diǎn)構(gòu)造（或修改）GPolyline 對(duì)象。必須已通過(guò)GMap2.addOverlay() 將GPolyline 添加到地圖中，即使折線最初未填充任何內(nèi)容，也不包含任何頂點(diǎn)。每點(diǎn)擊一次都會(huì)向折線鏈添加一個(gè)附加“頂點(diǎn)”，可通過(guò)雙擊或再次點(diǎn)擊最后添加的點(diǎn)來(lái)結(jié)束制圖，如果折線順利繪制完，會(huì)在最后添加的點(diǎn)處觸發(fā)“endline”事件，否則，會(huì)觸發(fā)“cancelline”事件，但是不會(huì)從地圖上刪除折線。如果要修改現(xiàn)有GPolyline，則會(huì)從現(xiàn)有折線的起點(diǎn)或終點(diǎn)連接頂點(diǎn)，這在可選參數(shù)GPolyEditingOptions.fromStart 中指定。 （自 2.111 開(kāi)始）
enableEditing(opts?:GPolyEditingOptions)	None	允許修改點(diǎn)的現(xiàn)有 GPolyline 鏈。如果啟用，則用戶可以選擇并拖動(dòng)現(xiàn)有頂點(diǎn)。除非在GPolyEditingOptions 中通過(guò)maxVertices 指定了小于當(dāng)前頂點(diǎn)數(shù)的頂點(diǎn)限制，否則還將在折線部分的中點(diǎn)處添加“假性控制”點(diǎn)，從而可讓用戶通過(guò)點(diǎn)擊和拖動(dòng)這些附加頂點(diǎn)加入新頂點(diǎn)。每當(dāng)添加或移動(dòng)頂點(diǎn)時(shí)，都會(huì)觸發(fā)“l(fā)ineupdated”事件。 （自 2.111 開(kāi)始）
getVertexCount()	Number	返回折線中頂點(diǎn)的數(shù)目。 （自 2.46 開(kāi)始）
getVertex(index:Number)	GLatLng	返回折線中指定索引對(duì)應(yīng)的頂點(diǎn)。 （自 2.46 開(kāi)始）
getLength()	Number	返回沿地球表面的折線的長(zhǎng)度（以米為單位）。 （自 2.85 開(kāi)始）
getBounds()	GLatLngBounds	返回此折線的邊界。 （自 2.85 開(kāi)始）
hide()	None	如果當(dāng)前折線可見(jiàn)并且 GPolyline.supportsHide() 返回true，則隱藏此折線。注意，如果當(dāng)前折線可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GPolyline.visibilitychanged 事件。 （自 2.87 開(kāi)始）
insertVertex(index:Number, latlng:GLatLng)	None	在折線中的指定索引處插于一個(gè)新點(diǎn)并更新其形狀。必須已通過(guò) GMap2.addOverlay() 將GPolyline 添加到地圖中。 （自 2.111 開(kāi)始）
isHidden()	Boolean	如果當(dāng)前折線不可見(jiàn)，則返回 true。否則，返回 false。 （自 2.87 開(kāi)始）
show()	None	如果當(dāng)前折線不可見(jiàn)，則顯示該折線。注意，如果當(dāng)前折線不可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GPolyline.visibilitychanged 事件。 （自 2.87 開(kāi)始）
supportsHide()	Boolean	如果當(dāng)前環(huán)境下支持 GPolyline 對(duì)象的GPolyline.hide()，則返回true。否則，返回 false。 （自 2.87 開(kāi)始）
setStrokeStyle(style:GPolyStyleOptions)	None	更改折線的樣式。必須已通過(guò) GMap2.addOverlay() 將GPolyline 添加到地圖中。 （自 2.111 開(kāi)始）

事件

事件說(shuō)明

remove()	使用 GMap2.removeOverlay() 或GMap2.clearOverlays()從地圖刪除折線時(shí)會(huì)觸發(fā)此事件。
visibilitychanged(isVisible:Boolean)	當(dāng)折線的可見(jiàn)性狀態(tài)從可見(jiàn)更改為不可見(jiàn)或從不可見(jiàn)更改為可見(jiàn)時(shí)會(huì)觸發(fā)此事件。isVisible 參數(shù)反映完成此可見(jiàn)性狀態(tài)的更改后折線的狀態(tài)。 （自 2.87 開(kāi)始）
click(latlng:GLatLng)	點(diǎn)擊折線時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入線條的已點(diǎn)擊坐標(biāo)。請(qǐng)注意，此事件隨后還會(huì)觸發(fā)地圖上的“click”事件，在該事件中折線作為overlay 參數(shù)傳遞。 （自 2.88 開(kāi)始）
mouseover()	鼠標(biāo)移動(dòng)到折線上時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
mouseout()	鼠標(biāo)離開(kāi)折線時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
lineupdated()	更新折線的樣式或形狀時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
endline()	用戶完成線的繪制（通過(guò)調(diào)用 GPolyline.enableDrawing 開(kāi)始）時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
cancelline()	用戶中斷線的繪制（通過(guò)調(diào)用 GPolyline.enableDrawing 開(kāi)始）時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）

GPolylineOptions 類

此類的實(shí)例用于 GPolyline 的構(gòu)造函數(shù)中。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

正如此類的名稱所指明的一樣，所有屬性都是可選的。

屬性類型說(shuō)明

clickable	Boolean	切換以選擇折線是否可點(diǎn)擊。此選項(xiàng)的默認(rèn)值為 true，即未指定該選項(xiàng)時(shí)，折線可點(diǎn)擊。 （自 2.91 開(kāi)始）
geodesic	Boolean	將折線的每個(gè)邊渲染為測(cè)地線（大圓的一段）。測(cè)地線是沿地球表面的兩個(gè)點(diǎn)之間的最近路徑。 （自 2.84 開(kāi)始）

GPolyEditingOptions 類

此類的實(shí)例用于 GPolyline 和GPolygon 的enableEditing 方法中。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

正如此類的名稱所指明的一樣，所有屬性都是可選的。

屬性類型說(shuō)明

maxVertices	Number	此屬性指定可用于該折線的最大頂點(diǎn)數(shù)。一旦達(dá)到此最大數(shù)，就不再添加頂點(diǎn)。 （自 2.111 開(kāi)始）
fromStart	Boolean	此屬性指定 enableDrawing 是否應(yīng)從起點(diǎn)而不是端點(diǎn)（默認(rèn)值）添加點(diǎn)。 （自 2.111 開(kāi)始）

GPolyStyleOptions 類

此類的實(shí)例用于 GPolyline 和GPolygon 的setStrokeStyle 方法以及 GPolygon 的setFillStyle 方法中。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

正如此類的名稱所指明的一樣，所有屬性都是可選的。

屬性類型說(shuō)明

color	String	此屬性指定一個(gè)字符串，包含十六進(jìn)制數(shù)字、HTML 樣式的顏色，如 #RRGGBB。 （自 2.111 開(kāi)始）
weight	Number	此屬性指定以像素為單位的線寬。 （自 2.111 開(kāi)始）
opacity	Number	此屬性將折線的不透明度指定為 0（透明）和 1（不透明）之間的分?jǐn)?shù)值。 （自 2.111 開(kāi)始）

GPolygon 類

這除了可另外指定填充色和不透明性外，其他方面都非常類似于 GPolyline。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GPolygon(latlngs:GLatLng[], strokeColor?:String, strokeWeight?:Number, strokeOpacity?:Number, fillColor?:Number, fillOpacity?:Number, opts?:GPolygonOptions)	根據(jù)頂點(diǎn)數(shù)組創(chuàng)建多邊形。colors 是一個(gè)字符串，包含十六進(jìn)制數(shù)字、HTML 樣式的顏色，如 #RRGGBB。weight 是以像素為單位的線寬度。opacities 為 0 到 1 之間的數(shù)字。該線條平滑且半透明。 （自 2.69 開(kāi)始）

工廠方法

方法返回值說(shuō)明

GPolygon.fromEncoded(polylines:encoded polylines[], fill?:Boolean, color?:String, opacity?:Number, outline?:Boolean)	GPolygon	根據(jù)聚合坐標(biāo)和級(jí)別的編碼字符串創(chuàng)建多邊形（由大量折線組成）。polylines 包含組成它的折線的關(guān)聯(lián)數(shù)組，其編碼格式與 GPolyline.fromEncoded 文檔中所描述的格式相同。fill 指定是否用某種color 填充該多邊形。opacity 和 outline 指定是否用折線的顏色、重量和不透明性畫(huà)多邊形。如果在折線中指定多個(gè)值，則采用折線的第一個(gè)值。 （自 2.78 開(kāi)始） GPolyline.fromEncoded

方法

方法返回值說(shuō)明

deleteVertex(index:Number)	None	使用多邊形中指定的索引刪除頂點(diǎn)并相應(yīng)更新多邊形的形狀。必須已通過(guò) GMap2.addOverlay() 將GPolygon 添加到地圖中。 （自 2.111 開(kāi)始）
disableEditing()	None	撤消 enableEditing 的效果，從而刪除線上的所有控制點(diǎn)并顯示為用戶不可編輯。 （自 2.111 開(kāi)始）
enableDrawing(opts?:GPolyEditingOptions)	None	允許用戶通過(guò)點(diǎn)擊地圖上的附加點(diǎn)構(gòu)造 GPolygon 對(duì)象。必須已通過(guò)GMap2.addOverlay() 將GPolyline 添加到地圖中，即使折線最初未填充任何內(nèi)容，也不包含任何頂點(diǎn)。每點(diǎn)擊一次都會(huì)向多邊形邊界添加一個(gè)附加“頂點(diǎn)”，可通過(guò)雙擊或點(diǎn)擊第一個(gè)點(diǎn)來(lái)完成形狀，從而結(jié)束制圖。如果多邊形順利繪制完，會(huì)在第一個(gè)點(diǎn)處觸發(fā)“endline”事件，否則，會(huì)觸發(fā)“cancelline”事件，但是不會(huì)從地圖上刪除折線。 （自 2.111 開(kāi)始）
enableEditing(opts?:GPolyEditingOptions)	None	允許修改現(xiàn)有的 GPolygon 邊界。如果啟用，則用戶可以選擇并拖動(dòng)現(xiàn)有頂點(diǎn)。除非在maxVertices 中通過(guò) GPolyEditingOptions 指定了小于當(dāng)前頂點(diǎn)數(shù)的頂點(diǎn)限制，否則還將在多邊形部分的中點(diǎn)處添加“假性控制”點(diǎn)，從而可讓用戶通過(guò)點(diǎn)擊和拖動(dòng)這些附加頂點(diǎn)加入新頂點(diǎn)。每當(dāng)添加或移動(dòng)頂點(diǎn)時(shí)，都會(huì)觸發(fā)“l(fā)ineupdated”事件。 （自 2.111 開(kāi)始）
getVertexCount()	Number	返回多邊形中的頂點(diǎn)數(shù)。 （自 2.69 開(kāi)始）
getVertex(index:Number)	GLatLng	返回多邊形中指定索引對(duì)應(yīng)的頂點(diǎn)。 （自 2.69 開(kāi)始）
getArea()	Number	返回以平方米表示的多邊形面積（假定地球是一個(gè)球形）。 （自 2.85 開(kāi)始）
getBounds()	GLatLngBounds	返回此多邊形的邊界。 （自 2.85 開(kāi)始）
hide()	None	如果多邊形可見(jiàn)并且 GPolygon.supportsHide 返回true，則隱藏該多邊形。請(qǐng)注意，如果當(dāng)前多邊形可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GPolygon.visibilitychanged 事件。 （自 2.87 開(kāi)始）
insertVertex(index:Number, latlng:GLatLng)	None	在多邊形中的指定索引處插入一個(gè)新點(diǎn)。必須已通過(guò) GMap2.addOverlay() 將GPolygon 添加到地圖中。 （自 2.111 開(kāi)始）
isHidden()	Boolean	如果當(dāng)前多邊形不可見(jiàn)，則返回 true。否則，返回 false。 （自 2.87 開(kāi)始）
show()	None	如果當(dāng)前多邊形不可見(jiàn)，則顯示該多邊形。請(qǐng)注意，如果當(dāng)前多邊形不可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GPolygon.visibilitychanged 事件。 （自 2.87 開(kāi)始）
supportsHide()	Boolean	如果當(dāng)前環(huán)境下支持 GPolygon 對(duì)象的GPolygon.hide()，則返回true。否則，返回 false。 （自 2.87 開(kāi)始）
setFillStyle(style:GPolyStyleOptions)	None	更改多邊形的填充樣式。必須已通過(guò) GMap2.addOverlay() 將GPolygon 添加到地圖中。 （自 2.111 開(kāi)始）
setStrokeStyle(style:GPolyStyleOptions)	None	更改多邊形的線條樣式。必須已通過(guò) GMap2.addOverlay() 將GPolygon 添加到地圖中。 （自 2.111 開(kāi)始）

事件

事件說(shuō)明

remove()	使用 GMap2.removeOverlay() 或GMap2.clearOverlays() 從地圖刪除多邊形時(shí)會(huì)觸發(fā)此事件。
visibilitychanged(isVisible:Boolean)	當(dāng)多邊形的可見(jiàn)性狀態(tài)從可見(jiàn)更改為不可見(jiàn)或從不可見(jiàn)更改為可見(jiàn)時(shí)會(huì)觸發(fā)此事件。isVisible 參數(shù)反映完成此可見(jiàn)性狀態(tài)的更改后多邊形的狀態(tài)。 （自 2.87 開(kāi)始）
click(latlng:GLatLng)	點(diǎn)擊多邊形時(shí)會(huì)觸發(fā)此事件，從而通過(guò)其 latlng 參數(shù)傳入多邊形的已點(diǎn)擊坐標(biāo)。請(qǐng)注意，此事件隨后還會(huì)觸發(fā)地圖上的“click”事件，在該事件中多邊形作為overlay 參數(shù)傳遞。 （自 2.88 開(kāi)始）
mouseover()	鼠標(biāo)移動(dòng)到多邊形區(qū)域時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
mouseout()	鼠標(biāo)離開(kāi)多邊形區(qū)域時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
lineupdated()	更新多邊形的樣式或形狀時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
endline()	用戶完成多邊形的繪制（通過(guò)調(diào)用 GPolyline.enableDrawing 開(kāi)始）時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）
cancelline()	用戶完成多邊形的繪制（通過(guò)調(diào)用 GPolyline.enableDrawing 開(kāi)始）時(shí)會(huì)觸發(fā)此事件。 （自 2.111 開(kāi)始）

GPolygonOptions 類

此類的實(shí)例用于 GPolygon 的構(gòu)造函數(shù)中。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

正如此類的名稱所指明的一樣，所有屬性都是可選的。

屬性類型說(shuō)明

clickable	Boolean	切換以選擇多邊形是否可點(diǎn)擊。此選項(xiàng)的默認(rèn)值為 true，即未指定該選項(xiàng)時(shí)，多邊形可點(diǎn)擊。 （自 2.91 開(kāi)始）

GScreenOverlay 類

該對(duì)象顯示地圖上的矩形圖像疊加層，其位置不會(huì)隨視口的改變而變化。用于 ScreenOverlays 的示例有圓規(guī)、徽標(biāo)和智能顯示技術(shù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GScreenOverlay(imageUrl:String, screenXY:GScreenPoint, overlayXY:GScreenPoint, size:GScreenSize)	創(chuàng)建來(lái)自某個(gè)圖像網(wǎng)址的屏幕疊加層，并按照 screenXY、overlayXY 和 size 參數(shù)的指定將其顯示在屏幕上。overlayXY 參數(shù)確定疊加層圖像上（或圖像外）的點(diǎn)，該點(diǎn)坐標(biāo)為screenXY。這可用于有效“修剪”圖像。screenXY 參數(shù)相對(duì)于屏幕原點(diǎn)（左下角）確定該疊加層圖像所對(duì)應(yīng)的點(diǎn)。 （自 2.92 開(kāi)始）

方法

方法返回值說(shuō)明

hide()	None	如果當(dāng)前屏幕疊加層可見(jiàn)，則隱藏它。請(qǐng)注意，如果當(dāng)前屏幕疊加層可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GScreenOverlay.visibilitychanged 事件。 （自 2.92 開(kāi)始）
isHidden()	Boolean	如果當(dāng)前屏幕疊加層不可見(jiàn)，則返回 true。否則，返回 false。 （自 2.92 開(kāi)始）
show()	None	如果當(dāng)前屏幕疊加層不可見(jiàn)，則顯示該疊加層。請(qǐng)注意，如果當(dāng)前屏幕疊加層不可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GScreenOverlay.visibilitychanged 事件。 （自 2.92 開(kāi)始）
supportsHide()	Boolean	總是返回 true。 （自 2.92 開(kāi)始）

事件

事件說(shuō)明

visibilitychanged(isVisible:Boolean)	當(dāng)屏幕疊加層的可見(jiàn)性狀態(tài)從可見(jiàn)更改為不可見(jiàn)或從不可見(jiàn)更改為可見(jiàn)時(shí)會(huì)觸發(fā)此事件。isVisible 參數(shù)反映完成此可見(jiàn)性狀態(tài)的更改后屏幕疊加層的狀態(tài)。 （自 2.92 開(kāi)始）

GScreenPoint 類

GScreenPoint 通過(guò) X 和 Y 坐標(biāo)標(biāo)識(shí)地圖視口上的點(diǎn)，其中每個(gè)坐標(biāo)都可以根據(jù)可選構(gòu)造函數(shù)參數(shù)的值表示相對(duì)或絕對(duì)定位。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GScreenPoint(x:Number, y:Number, xunits?:String, yunits?:String)	創(chuàng)建 GScreenPoint 對(duì)象。x 和y 坐標(biāo)也可以通過(guò)將“fraction”或“pixels”傳入 xunits 和 yunits 參數(shù)中表示相對(duì)或絕對(duì)定位。這些參數(shù)的默認(rèn)值為“pixels”。 （自 2.92 開(kāi)始）

屬性

屬性類型說(shuō)明

x	Number	x 坐標(biāo)向左增大。
y	Number	y 坐標(biāo)向下增大。
xunits	String	指定用于 x 坐標(biāo)的單位類型。將該單位設(shè)置為“fraction”表示相對(duì)于地圖大小的相對(duì)位置，而設(shè)置為“pixels”表示絕對(duì)定位。默認(rèn)情況下為絕對(duì)定位。
yunits	String	指定用于 y 坐標(biāo)的單位類型。將該單位設(shè)置為“fractional”表示相對(duì)于地圖大小的相對(duì)位置，而設(shè)置為“pixels”表示絕對(duì)定位。默認(rèn)情況下為絕對(duì)定位。

GScreenSize 類

GScreenSize 表示由width 和 height 參數(shù)確定的地圖的矩形區(qū)域大小。這些參數(shù)中的每個(gè)參數(shù)都可以根據(jù)可選構(gòu)造函數(shù)參數(shù)的值表示相對(duì)或像素大小。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GScreenSize(width:Number, height:Number, xunits?:String, yunits?:String)	創(chuàng)建 GScreenSize 對(duì)象。width 和height 坐標(biāo)可以通過(guò)“fraction”或“pixel”傳遞到 xunits 和 yunits 參數(shù)中表示相對(duì)或像素大小。width 和height 參數(shù)的默認(rèn)值為“pixel”。 （自 2.92 開(kāi)始）

屬性

屬性類型說(shuō)明

width	Number	屏幕實(shí)際使用面積的寬度參數(shù)。注意，該值可以根據(jù) GScreen.yunits 屬性的值表示相對(duì)或絕對(duì)像素值。
height	Number	屏幕實(shí)際使用面積的高度參數(shù)。注意，該值可以根據(jù) GScreen.yunits 屬性的值表示相對(duì)或絕對(duì)像素值。
xunits	String	指定用于 GScreenSize.width 屬性的單位類型。將該單位設(shè)置為“fractional”表示相對(duì)于地圖大小的相對(duì)位置，而設(shè)置為“pixel”表示像素定位。默認(rèn)情況下為像素定位。
yunits	String	指定用于 GScreenSize.height 屬性的單位類型。將該單位設(shè)置為“fractional”表示相對(duì)于地圖大小的相對(duì)位置，而設(shè)置為“pixel”表示像素定位。默認(rèn)情況下為像素定位。

GGroundOverlay 類

此對(duì)象可在地圖中創(chuàng)建矩形圖像疊加層，其邊界由 GLatLngBounds 定義。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GGroundOverlay(imageUrl:String, bounds:GLatLngBounds)	根據(jù)圖像網(wǎng)址及其邊界創(chuàng)建底面疊加層。 （自 2.79 開(kāi)始）

方法

方法返回值說(shuō)明

hide()	None	如果當(dāng)前底面疊加層可見(jiàn)，則隱藏它。請(qǐng)注意，如果當(dāng)前底面疊加層可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GGroundOverlay.visibilitychanged 事件。 （自 2.87 開(kāi)始）
isHidden()	Boolean	如果當(dāng)前底面疊加層不可見(jiàn)，則返回 true。否則，返回 false。 （自 2.87 開(kāi)始）
show()	None	如果當(dāng)前底面疊加層不可見(jiàn)，則顯示它。請(qǐng)注意，如果當(dāng)前底面疊加層不可見(jiàn)，則此函數(shù)會(huì)觸發(fā) GGroundOverlay.visibilitychanged 事件。 （自 2.87 開(kāi)始）
supportsHide()	Boolean	總是返回 true。 （自 2.87 開(kāi)始）

事件

事件說(shuō)明

visibilitychanged(isVisible:Boolean)	當(dāng)?shù)酌姣B加層的可見(jiàn)性狀態(tài)從可見(jiàn)更改為不可見(jiàn)或從不可見(jiàn)更改為可見(jiàn)時(shí)會(huì)觸發(fā)此事件。isVisible 參數(shù)反映完成此可見(jiàn)性狀態(tài)的更改后底面疊加層的狀態(tài) （自 2.77 開(kāi)始）

GIcon 類

圖標(biāo)指定用來(lái)在地圖上顯示 GMarker 的圖像。由于瀏覽器兼容性的原因，要指定一個(gè)圖標(biāo)實(shí)際上相當(dāng)復(fù)雜。請(qǐng)注意，如果不想指定自己的圖標(biāo)，則可使用默認(rèn) Google 地圖圖標(biāo)G_DEFAULT_ICON。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GIcon(copy?:GIcon, image?:String)	創(chuàng)建新圖標(biāo)對(duì)象。如果可選的 copy 參數(shù)中給出另一個(gè)圖標(biāo)，則將復(fù)制其屬性，否則將留為空白。可選的參數(shù) image 可設(shè)置image 屬性的值。

常數(shù)

常數(shù)說(shuō)明

G_DEFAULT_ICON	標(biāo)記使用的默認(rèn)圖標(biāo)。

屬性

屬性類型說(shuō)明

image	String	圖標(biāo)的前景圖像網(wǎng)址。
shadow	String	圖標(biāo)的陰影圖像網(wǎng)址。
iconSize	GSize	圖標(biāo)前景圖像的像素大小。
shadowSize	GSize	陰影圖像的像素大小。
iconAnchor	GPoint	此圖標(biāo)在地圖上的錨定點(diǎn)相對(duì)于圖標(biāo)圖像左上角的像素坐標(biāo)。
infoWindowAnchor	GPoint	信息窗口在此圖標(biāo)上的錨定點(diǎn)相對(duì)于圖標(biāo)圖像左上角的像素坐標(biāo)。
printImage	String	打印地圖所用的前景圖標(biāo)圖像網(wǎng)址。其大小必須與 image 提供的主圖標(biāo)圖像的大小相同。
mozPrintImage	String	用 Firefox/Mozilla 打印地圖時(shí)所用的前景圖標(biāo)圖像網(wǎng)址。其大小必須與 image 提供的主圖標(biāo)圖像的大小相同。
printShadow	String	打印地圖時(shí)所用的陰影圖像網(wǎng)址。由于大多數(shù)瀏覽器都無(wú)法打印 PNG 圖像，所以圖像格式應(yīng)該為 GIF。
transparent	String	在 Internet Explorer 中捕獲點(diǎn)擊事件時(shí)，所用的透明前景圖標(biāo)圖像網(wǎng)址。此圖像應(yīng)是具有 1% 不透明性的 24 位 PNG 格式的主圖標(biāo)圖像，但其大小和形狀同主圖標(biāo)相同。
imageMap	Number[]	表示圖像地圖 x/y 坐標(biāo)的整數(shù)數(shù)組，用它指定瀏覽器（非 Internet Explorer）中圖標(biāo)圖像的可點(diǎn)擊部分。
maxHeight	Integer	指定拖動(dòng)標(biāo)記時(shí)視覺(jué)上垂直“上升”的距離（以像素表示）。 （自 2.79 開(kāi)始）
dragCrossImage	String	指定拖動(dòng)圖標(biāo)時(shí)十字交叉圖像的網(wǎng)址。 （自 2.79 開(kāi)始）
dragCrossSize	GSize	指定拖動(dòng)圖標(biāo)時(shí)十字交叉圖像的像素大小。 （自 2.79 開(kāi)始）
dragCrossAnchor	GPoint	指定拖動(dòng)圖標(biāo)時(shí)十字交叉圖像的像素坐標(biāo)偏移量（相對(duì)于 iconAnchor）。 （自 2.79 開(kāi)始）

GPoint 類

GPoint 是以像素坐標(biāo)表示的地圖上的一點(diǎn)。請(qǐng)注意，在 v2 中，它不再是以地理坐標(biāo)表示的地面上的一個(gè)點(diǎn)。現(xiàn)在，地理坐標(biāo)可以用GLatLng 表示。

在 Google 地圖坐標(biāo)系統(tǒng)中，x 坐標(biāo)向右增大，y 坐標(biāo)“向下”增大，不過(guò)如果愿意，您也可以使用 GPoint 坐標(biāo)。

注意：盡管 GPoint 的兩個(gè)參數(shù)可以作為屬性x 和 y 訪問(wèn)，但是請(qǐng)勿修改它們，而是在創(chuàng)建新對(duì)象時(shí)使用不同的參數(shù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GPoint(x:Number, y:Number)	創(chuàng)建 GPoint 對(duì)象。

屬性

屬性類型說(shuō)明

x	Number	x 坐標(biāo)。（在 Google 地圖坐標(biāo)系統(tǒng)中，該值向右增大。）
y	Number	y 坐標(biāo)。（在 Google 地圖坐標(biāo)系統(tǒng)中，該值向下增大。）

方法

方法返回值說(shuō)明

equals(other:GPoint)	Boolean	當(dāng)且僅當(dāng)其他點(diǎn)有相等的坐標(biāo)時(shí)，返回 true。
toString()	String	返回包含 x 和 y 坐標(biāo)的字符串，先 x 坐標(biāo)后 y 坐標(biāo)，之間用逗號(hào)分隔。

GSize 類

GSize 是地圖矩形區(qū)域的大小（以像素表示）。大小對(duì)象有兩個(gè)參數(shù)：width 和height。寬度是點(diǎn)的 x 坐標(biāo)的差值，高度是 y 坐標(biāo)的差值。

注意：盡管 GSize 的兩個(gè)參數(shù)可以作為屬性width 和 height 訪問(wèn)，但是請(qǐng)勿修改它們，而是在創(chuàng)建新對(duì)象時(shí)使用不同的參數(shù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GSize(width:Number, height:Number)	創(chuàng)建 GSize 對(duì)象。

屬性

屬性類型說(shuō)明

width	Number	寬度參數(shù)。
height	Number	高度參數(shù)。

方法

方法返回值說(shuō)明

equals(other:GSize)	Boolean	當(dāng)且僅當(dāng)另一大小的分量完全相同時(shí)，返回 true。
toString()	String	返回包含寬度和高度參數(shù)的字符串，先寬度后高度，之間用逗號(hào)分隔。

GBounds 類

GBounds 是以像素坐標(biāo)表示的地圖矩形區(qū)域。請(qǐng)注意，“地理坐標(biāo)”中的矩形可用GLatLngBounds 表示。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GBounds(points:GPoint[])	構(gòu)造一個(gè)包含所有指定 points 的矩形。

屬性

屬性類型說(shuō)明

minX	Number	矩形左邊的 x 坐標(biāo)。
minY	Number	矩形上邊的 y 坐標(biāo)。
maxX	Number	矩形右邊的 x 坐標(biāo)。
maxY	Number	矩形下邊的 y 坐標(biāo)。

方法

方法返回值說(shuō)明

toString()	String	返回包含框的左上角點(diǎn)坐標(biāo)和右下角點(diǎn)坐標(biāo)的字符串，先左上后右下，中間用逗號(hào)分隔，前后用圓括號(hào)括起來(lái)。
equals(other:GBounds)	Boolean	在此矩形中的所有參數(shù)都等于另一矩形中的參數(shù)時(shí)返回 true。 （自 2.98 開(kāi)始）
mid()	GPoint	返回矩形區(qū)域的中心點(diǎn)像素坐標(biāo)。 （自 2.88 開(kāi)始）
min()	GPoint	返回矩形區(qū)域的左上角像素坐標(biāo)。
max()	GPoint	返回矩形區(qū)域的右下角像素坐標(biāo)。
containsBounds(other:GBounds)	Boolean	如果傳入的矩形區(qū)域完全包含于此矩形區(qū)域中，則返回 true。
containsPoint(point:GPoint)	Boolean	如果矩形區(qū)域（含邊界）本身包含像素坐標(biāo)，則返回 true。 （自 2.88 開(kāi)始）
extend(point:GPoint)	None	放大此框，使該點(diǎn)也包括在框中。

GLatLng 類

GLatLng 是以經(jīng)度和緯度表示的地理坐標(biāo)點(diǎn)。

請(qǐng)注意，盡管進(jìn)行地圖投影時(shí)通常將經(jīng)度與 x 坐標(biāo)相關(guān)聯(lián)，將緯度與 y 坐標(biāo)相關(guān)聯(lián)，但總是先填寫(xiě)緯度坐標(biāo)，后填寫(xiě)經(jīng)度坐標(biāo)，因?yàn)檫@符合繪圖習(xí)慣。

另請(qǐng)注意，不能修改 GLatLng 的坐標(biāo)。如果想要計(jì)算另一個(gè)點(diǎn)，必須新建一個(gè)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GLatLng(lat:Number, lng:Number, unbounded?:Boolean)	注意緯度和經(jīng)度的順序。如果 unbounded 標(biāo)記為 true，則將使用傳遞的數(shù)字，否則緯度會(huì)限定在 -90 度和 +90 度之間，而經(jīng)度會(huì)限定在 -180 度和 +180 度之間。

方法

方法返回值說(shuō)明

lat()	Number	返回以度數(shù)表示的緯度坐標(biāo)（-90 到 +90 之間的數(shù)字）。如果在構(gòu)造函數(shù)中設(shè)置了 unbounded 標(biāo)記，則緯度坐標(biāo)可能超出此范圍。
lng()	Number	返回以度數(shù)表示的經(jīng)度坐標(biāo)（-180 到 +180 之間的數(shù)字）。如果在構(gòu)造函數(shù)中設(shè)置了 unbounded 標(biāo)記，則經(jīng)度坐標(biāo)可能超出此范圍。
latRadians()	Number	返回以弧度為單位的緯度坐標(biāo)（-PI/2 到 +PI/2之間的數(shù)字）。如果在構(gòu)造函數(shù)中設(shè)置了 unbounded 標(biāo)記，則緯度坐標(biāo)可能超出此范圍。
lngRadians()	Number	返回以弧度表示的經(jīng)度坐標(biāo)（-PI 到 +PI 之間的數(shù)字）。如果在構(gòu)造函數(shù)中設(shè)置了 unbounded 標(biāo)記，則經(jīng)度坐標(biāo)可能超出此范圍。
equals(other:GLatLng)	Boolean	當(dāng)且僅當(dāng)其他大小具有相同分量（在一定的舍入范圍內(nèi)）時(shí)返回 true。
distanceFrom(other:GLatLng)	Number	返回從此點(diǎn)到某個(gè)指定點(diǎn)的距離（以米為單位）。地球近似一個(gè)球體，因此距離可能會(huì)有不會(huì)超過(guò) 0.3% 的誤差。請(qǐng)參見(jiàn)以下信息。 （自 2.89 開(kāi)始不推薦使用）
distanceFrom(other:GLatLng, radius?:Number)	Number	返回從此點(diǎn)到某個(gè)指定點(diǎn)的距離（以米為單位）。在默認(rèn)情況下，根據(jù)地球赤道半徑的默認(rèn)值 6378137 米計(jì)算此距離。地球近似一個(gè)球體，因此距離可能會(huì)有不超過(guò) 0.3% 的誤差（尤其在兩極）。也可以傳遞可選的radius 參數(shù)計(jì)算不同于地球半徑的球體的 GLatLng 坐標(biāo)之間的距離。 （自 2.89 開(kāi)始）
toUrlValue()	String	不推薦使用此版本的方法，而使用能傳遞可選 precision 參數(shù)的修訂版方法（如下所示）。 （自 2.78 開(kāi)始不要使用）
toUrlValue(precision?:Number)	String	返回表示此點(diǎn)的字符串，采用適合用作網(wǎng)址參數(shù)值的格式，中間用逗號(hào)分隔且不含空格。默認(rèn)情況下，精確度的返回值為 6 位數(shù)字，相當(dāng)于 4 英寸/11 厘米的分辨率。可選的precision 參數(shù)可讓您指定更低的精確度以減輕服務(wù)器負(fù)載。注意：在 2.78 之前，此 precision 參數(shù)不可用。 （自 2.78 開(kāi)始）

屬性

這些屬性的存在只是為了實(shí)現(xiàn)與 v1 事件處理程序函數(shù)的向后兼容。不應(yīng)使用它們。

這些屬性反映 lng() 和 lat() 存取器方法的返回值，還可在 v1 客戶端期望的 GPoint 位置顯示GLatLng。如果要使 GLatLng 出現(xiàn)在事件明細(xì)中（即出現(xiàn)在事件處理程序函數(shù)的參數(shù)中），這是必需的。與方法包裝器不同，在當(dāng)前的基礎(chǔ)框架中不可創(chuàng)建事件包裝器。

屬性類型說(shuō)明

x	Number	不再推薦使用。
y	Number	不再推薦使用。

GLatLngBounds 類

GLatLngBounds 實(shí)例在地理坐標(biāo)中代表矩形，包括與 180 度子午線相交的矩形。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GLatLngBounds(sw?:GLatLng, ne?:GLatLng)	根據(jù)西南角和東北角兩個(gè)點(diǎn)構(gòu)建矩形。

方法

方法返回值說(shuō)明

equals(other:GLatLngBounds)	Boolean	當(dāng)且僅當(dāng)此矩形中的所有參數(shù)都等于其他矩形的參數(shù)（在一定的舍入范圍內(nèi)）時(shí)，返回 true。
contains(latlng:GLatLng)	Boolean	當(dāng)且僅當(dāng)該點(diǎn)的地理坐標(biāo)位于此矩形內(nèi)時(shí)，返回 true。 （自 2.88 開(kāi)始不推薦使用）
containsLatLng(latlng:GLatLng)	Boolean	當(dāng)且僅當(dāng)該點(diǎn)的地理坐標(biāo)位于此矩形內(nèi)時(shí)，返回 true。 （自 2.88 開(kāi)始）
intersects(other:GLatLngBounds)	Boolean	如名所述。
containsBounds(other:GLatLngBounds)	Boolean	如名所述。
extend(latlng:GLatLng)	None	放大此矩形，使其包含指定的點(diǎn)。沿經(jīng)線方向的兩種可能的放大方式中，按較小的那種方式放大。如果兩者相等，則放大東部的邊界。
getSouthWest()	GLatLng	返回矩形西南角的點(diǎn)。
getNorthEast()	GLatLng	返回矩形東北角的點(diǎn)。
toSpan()	GLatLng	返回 GLatLng，其坐標(biāo)表示此矩形的大小。
isFullLat()	Boolean	如果此矩形從南極延伸到北極，則返回 true。
isFullLng()	Boolean	如果此矩形沿經(jīng)線方向環(huán)繞地球一周，則返回 true。
isEmpty()	Boolean	如果此矩形為空，則返回 true。
getCenter()	GLatLng	返回矩形的中心點(diǎn)。 （自 2.52 開(kāi)始）

接口 GControl

所有控件都實(shí)現(xiàn)此接口。您可以實(shí)現(xiàn)此接口，以便為地圖提供自定義控件。使用 GMap2.addControl() 方法向地圖添加控件。

與疊加層不同（其相對(duì)于地圖定位），控件相對(duì)于地圖視圖位置而定位，即移動(dòng)地圖時(shí)控件不移動(dòng)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GControl(printable?:Boolean, selectable?:Boolean)	為新控件類創(chuàng)建原型實(shí)例。標(biāo)志 printable 表示控件在地圖的打印輸出中應(yīng)可見(jiàn)。標(biāo)志 selectable 表示控件包含可選擇的文本。

方法

當(dāng)使用 GMap2.addControl() 向地圖中添加控件時(shí)，地圖會(huì)調(diào)用這些方法。因此，您無(wú)法調(diào)用這些方法，但可以實(shí)現(xiàn)這些方法。

方法返回值說(shuō)明

printable()	Boolean	如果可以打印控件，則返回至地圖。
selectable()	Boolean	如果控件包含可選擇文本，則返回至地圖。
initialize(map:GMap2)	Node	地圖將調(diào)用該方法，因此控件可自我初始化。該控件將使用 GMap2.getContainer() 方法獲取包含地圖的 DOM 元素，并將自己添加到 DOM 元素中。它返回添加的元素。
getDefaultPosition()	GControlPosition	向地圖返回默認(rèn)情況下控件在地圖視圖中出現(xiàn)的位置。這會(huì)由 GMap2.addControl() 的第二個(gè)參數(shù)所覆蓋。

GControlPosition 類

此類描述了地圖視圖中控件的位置。它由相對(duì)于控件所在位置的角和確定此位置的偏移量組成。它可以作為可選參數(shù) position 傳入方法GMap2.addControl()，也可以從方法GControl.getDefaultPosition() 中返回。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GControlPosition(anchor:enum GControlAnchor, offset:GSize)	創(chuàng)建控件位置規(guī)范。

枚舉 GControlAnchor

常數(shù)

常數(shù)說(shuō)明

G_ANCHOR_TOP_RIGHT	控件將錨定到地圖的右上角。
G_ANCHOR_TOP_LEFT	控件將錨定到地圖的左上角。
G_ANCHOR_BOTTOM_RIGHT	控件將錨定到地圖的右下角。
G_ANCHOR_BOTTOM_LEFT	控件將錨定到地圖的左下角。

GControl 類

存在 interface GControl 的實(shí)現(xiàn)方法。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GSmallMapControl()	創(chuàng)建帶有可在四個(gè)方向平移、放大和縮小的按鈕的控件。
GLargeMapControl()	創(chuàng)建帶有可在四個(gè)方向平移、放大、縮小的按鈕以及縮放滑塊的控件。
GSmallZoomControl()	創(chuàng)建帶有放大和縮小按鈕的控件。
GScaleControl()	創(chuàng)建顯示地圖比例尺的控件。
GMapTypeControl()	創(chuàng)建一個(gè)標(biāo)準(zhǔn)地圖類型控件，通過(guò)按鈕在受支持地圖類型之間進(jìn)行選擇和切換。
GMenuMapTypeControl()	創(chuàng)建一個(gè)下拉地圖類型控件，在受支持地圖類型之間切換。
GHierarchicalMapTypeControl()	創(chuàng)建一個(gè)“嵌套”地圖類型控件，通過(guò)按鈕和嵌套復(fù)選框在受支持地圖類型之間進(jìn)行選擇和切換。
GOverviewMapControl()	在主地圖的一角創(chuàng)建可折疊的迷你型概覽地圖，以便通過(guò)拖動(dòng)提供位置參考和導(dǎo)航。GOverviewMapControl 創(chuàng)建單像素黑邊界的概覽地圖。注意：與其他控件不同，您只能將此控件放在地圖的右下角 (G_ANCHOR_BOTTOM_RIGHT)。

GMapTypeControl 類

GMapTypeControl 提供用于通過(guò)按鈕在受支持地圖類型之間進(jìn)行選擇和切換的控件。必須在構(gòu)造這些控件時(shí)將其設(shè)置為可用于當(dāng)前附加到地圖的所有地圖類型。

默認(rèn)情況下，地圖支持 G_DEFAULT_MAP_TYPES 集合；地圖還可以通過(guò) GMap2.addMapType() 顯式地添加地圖類型。為了節(jié)省地圖空間，您可以改為使用GHierarchicalMapTypeControl 顯示“嵌套”地圖類型或使用GMenuMapTypeControl 顯示下拉地圖類型。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMapTypeControl(useShortNames?:Boolean)	如果 GMapTypeControl 設(shè)置為 true，就使用短名稱創(chuàng)建useShortNames，默認(rèn)是使用長(zhǎng)名稱。

GMenuMapTypeControl 類

GMenuMapTypeControl 提供用于通過(guò)下拉菜單在受支持地圖類型之間進(jìn)行選擇和切換的控件。必須在構(gòu)造這些控件時(shí)將其設(shè)置為可用于當(dāng)前附加到地圖的所有地圖類型。

默認(rèn)情況下，地圖支持 G_DEFAULT_MAP_TYPES 集合；地圖還可以通過(guò) GMap2.addMapType() 顯式地添加地圖類型。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMenuMapTypeControl(useShortNames?:Boolean)	如果 GMenuMapTypeControl 設(shè)置為 true，就使用短名稱創(chuàng)建useShortNames，默認(rèn)是使用長(zhǎng)名稱。

GHierarchicalMapTypeControl 類

GHierarchicalMapTypeControl 提供通過(guò)按鈕和嵌套復(fù)選框在受支持地圖類型之間進(jìn)行選擇和切換的“嵌套”地圖類型控件。必須在構(gòu)造這些控件時(shí)將其設(shè)置為可用于當(dāng)前附加到地圖的所有地圖類型。

添加到地圖中的地圖類型顯示為如常規(guī) GMapTypeControl 中所示的按鈕。但是，設(shè)置為其他地圖類型子類型的地圖類型（參見(jiàn)下面的addRelationship() 方法）將顯示為父按鈕下的復(fù)選框子菜單項(xiàng)。

默認(rèn)情況下，地圖支持 G_DEFAULT_MAP_TYPES 集合；地圖還可以通過(guò) GMap2.addMapType() 顯式地添加地圖類型。必須在構(gòu)造這些控件時(shí)將其設(shè)置為可用于當(dāng)前附加到地圖的所有地圖類型。請(qǐng)注意，因?yàn)樽宇愋惋@示為復(fù)選框，您可以使用子菜單中的其父類型或同級(jí)類型對(duì)外觀進(jìn)行切換。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GHierarchicalMapTypeControl()	構(gòu)造該控件。默認(rèn)情況下，G_HYBRID_MAP 地圖類型生成一個(gè) G_SATELLITE_MAP 地圖類型的子類型。如果不需要，可以通過(guò)調(diào)用clearRelationships() 方法刪除該關(guān)系。

方法

方法返回值說(shuō)明

addRelationship(parentType:GMapType, childType:GMapType, childText?:String, isDefault?:Boolean)	None	使用該控件在地圖類型之間注冊(cè)父/子關(guān)系。如果給出 childText，則它會(huì)顯示在該子地圖類型（而非名稱）復(fù)選框的旁邊。如果 isDefault 為 true，則默認(rèn)選擇該子地圖類型。請(qǐng)注意，在添加控件前必須設(shè)置所有關(guān)系。（添加控件后再添加關(guān)系是無(wú)效的。） （自 2.94 開(kāi)始）
removeRelationship(mapType:GMapType)	None	從控件中刪除與某個(gè)地圖類型有關(guān)的所有關(guān)系。 （自 2.94 開(kāi)始）
clearRelationships()	None	從控件中刪除所有關(guān)系。 （自 2.94 開(kāi)始）

GMapType 類

Google 提供部分預(yù)定義地圖類型 - 此類用于定義自定義地圖類型。要在地圖中顯示地圖類型，請(qǐng)使用 GMap2 構(gòu)造函數(shù)或GMap2.addMapType() 方法。要添加到（而不是整個(gè)替換）地圖的圖塊層，另請(qǐng)參閱GTileLayerOverlay。

還可以對(duì)此類進(jìn)行細(xì)分。如果構(gòu)造函數(shù)參數(shù)實(shí)例化為原型，則可省略它。子類構(gòu)造函數(shù)必須使用 call() 調(diào)用 GMapType 構(gòu)造函數(shù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMapType(layers:GTileLayer[], projection:GProjection, name:String, opts?:GMapTypeOptions)	用指定的圖塊層、投影、名稱和可選參數(shù)構(gòu)造一個(gè)地圖類型。

方法

這些方法多數(shù)由此地圖類型傳遞到的目標(biāo)地圖調(diào)用，但部分方法可能也從地圖外調(diào)用，比如 getBoundsZoomLevel()。

方法返回值說(shuō)明

getSpanZoomLevel(center:GLatLng, span:GLatLng, viewSize:GSize)	Number	向地圖返回縮放級(jí)別，由中心和跨度定義的地圖部分按這一縮放級(jí)別適合于指定大小（以像素表示）的地圖視圖。
getBoundsZoomLevel(bounds:GLatLngBounds, viewSize:GSize)	None	向地圖返回縮放級(jí)別，由邊界定義的地圖部分按這一縮放級(jí)別適合于指定大小（以像素表示）的地圖視圖。
getName(short?:Boolean)	String	向地圖返回要在 GMapTypeControl 中用作按鈕標(biāo)簽的地圖類型名稱。
getProjection()	GProjection	向地圖返回此地圖類型的投影。
getTileSize()	Number	向地圖返回此地圖類型的地圖圖塊大小（以像素表示）。這些圖塊的結(jié)構(gòu)假定為二次的。所有圖塊層的圖塊大小相同。
getTileLayers()	GTileLayer[]	向地圖返回圖塊層數(shù)組。
getMinimumResolution()	Number	向地圖返回定義此地圖類型的最低縮放級(jí)別。
getMaximumResolution()	Number	向地圖返回定義此地圖類型的最高縮放級(jí)別。
getTextColor()	String	向地圖返回地圖上覆蓋文本的最適用顏色。用于版權(quán)控件所顯示的版權(quán)消息文本的顏色。
getLinkColor()	String	向地圖返回地圖上覆蓋的超鏈接的最適用顏色。用于版權(quán)控件所顯示的使用條款鏈接的顏色。
getErrorMessage()	String	向地圖返回區(qū)域中顯示的錯(cuò)誤消息，或有關(guān)此地圖類型無(wú)地圖圖塊處的區(qū)域或縮放級(jí)別的錯(cuò)誤消息。
getCopyrights(bounds:GLatLngBounds, zoom:Number)	String[]	向地圖返回版權(quán)消息，該消息適用于由 bounds 描述的指定縮放級(jí)別的地區(qū)。這用于地圖上的版權(quán)消息。
getUrlArg()	String	向地圖返回一個(gè)值，用作當(dāng)前地圖視圖的永久鏈接中識(shí)別此地圖類型的網(wǎng)址參數(shù)值。目前，這僅由地圖應(yīng)用程序使用。
getAlt()	String	向地圖返回此地圖類型的備選文本。 （自 2.86 開(kāi)始）

常數(shù)

常數(shù)說(shuō)明

G_NORMAL_MAP	該地圖類型（默認(rèn)地圖類型）顯示普通的街道地圖。
G_SATELLITE_MAP	該地圖類型顯示衛(wèi)星圖像。
G_HYBRID_MAP	該地圖類型顯示衛(wèi)星圖像上的主要街道透明層。
G_PHYSICAL_MAP	該地圖類型顯示帶有自然特征（如地形和植被）的地圖。默認(rèn)情況下，該地圖類型不顯示在地圖類型控件中。 （自 2.94 開(kāi)始）
G_MOON_ELEVATION_MAP	該地圖類型顯示月球表面按海拔進(jìn)行彩色編碼的帶陰影地形地圖。默認(rèn)情況下，該地圖類型不顯示在地圖類型控件中。 （自 2.95 開(kāi)始）
G_MOON_VISIBLE_MAP	此地圖類型顯示來(lái)自月球軌道的照片。默認(rèn)情況下，該地圖類型不顯示在地圖類型控件中。 （自 2.95 開(kāi)始）
G_MARS_ELEVATION_MAP	該地圖類型顯示火星表面按海拔進(jìn)行彩色編碼的帶陰影地形地圖。默認(rèn)情況下，該地圖類型不顯示在地圖類型控件中。 （自 2.95 開(kāi)始）
G_MARS_VISIBLE_MAP	此地圖類型顯示來(lái)自火星軌道的照片。默認(rèn)情況下，該地圖類型不顯示在地圖類型控件中。 （自 2.95 開(kāi)始）
G_MARS_INFRARED_MAP	此地圖類型顯示火星表面帶陰影的紅外線地圖，其中較熱地區(qū)以亮色顯示，較冷地區(qū)以暗色顯示。 （自 2.95 開(kāi)始）
G_SKY_VISIBLE_MAP	該地圖類型顯示覆蓋整個(gè)天體的天空拼接。 （自 2.95 開(kāi)始）
G_SATELLITE_3D_MAP	結(jié)合 Google 地球?yàn)g覽器插件，此地圖類型可以通過(guò)衛(wèi)星圖像顯示地球的完全交互式三維模型。默認(rèn)情況下，該地圖類型不顯示在地圖類型控件中。 如果將此地圖類型添加到您的地圖，不僅會(huì)為 Google 地球地圖類型添加控件，還會(huì)在點(diǎn)擊用戶控件后處理該地圖類型的初始化。如果用戶當(dāng)前沒(méi)有在瀏覽器中安裝 Google 地球插件，則用戶第一次選擇該地圖類型時(shí)，系統(tǒng)會(huì)提示該用戶下載安裝該插件并重新啟動(dòng)瀏覽器。 對(duì)于尚未安裝該插件的用戶，選擇此地圖類型會(huì)為地圖創(chuàng)建 Google 地球?qū)嵗@示 Google 地球的三維視圖。您可以使用 GMap2.getEarthInstance() 檢索此 Google 地球?qū)嵗⑹褂肎oogle 地球 API 對(duì)其進(jìn)行處理。 目前，標(biāo)記、信息窗口和折線都可用于此三維地圖類型，但是尚不支持其他功能。我們計(jì)劃在以后的版本中支持更多功能。 （自 2.113 開(kāi)始）
G_DEFAULT_MAP_TYPES	上述前三種預(yù)定義地圖類型數(shù)組（G_NORMAL_MAP、G_SATELLITE_MAP 和 G_HYBRID_MAP）。
G_MOON_MAP_TYPES	上述兩種月球類型數(shù)組（G_MOON_ELEVATION_MAP 和 G_MOON_VISIBLE_MAP）。
G_MARS_MAP_TYPES	上面定義的三種火星地圖類型數(shù)組（G_MARS_ELEVATION_MAP、G_MARS_VISIBLE_MAP 和 G_MARS_INFRARED_MAP）。
G_SKY_MAP_TYPES	上面定義的一種天空地圖類型數(shù)組 (G_SKY_VISIBLE_MAP)。

事件

事件說(shuō)明

newcopyright(copyright:GCopyright)	當(dāng)向此地圖類型中所包含的某個(gè)圖塊層的版權(quán)集合添加新版權(quán)時(shí)會(huì)觸發(fā)此事件。

GMapTypeOptions 類

此類的實(shí)例用作 GMapType 構(gòu)造函數(shù)的opts? 參數(shù)。此類不存在構(gòu)造函數(shù)。但是，此類可以實(shí)例化為 javascript 對(duì)象常量。

屬性

屬性類型說(shuō)明

shortName	String	設(shè)置從 GMapType.getName(true) 中返回的地圖類型的短名稱。默認(rèn)值與name 相同。
urlArg	String	設(shè)置從 GMapType.getUrlArg() 中返回的地圖類型的網(wǎng)址參數(shù)。默認(rèn)值為空字符串。
maxResolution	Number	設(shè)置由 GMapType.getMaximumResolution() 返回的地圖類型的最高縮放級(jí)別。默認(rèn)值為所有圖塊層的最大值。
minResolution	Number	設(shè)置由 GMapType.getMinimumResolution() 返回的地圖類型的最低縮放級(jí)別。默認(rèn)值為所有圖塊層的最小值。
tileSize	Number	設(shè)置由 GMapType.getTileSize() 返回的圖塊大小。默認(rèn)值是256。
textColor	String	設(shè)置由 GMapType.getTextColor() 返回的文本顏色。默認(rèn)值是"black"。
linkColor	String	設(shè)置由 GMapType.getLinkColor() 返回的文本顏色。默認(rèn)值是"#7777cc"。
errorMessage	String	設(shè)置由 GMapType.getErrorMessage() 返回的錯(cuò)誤消息。默認(rèn)值為空字符串。
alt	String	對(duì) GMapType.getAlt() 返回的地圖類型設(shè)置備選文本。默認(rèn)值為空字符串。 （自 2.64 開(kāi)始）
radius	Number	按傳遞的 Number（以米表示）設(shè)置地圖類型的半徑。默認(rèn)值是 6378137，這是地球的赤道半徑（以米表示）。 （自 2.89 開(kāi)始）

GLayer 類

此類可以實(shí)例化預(yù)定義的“l(fā)ayer”疊加層（包含相關(guān)項(xiàng)目的集合）。它實(shí)現(xiàn) GOverlay 接口，因此可使用GMap2.addOverlay() 方法添加到地圖中。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GLayer(layerId:String)	使用指定的唯一層 ID 創(chuàng)建層。http://spreadsheets.google.com/pub?key=p9pdwsai2hDN-cAocTLhnag 包含當(dāng)前受支持的層列表。

方法

方法返回值說(shuō)明

hide()	None	隱藏此疊加層使之不可見(jiàn)，但保留它在疊加層堆棧中的位置。
show()	None	顯示之前隱藏的 GLayer。

靜態(tài)方法

方法返回值說(shuō)明

GLayer.isHidden(layerId:String)	None	如果層疊加層隱藏或未使用 GMap2.addOverlay() 方法添加到地圖中，則返回true。否則，返回 false。

接口 GTileLayer

您可以實(shí)現(xiàn)此接口，以通過(guò) GMapType 或GTileLayerOverlay 提供自定義的地圖圖塊層。此接口的實(shí)現(xiàn)應(yīng)使用GTileLayer 實(shí)例作為原型，因?yàn)檫@樣可以為您實(shí)現(xiàn)版權(quán)處理。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GTileLayer(copyrights:GCopyrightCollection, minResolution:Number, maxResolution:Number, options?:GTileLayerOptions)	如果構(gòu)造函數(shù)參數(shù)實(shí)例化為原型，則可省略它。子類構(gòu)造函數(shù)必須使用 call() 調(diào)用此構(gòu)造函數(shù)。可選 options 參數(shù)指定應(yīng)作為對(duì)象常量傳遞的GTileLayerOptions 集合。

方法

地圖和此圖塊層傳遞到的地圖類型會(huì)調(diào)用這些方法。當(dāng)實(shí)現(xiàn)自定義圖塊層時(shí)，您需要實(shí)現(xiàn)標(biāo)記為抽象的方法。

方法返回值說(shuō)明

minResolution()	Number	向地圖類型返回此圖塊層的最低縮放級(jí)別。
maxResolution()	Number	向地圖類型返回此圖塊層的最高縮放級(jí)別。
getTileUrl(tile:GPoint, zoom:Number)	String	抽象。向地圖返回地圖圖塊的網(wǎng)址，圖塊索引由 GPoint 的x 和 y 屬性在指定的縮放級(jí)別提供。
isPng()	Boolean	抽象。向地圖返回圖塊的圖像格式是否為 PNG，以及是否因此可能為透明的。否則，假定是 GIF。
getOpacity()	Number	抽象。向地圖返回顯示此圖塊層所用的不透明度。1.0 為不透明，0.0 為透明。
getCopyright(bounds:GLatLngBounds, zoom:Number)	String	抽象。向地圖返回此圖塊層的版權(quán)消息，這與指定縮放級(jí)別的指定地圖地區(qū)有關(guān)。這用于生成此圖塊層所屬的 GMapType 的版權(quán)消息。 （自 2.89 開(kāi)始）

事件

事件說(shuō)明

newcopyright(copyright:GCopyright)	當(dāng)向此圖塊層的版權(quán)集合添加新版權(quán)時(shí)會(huì)觸發(fā)此事件。

GTileLayerOptions 類

此類代表 GTileLayer 接口的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

opacity	Number	設(shè)置圖塊的不透明度，范圍是 0.0（不可見(jiàn)）到 1.0（不透明）。默認(rèn)值為 1.0。
isPng	Boolean	指明圖塊的格式是否為 PNG。
tileUrlTemplate	String	指定圖塊網(wǎng)址模板，該模板可以針對(duì)每個(gè)圖塊請(qǐng)求而展開(kāi)，以根據(jù)現(xiàn)有的圖塊坐標(biāo)系引用唯一的圖塊。將模板置于 GTileLayer 構(gòu)造函數(shù)中可允許您使用此坐標(biāo)系動(dòng)態(tài)檢索圖塊，檢索方式類似于 Google 地圖檢索圖塊的方式。 模板的格式應(yīng)該為： http://host/tile?x={X}&y={Y}&z={Z}.png ，其中 X 和 Y 分別指緯度和經(jīng)度圖塊坐標(biāo)，Z 指縮放級(jí)別，比如 http://host/tile?x=3&y=27&z=5.png。
draggingCursor	String	拖動(dòng)地圖時(shí)顯示的光標(biāo)。 （自 2.59 開(kāi)始）

GTileLayerOverlay 類

GTileLayerOverlay 通過(guò)GTileLayer 放大地圖。它實(shí)現(xiàn)GOverlay 接口，因此可使用GMap2.addOverlay() 方法添加到地圖中。在現(xiàn)有的地圖圖像之上顯示GTileLayer，以替換該圖像，將GTileLayer 放置于自定義的GMapType 中。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GTileLayerOverlay(tileLayer:GTileLayer, opts?:GTileLayerOverlayOptions)	創(chuàng)建封裝 GOverlay 的tileLayer。 （自 2.61 開(kāi)始）

方法

方法返回值說(shuō)明

hide()	None	隱藏此疊加層使之不可見(jiàn)，但保留它在疊加層堆棧中的位置。 （自 2.71 開(kāi)始）
isHidden()	None	如果圖塊層疊加層不可見(jiàn)，則返回 true。否則，返回 false。 （自 2.87 開(kāi)始）
show()	None	顯示先前不可見(jiàn)的 GTileLayerOverlay。 （自 2.71 開(kāi)始）
refresh()	None	重新加載所有添加到此 GTileLayerOverlay 的可見(jiàn)圖塊。 （自 2.132 開(kāi)始）
supportsHide()	None	總是返回 true。 （自 2.87 開(kāi)始）
getTileLayer()	None	返回此疊加層所使用的圖塊層。 （自 2.83 開(kāi)始）

GTileLayerOverlayOptions 類

此類代表 GTileLayerOverlayOptions 構(gòu)造函數(shù)的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

zPriority	Number	zPriority 包含確定此 TileLayerOverlay 的相對(duì) z 順序的值。優(yōu)先級(jí)較高的圖塊層將顯示在優(yōu)先級(jí)較低的圖塊層之上。 （自 2.110 開(kāi)始）

GCopyrightCollection 類

您可以使用此類管理自定義地圖類型的地圖上顯示的版權(quán)消息。如果不實(shí)現(xiàn)自定義地圖類型，則無(wú)需使用此類。版權(quán)集合包含以下信息：在哪個(gè)縮放級(jí)別的地圖上為哪個(gè)地區(qū)顯示哪個(gè)版權(quán)。這對(duì)顯示異源數(shù)據(jù)（如衛(wèi)星地圖類型）的地圖類型非常重要。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GCopyrightCollection(prefix?:String)	從此版權(quán)集合所產(chǎn)生的版權(quán)消息包含以參數(shù)形式給出的通用前綴。 示例：“Imagery (C) 2006”

方法

方法返回值說(shuō)明

addCopyright(copyright:GCopyright)	None	將版權(quán)信息對(duì)象添加到集合中。
getCopyrights(bounds:GLatLngBounds, zoom:Number)	String[]	返回所有版權(quán)字符串，它與指定縮放級(jí)別的指定地圖地區(qū)有關(guān)。 示例：[ "Google", "Keyhole" ]
getCopyrightNotice(bounds:GLatLngBounds, zoom:Number)	String	返回前綴和所有相關(guān)的版權(quán)字符串，它們與指定縮放級(jí)別的指定地圖地區(qū)有關(guān)。 示例：“Imagery (C) 2006 Google, Keyhole”

事件

事件說(shuō)明

newcopyright(copyright:GCopyright)	當(dāng)向此版權(quán)集合添加新的版權(quán)時(shí)會(huì)觸發(fā)此事件。

GCopyright 類

版權(quán)對(duì)象包含以下信息：哪個(gè)版權(quán)消息適用于指定縮放級(jí)別的矩形地圖地區(qū)。只有在實(shí)現(xiàn)自定義地圖類型或圖塊層時(shí)，才需要此對(duì)象。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GCopyright(id:Number, bounds:GLatLngBounds, minZoom:Number, text:String)	用指定的屬性創(chuàng)建版權(quán)信息對(duì)象。

屬性

屬性類型說(shuō)明

id	Number	此版權(quán)信息的唯一標(biāo)識(shí)符。
minZoom	Number	此信息所適用的最低縮放級(jí)別。
bounds	GLatLngBounds	此信息所適用的地區(qū)。
text	String	版權(quán)消息文本。

接口 GProjection

這是地圖投影接口。將地圖投影實(shí)例傳遞到 GMapType 構(gòu)造函數(shù)中。class GMercatorProjection 是通過(guò)此接口實(shí)現(xiàn)的，所有預(yù)定義地圖類型都可使用。如果希望用不同的地圖投影定義地圖類型，則可實(shí)現(xiàn)此接口。

方法

這些方法由地圖調(diào)用。您需要實(shí)現(xiàn)它們。

方法返回值說(shuō)明

fromLatLngToPixel(latlng:GLatLng, zoom:Number)	GPoint	返回指定的縮放級(jí)別上指定的地理坐標(biāo)對(duì)應(yīng)的點(diǎn)的地圖坐標(biāo)（以像素表示）。
fromPixelToLatLng(pixel:GPoint, zoom:Number, unbounded?:Boolean)	GLatLng	返回指定縮放級(jí)別上指定的地圖坐標(biāo)點(diǎn)（以像素表示）的地理坐標(biāo)。標(biāo)志 unbounded 在地理經(jīng)度坐標(biāo)超出 -180 或 180 度子午線時(shí)使地理經(jīng)度坐標(biāo)不重疊。
tileCheckRange(tile:GPoint, zoom:Number, tilesize:Number)	Boolean	向地圖返回圖塊索引是否在地圖類型的有效范圍內(nèi)。否則，地圖將會(huì)顯示空?qǐng)D塊。如果地圖包含多個(gè)地球副本，它還可修改指向相同圖塊的另一實(shí)例的 tile 索引，從而修改不同圖塊坐標(biāo)的同一圖塊。
getWrapWidth(zoom:Number)	Number	向地圖返回 x 方向的周期，即地圖繞地球一周所需的像素?cái)?shù)。默認(rèn)情況下，返回 Infinity，即地圖不會(huì)重復(fù)。地圖使用該方法在包含多個(gè)地球副本的地圖視圖上計(jì)算疊加層的放置位置（這種情況通常只出現(xiàn)在縮放級(jí)別較低時(shí)）。 （自 2.46 開(kāi)始）

GMercatorProjection 類

所有預(yù)定義的地圖類型都可以使用墨卡托投影的 GProjection 接口的這一實(shí)現(xiàn)方法。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMercatorProjection(zoomlevels:Number)	為指定的縮放級(jí)別數(shù)創(chuàng)建墨卡托投影。

方法

方法返回值說(shuō)明

fromLatLngToPixel(latlng:GLatLng, zoom:Number)	GPoint	請(qǐng)參見(jiàn) GProjection。
fromPixelToLatLng(pixel:GPoint, zoom:Number, unbounded?:Boolean)	GLatLng	請(qǐng)參見(jiàn) GProjection。
tileCheckRange(tile:GPoint, zoom:Number, tilesize:Number)	None	請(qǐng)參見(jiàn) GProjection。
getWrapWidth(zoom:Number)	None	請(qǐng)參見(jiàn) GProjection。墨卡托投影在經(jīng)度方向是周期性的，因此它返回指定縮放級(jí)別下的整個(gè)地球的地圖寬度（以像素表示）。 （自 2.46 開(kāi)始）

命名空間 GEvent

此命名空間包含的函數(shù)可用于注冊(cè)事件處理程序（既處理自定義事件也處理 DOM 事件）和觸發(fā)自定義事件。此 API 定義的所有事件都是由 GEvent.trigger() 內(nèi)部觸發(fā)的自定義事件。

靜態(tài)方法

方法返回值說(shuō)明

GEvent.addListener(source:Object, event:String, handler:Function)	GEventListener	為源對(duì)象的自定義事件注冊(cè)事件處理程序。返回一個(gè)可用于最終注銷處理程序的句柄。可使用源對(duì)象的 this 集合調(diào)用事件處理程序。
GEvent.addDomListener(source:Node, event:String, handler:Function)	GEventListener	為源對(duì)象的 DOM 事件注冊(cè)事件處理程序。源對(duì)象必須為 DOM 節(jié)點(diǎn)。返回一個(gè)可用于最終注銷處理程序的句柄。可使用源對(duì)象的 this 集合調(diào)用事件處理程序。此函數(shù)將 DOM 方法用于當(dāng)前瀏覽器，來(lái)注冊(cè)事件處理程序。
GEvent.removeListener(handle:GEventListener)	None	刪除使用 addListener() 或 addDomListener() 安裝的處理程序。
GEvent.clearListeners(source:Object or Node, event:String)	None	刪除使用 addListener() 或 addDomListener() 在指定對(duì)象上為指定事件安裝的所有處理程序。
GEvent.clearInstanceListeners(source:Object or Node)	None	刪除使用 addListener() 或 addDomListener() 在指定對(duì)象上為所有事件安裝的所有處理程序。
GEvent.clearNode(source:Node)	None	對(duì)某個(gè)節(jié)點(diǎn)及其所有子節(jié)點(diǎn)遞歸調(diào)用 clearInstanceListeners。
GEvent.trigger(source:Object, event:String, ...)	None	在源對(duì)象上觸發(fā)自定義事件。在將 event 作為參數(shù)輪流傳遞到事件處理程序函數(shù)后所有剩余的可選參數(shù)。
GEvent.bind(source:Object, event:String, object:Object, method:Function)	GEventListener	將指定對(duì)象的方法調(diào)用注冊(cè)為源對(duì)象自定義事件的事件處理程序。返回一個(gè)可用于最終注銷處理程序的句柄。
GEvent.bindDom(source:Node, event:String, object:Object, method:Function)	GEventListener	將指定對(duì)象的方法調(diào)用注冊(cè)為源對(duì)象自定義事件的事件處理程序。返回一個(gè)可用于最終注銷處理程序的句柄。
GEvent.callback(object:Object, method:Function)	Function	返回調(diào)用 object 上的 method 的閉包。
GEvent.callbackArgs(object:Object, method:Function, ...)	Function	返回調(diào)用 object 上的 method 的閉包。返回的函數(shù)被調(diào)用時(shí)，會(huì)將 method 后的所有其他可選參數(shù)作為參數(shù)method 依次傳遞。

事件

事件說(shuō)明

clearlisteners(event?:String)	調(diào)用對(duì)象上的 clearListeners() 或 clearInstanceListeners() 時(shí)，會(huì)在該對(duì)象上觸發(fā)此事件。當(dāng)然，在執(zhí)行函數(shù)“前”也會(huì)觸發(fā)該事件。

GEventListener 類

此類是不透明的。它不包含方法和構(gòu)造函數(shù)。其實(shí)例從 GEvent.addListener() 或GEvent.addDomListener() 返回并最終傳遞回GEvent.removeListener()。

命名空間 GXmlHttp

此命名空間提供一種工廠方法，可以用一種與瀏覽器無(wú)關(guān)的方式創(chuàng)建 XmlHttpRequest 實(shí)例。

靜態(tài)方法

方法返回值說(shuō)明

GXmlHttp.create()	GXmlHttp	創(chuàng)建 XmlHttpRequest 新實(shí)例的工廠。

命名空間 GXml

此命名空間提供一種靜態(tài)方法，可用于處理 XML 文檔和文檔片段。

靜態(tài)方法

方法返回值說(shuō)明

GXml.parse(xmltext:String)	Node	將指定的字符串解析為 XML 文本并返回 DOM 表示。如果瀏覽器不支持本地 XML 解析，則會(huì)返回空 DIV 元素的 DOM 節(jié)點(diǎn)。
GXml.value(xmlnode:Node)	String	返回以 DOM 表示的 XML 文檔片段的文本值（即僅純文本內(nèi)容）。

GXslt 類

此類提供的方法可以用一種與瀏覽器無(wú)關(guān)的方式將 XSLT 應(yīng)用于 XML。

靜態(tài)方法

方法返回值說(shuō)明

GXslt.create(xsltnode:Node)	GXslt	從以 DOM 表示的 XSLT 樣式表創(chuàng)建 GXslt 實(shí)例。
GXslt.transformToHtml(xmlnode:Node, htmlnode:Node)	Boolean	使用在此 GXslt 實(shí)例的構(gòu)造函數(shù)中指定的 XSLT 樣式表，轉(zhuǎn)換xmlnode 中以 DOM 表示的 XML 文檔。將產(chǎn)生的 HTML 文檔片段追加到指定的 htmlnode 中。只有在瀏覽器本身支持 XSL 轉(zhuǎn)換的情況下才可實(shí)現(xiàn)上述轉(zhuǎn)換，它將返回true。否則，此函數(shù)不起任何作用，并返回 false。

命名空間 GLog

此命名空間包含部分靜態(tài)方法，可幫助您調(diào)試網(wǎng)絡(luò)應(yīng)用程序。當(dāng)?shù)谝淮问褂闷渲幸环N write*() 方法時(shí)，頁(yè)面上將打開(kāi)浮動(dòng)窗口并顯示寫(xiě)入的消息。

靜態(tài)方法

方法返回值說(shuō)明

GLog.write(message:String, color?:String)	None	將消息以純文本形式寫(xiě)入日志窗口。對(duì) HTML 標(biāo)記字符進(jìn)行轉(zhuǎn)義，使其成為可見(jiàn)字符。
GLog.writeUrl(url:String)	None	將指定網(wǎng)址的鏈接寫(xiě)入日志窗口。
GLog.writeHtml(html:String)	None	將文本以 HTML 形式寫(xiě)入日志窗口。

GDraggableObject 類

此類使 DOM 元素可拖動(dòng)。更改拖動(dòng)光標(biāo)的靜態(tài)成員會(huì)影響隨后創(chuàng)建的所有可拖動(dòng)對(duì)象，如地圖、縮放控制滑塊和概覽地圖矩形。每個(gè)實(shí)例成員僅影響其特定的實(shí)例。例如，在創(chuàng)建地圖前，您可以調(diào)用GDraggableObject.setDraggableCursor('default') 和GDraggableObject.setDraggingCursor('move') 來(lái)獲取 API 2.56 之前的樣式。或者，地圖構(gòu)造函數(shù)可采用一些選項(xiàng)來(lái)設(shè)置其 DraggableObject 的光標(biāo)樣式。有關(guān)允許的光標(biāo)值，請(qǐng)參見(jiàn)W3C CSS 規(guī)范。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GDraggableObject(src:Node, opts?:GDraggableObjectOptions)	設(shè)置事件處理程序，以使源元素可拖動(dòng)。將元素視需要放置于左上位置，可選的容器用作邊界框。 （自 2.59 開(kāi)始）

靜態(tài)方法

方法返回值說(shuō)明

GDraggableObject.setDraggableCursor(cursor:String)	None	為隨后創(chuàng)建的可拖動(dòng)對(duì)象設(shè)置可拖動(dòng)光標(biāo)。 （自 2.59 開(kāi)始）
GDraggableObject.setDraggingCursor(cursor:String)	None	為隨后創(chuàng)建的可拖動(dòng)對(duì)象設(shè)置拖動(dòng)光標(biāo)。 （自 2.59 開(kāi)始）
GDraggableObject.getDraggingCursor()	String	返回地圖當(dāng)前正在使用的拖動(dòng)光標(biāo)。如果不通過(guò) setDraggingCursor() 靜態(tài)方法進(jìn)行設(shè)置，則將返回地圖在控件和標(biāo)記中使用的默認(rèn)光標(biāo)。 （自 2.87 開(kāi)始）
GDraggableObject.getDraggableCursor()	String	返回地圖當(dāng)前正在使用的可拖動(dòng)光標(biāo)。如果不通過(guò) setDraggableCursor() 靜態(tài)方法進(jìn)行設(shè)置，則將返回地圖在控件和標(biāo)記中使用的默認(rèn)光標(biāo)。 （自 2.87 開(kāi)始）

方法

方法返回值說(shuō)明

setDraggableCursor(cursor:String)	None	設(shè)置鼠標(biāo)置于此可拖動(dòng)對(duì)象之上時(shí)的光標(biāo)。 （自 2.59 開(kāi)始）
setDraggingCursor(cursor:String)	None	設(shè)置按下鼠標(biāo)并拖動(dòng)此可拖動(dòng)對(duì)象時(shí)的光標(biāo)。 （自 2.59 開(kāi)始）
moveTo(point:GPoint)	None	將 GDraggableObject 移動(dòng)到指定的絕對(duì)位置。該位置以相對(duì)于父節(jié)點(diǎn)的像素坐標(biāo)表示。此方法使用 DOM 坐標(biāo)系，即 X 坐標(biāo)向左增大，Y 坐標(biāo)向下增大。 （自 2.89 開(kāi)始）
moveBy(size:GSize)	None	將 GDraggableObject 移動(dòng)指定的大小偏移量。此方法使用 DOM 坐標(biāo)系，即寬度向左增大，高度向下增大。 （自 2.89 開(kāi)始）

事件

事件說(shuō)明

mousedown()	觸發(fā)此事件以響應(yīng) DOM mousedown 事件。處理此事件將阻止 DOM mousedown 事件的默認(rèn)操作。 （自 2.84 開(kāi)始）
mouseup()	觸發(fā)此事件在可拖動(dòng)對(duì)象上響應(yīng) DOM mouseup 事件。處理此事件將阻止 DOM mouseup 事件的默認(rèn)操作。 （自 2.84 開(kāi)始）
click()	點(diǎn)擊可拖動(dòng)對(duì)象時(shí)會(huì)觸發(fā)此事件。 （自 2.84 開(kāi)始）
dragstart()	可拖動(dòng)對(duì)象的拖動(dòng)事件開(kāi)始時(shí)（當(dāng)用戶通過(guò)點(diǎn)擊并拖動(dòng)可拖動(dòng)對(duì)象來(lái)啟動(dòng)拖動(dòng)時(shí)）會(huì)觸發(fā)此事件。 （自 2.84 開(kāi)始）
drag()	當(dāng)用戶拖動(dòng)可拖動(dòng)對(duì)象時(shí)會(huì)重復(fù)觸發(fā)此事件。 （自 2.84 開(kāi)始）
dragend()	在可拖動(dòng)對(duì)象的拖動(dòng)事件結(jié)束時(shí)（用戶釋放拖動(dòng)時(shí)）會(huì)觸發(fā)此事件。 （自 2.84 開(kāi)始）

GDraggableObjectOptions 類

此類代表 GDraggableObject 構(gòu)造函數(shù)的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

left	Number	對(duì)象的左側(cè)起始位置 （自 2.59 開(kāi)始）
top	Number	對(duì)象的頂端起始位置。 （自 2.59 開(kāi)始）
container	Node	充當(dāng)可拖動(dòng)對(duì)象邊界框的 DOM 元素 （自 2.59 開(kāi)始）
draggableCursor	String	在鼠標(biāo)懸停時(shí)顯示的光標(biāo)。 （自 2.59 開(kāi)始）
draggingCursor	String	拖動(dòng)時(shí)顯示的光標(biāo)。 （自 2.59 開(kāi)始）
delayDrag	Boolean	默認(rèn)情況下，可拖動(dòng) DOM 元素上觸發(fā)的 DOM mousedown 事件時(shí)會(huì)觸發(fā) dragstart 事件。同樣，當(dāng)觸發(fā) DOMmouseup 事件時(shí)會(huì)觸發(fā) dragend 事件。將此值設(shè)置為 true 會(huì)延遲觸發(fā)拖動(dòng)事件，直到鼠標(biāo)從生成mousedown 或 mouseup 的位置移開(kāi)為止。此屬性的默認(rèn)值為 false。 （自 2.84 開(kāi)始）

枚舉 GGeoStatusCode

在圓括號(hào)中指定每個(gè)符號(hào)常數(shù)對(duì)應(yīng)的數(shù)值。

常數(shù)

常數(shù)說(shuō)明

G_GEO_SUCCESS = 200	未出現(xiàn)錯(cuò)誤，已對(duì)地址成功地進(jìn)行了解析，并返回其地址解析。 （自 2.55 開(kāi)始）
G_GEO_BAD_REQUEST = 400	無(wú)法成功解析行車路線請(qǐng)求。例如，如果此請(qǐng)求包含的路標(biāo)數(shù)大于允許的最大最大數(shù)，則該請(qǐng)求可能已被拒絕。 （自 2.81 開(kāi)始）
G_GEO_SERVER_ERROR = 500	無(wú)法成功處理地址解析或行車路線請(qǐng)求，但是確切的失敗原因未知。 （自 2.55 開(kāi)始）
G_GEO_MISSING_QUERY = 601	HTTP q 參數(shù)缺失或沒(méi)有值。對(duì)于地址解析請(qǐng)求，這意味著將空地址指定為輸入。對(duì)于行車路線請(qǐng)求，這意味著在輸入中未指定查詢。 （自 2.81 開(kāi)始）
G_GEO_MISSING_ADDRESS = 601	G_GEO_MISSING_QUERY 的同義名。 （自 2.55 開(kāi)始）
G_GEO_UNKNOWN_ADDRESS = 602	找不到指定地址的對(duì)應(yīng)地理位置。這可能是地址比較新，或地址不正確。 （自 2.55 開(kāi)始）
G_GEO_UNAVAILABLE_ADDRESS = 603	由于合法性或合同原因，無(wú)法返回指定地址的地址解析或指定行車路線查詢的路線。 （自 2.55 開(kāi)始）
G_GEO_UNKNOWN_DIRECTIONS = 604	Gdirections 對(duì)象無(wú)法計(jì)算查詢中提到的兩點(diǎn)之間的行車路線。這通常是因?yàn)閮牲c(diǎn)之間無(wú)可用路線，或我們沒(méi)有該地區(qū)的路線數(shù)據(jù)。 （自 2.81 開(kāi)始）
G_GEO_BAD_KEY = 610	指定的密鑰無(wú)效或與指定的域不匹配。 （自 2.55 開(kāi)始）
G_GEO_TOO_MANY_QUERIES = 620	指定的密鑰超出了 24 小時(shí)的請(qǐng)求限制或在過(guò)短的一段時(shí)間內(nèi)提交了過(guò)多的請(qǐng)求。如果您要同時(shí)或循環(huán)發(fā)送多個(gè)請(qǐng)求，請(qǐng)?jiān)诖a中使用計(jì)時(shí)器或暫停以確保不會(huì)過(guò)快地發(fā)送請(qǐng)求。 （自 2.55 開(kāi)始）

枚舉 GGeoAddressAccuracy

不存在為此枚舉定義的符號(hào)常數(shù)。

常數(shù)

常數(shù)說(shuō)明

0	未知的地點(diǎn)。 （自 2.59 開(kāi)始）
1	國(guó)家級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
2	地區(qū)（省/自治區(qū)/直轄市、轄區(qū)等）級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
3	子地區(qū)（縣、市等）級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
4	城鎮(zhèn)（城市、村鎮(zhèn)）級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
5	郵政編碼級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
6	街道級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
7	十字路口級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
8	地址級(jí)準(zhǔn)確度。 （自 2.59 開(kāi)始）
9	建筑物（樓房名稱、物業(yè)名稱、購(gòu)物中心等）級(jí)準(zhǔn)確度。 （自 2.105 開(kāi)始）

GClientGeocoder 類

此類用于和 Google 服務(wù)器建立直接通信，以獲取用戶指定地址的地址解析。另外，地址解析器可維護(hù)自己的地址緩存，可以無(wú)需往返于服務(wù)器而回答重復(fù)的查詢。作為常用的最佳做法，建議不要在回路中使用GClientGeocoder 函數(shù)。有多個(gè)地址要進(jìn)行地址解析的開(kāi)發(fā)人員或許應(yīng)改為使用我們的HTTP 地址解析器。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GClientGeocoder(cache?:GGeocodeCache)	創(chuàng)建地址解析器的新實(shí)例，直接與 Google 服務(wù)器對(duì)話。可選的緩存參數(shù)允許指定已知地址的自定義客戶端緩存。如果未指定緩存，則使用 GFactualGeocodeCache。 （自 2.55 開(kāi)始）

方法

方法返回值說(shuō)明

getLatLng(address:String, callback:function)	None	向 Google 服務(wù)器發(fā)送請(qǐng)求，對(duì)指定的地址進(jìn)行地址解析。如果地址已成功定位，則用 GLatLng 點(diǎn)調(diào)用用戶指定的回調(diào)函數(shù)。否則，向回調(diào)函數(shù)提供一個(gè)null 點(diǎn)。如果地址不明確，則僅向回調(diào)函數(shù)傳遞最匹配的點(diǎn)。 （自 2.55 開(kāi)始）
getLocations(query:String|GLatLng, callback:function)	None	此方法向 Google 地址解析服務(wù)發(fā)送請(qǐng)求，要求該服務(wù)對(duì)指定的 query 進(jìn)行解析并在指定的 callback 中處理響應(yīng)。“地址解析”是指將用戶可讀的地址轉(zhuǎn)換成經(jīng)度/緯度值。Google 地址解析服務(wù)還支持“反向地址解析”，其中提供的地理點(diǎn)會(huì)轉(zhuǎn)換成用戶可讀的地址。要使用此地址解析服務(wù)，請(qǐng)調(diào)用此方法將其傳遞給query 以進(jìn)行地址解析。如果將查詢作為可尋址的 String 提供，則該服務(wù)將進(jìn)行標(biāo)準(zhǔn)的地址解析。但是，如果query 包含 GLatLng，則該服務(wù)將進(jìn)行反轉(zhuǎn)地址解析。此方法需要調(diào)用 Google 服務(wù)器，因此您還必須傳遞callback 方法以處理響應(yīng)。此響應(yīng)將包含 Status 代碼，如果成功，則會(huì)包含一個(gè)或多個(gè) Placemark 對(duì)象。與 GClientGeocoder.getLatLng 方法不同，此回調(diào)函數(shù)可以通過(guò)檢查Status 字段來(lái)確定失敗的原因。 （自 2.55 開(kāi)始）
getCache()	GGeocodeCache	返回當(dāng)前使用的地址解析緩存或 null（如果不執(zhí)行客戶端緩存）。 （自 2.55 開(kāi)始）
setCache(cache:GGeocodeCache)	None	設(shè)置新的客戶端緩存。如果用設(shè)置為 null 的緩存調(diào)用此方法，則禁用客戶端緩存。設(shè)置新的緩存將會(huì)放棄以前存儲(chǔ)的地址。 （自 2.55 開(kāi)始）
setViewport(bounds:GLatLngBounds)	None	設(shè)置地址解析器以便在指定的視口內(nèi)或附近放大地址解析結(jié)果。該視口表示為 GLatLngBounds 矩形。請(qǐng)注意，盡管設(shè)置視口會(huì)提升結(jié)果優(yōu)先級(jí)，但不會(huì)將結(jié)果限制到該邊界框內(nèi)。 （自 2.82 開(kāi)始）
getViewport()	GLatLngBounds	返回視口，用于放大該地址解析器內(nèi)的地址解析結(jié)果。該視口表示為 GLatLngBounds 矩形。 （自 2.82 開(kāi)始）
setBaseCountryCode(countryCode:String)	None	設(shè)置地址解析器以偏移搜索結(jié)果，就像這些搜索結(jié)果是從指定國(guó)家/地區(qū)代碼頂級(jí)域 (ccTLD) 指定的域發(fā)送而來(lái)。地址解析僅在 Google 地圖本身支持地址解析的那些國(guó)家/地區(qū)中受支持。多數(shù) ccTLD 代碼與 ISO 3166-1 代碼相同，但有部分例外應(yīng)予以注意。例如，英國(guó)的 ccTLD 為“uk”(.co.uk)，而其 ISO 3166-1 代碼為“GB”。 請(qǐng)注意，默認(rèn)域是最初從中載入地圖 API 的域。國(guó)家/地區(qū)代碼不區(qū)分大小寫(xiě)。 （自 2.82 開(kāi)始）
getBaseCountryCode()	String	返回指定地址解析器使用的當(dāng)前國(guó)家/地區(qū)代碼。（如果無(wú)有效國(guó)家/地區(qū)代碼，則此方法返回 null。） （自 2.82 開(kāi)始）
reset()	None	重置地址解析器。具體而言，如果此地址解析器使用客戶端緩存，則此方法對(duì)其調(diào)用 GGeocodeCache.reset() 方法。 （自 2.55 開(kāi)始）

GGeocodeCache 類

此類維護(hù)從地址到已知地點(diǎn)的地圖。當(dāng)此類完全生效時(shí)，它可作為一個(gè)從中派生更完善的緩存的基類。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GGeocodeCache()	創(chuàng)建新的緩存，以便存儲(chǔ)從地址到地點(diǎn)的地圖。構(gòu)造函數(shù)立即調(diào)用 GGeocodeCache.reset 方法。 （自 2.55 開(kāi)始）

方法

方法返回值說(shuō)明

get(address:String)	Object	返回指定 address 下存儲(chǔ)的答復(fù)。如果未曾為指定的地址存儲(chǔ)過(guò)答復(fù)，則此方法返回 null。 （自 2.55 開(kāi)始）
isCachable(reply:Object)	Boolean	返回是否應(yīng)緩存指定的答復(fù)。默認(rèn)情況下，對(duì) reply 對(duì)象執(zhí)行初步檢查。具體而言，此類將確保對(duì)象不為 null 并且具有name 字段。可以通過(guò)擴(kuò)展類以提供有關(guān) reply 對(duì)象的更準(zhǔn)確的條件，來(lái)覆蓋此方法。 （自 2.55 開(kāi)始）
put(address:String, reply:Object)	None	在指定的 address 下存儲(chǔ)指定的 reply。此方法將調(diào)用 GGeocodeCache.isCachable 方法來(lái)驗(yàn)證是否可以緩存reply。如果得到允許，此方法會(huì)在借助 GGeocodeCache.toCanoninical 方法規(guī)范化的地址下緩存reply。 （自 2.55 開(kāi)始）
reset()	None	從緩存中清除所有答復(fù)。在此方法返回后，緩存為空。 （自 2.55 開(kāi)始）
toCanonical(address:String)	String	返回認(rèn)為是規(guī)范的地址版本。該地址版本將 address 參數(shù)轉(zhuǎn)換為小寫(xiě)，用空格替換逗號(hào)并用一個(gè)空格替換多個(gè)空格。 （自 2.55 開(kāi)始）

GFactualGeocodeCache 類

此類通過(guò)對(duì)緩存答復(fù)設(shè)定更嚴(yán)格的條件來(lái)進(jìn)一步優(yōu)化基本的 GGeocodeCache 類。它僅緩存短期內(nèi)更改可能性極小的答復(fù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GFactualGeocodeCache()	創(chuàng)建新的緩存，僅存儲(chǔ)視為實(shí)際存在的答復(fù)。 （自 2.55 開(kāi)始）

方法

方法返回值說(shuō)明

isCachable(reply:Object)	Boolean	覆蓋此方法的默認(rèn)實(shí)現(xiàn)，以便對(duì)狀態(tài)代碼執(zhí)行更徹底的檢查。只有 Status.code 設(shè)置為 G_GEO_SUCCESS 的答復(fù)或確認(rèn)無(wú)效的答復(fù)才視為可緩存。不緩存超時(shí)或?qū)е鲁Ｒ?guī)服務(wù)器錯(cuò)誤的答復(fù)。 （自 2.55 開(kāi)始）

GMarkerManager 類

此類可根據(jù)地圖的當(dāng)前視口和縮放級(jí)別管理地圖上數(shù)百個(gè)標(biāo)記的可見(jiàn)性。不推薦使用此類，建議開(kāi)發(fā)人員改為使用開(kāi)源 MarkerManager。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GMarkerManager(map:GMap, opts?:GMarkerManagerOptions)	創(chuàng)建新的標(biāo)記管理器，控制指定地圖的標(biāo)記可見(jiàn)性。 （自 2.67 開(kāi)始）

方法

方法返回值說(shuō)明

addMarkers(markers:GMarker[], minZoom:Number, maxZoom?:Number)	None	向此標(biāo)記管理器添加一批標(biāo)記。直到調(diào)用 refresh() 方法時(shí)，才會(huì)向地圖添加這批標(biāo)記。將標(biāo)記置于地圖中后，如果這些標(biāo)記都在地圖的當(dāng)前視口范圍內(nèi)并且地圖的縮放級(jí)別高于或等于指定的minZoom，則顯示標(biāo)記。如果給出了 maxZoom，則在地圖的縮放級(jí)別高于或等于指定級(jí)別時(shí)自動(dòng)刪除標(biāo)記。 （自 2.67 開(kāi)始）
addMarker(marker:GMarker, minZoom:Number, maxZoom?:Number)	None	向此管理器控制的標(biāo)記集合添加單個(gè)標(biāo)記。如果標(biāo)記的位置在地圖的當(dāng)前視口范圍內(nèi)，并且地圖的縮放級(jí)別屬于指定的縮放級(jí)別范圍，則立即向地圖添加標(biāo)記。與 addMarkers 方法類似，minZoom 和可選的 maxZoom 參數(shù)指定顯示標(biāo)記的縮放級(jí)別范圍。 （自 2.67 開(kāi)始）
refresh()	None	強(qiáng)制管理器更新地圖上顯示的標(biāo)記。如果是使用 addMarkers 方法添加的標(biāo)記，則必須調(diào)用此方法。 （自 2.67 開(kāi)始）
getMarkerCount(zoom:Number)	Number	返回在指定縮放級(jí)別潛在可見(jiàn)的標(biāo)記總數(shù)。這可能包括較低縮放級(jí)別的標(biāo)記。 （自 2.67 開(kāi)始）

事件

事件說(shuō)明

changed(bounds:GBounds, markerCount:Number)	在地圖中添加或刪除了管理器所管理的標(biāo)記后，會(huì)觸發(fā)此事件。。事件處理程序函數(shù)應(yīng)準(zhǔn)備接受兩個(gè)參數(shù)。第一個(gè)參數(shù)是定義可見(jiàn)網(wǎng)格邊界的矩形。第二個(gè)參數(shù)傳遞地圖上當(dāng)前顯示的標(biāo)記數(shù)目。

GMarkerManagerOptions 類

此類代表 GMarkerManager 構(gòu)造函數(shù)的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

borderPadding	Number	指定管理器所監(jiān)控的地圖當(dāng)前視口以外的額外填充（以像素表示）。即使此額外填充范圍內(nèi)的標(biāo)記不完全可見(jiàn)，也會(huì)將它們添加到地圖中。 （自 2.67 開(kāi)始）
maxZoom	Number	設(shè)置標(biāo)記管理器所監(jiān)控的最高縮放級(jí)別。如果未指定，則管理器采用最高地圖縮放級(jí)別。如果將標(biāo)記添加到管理器時(shí)沒(méi)有使用可選 maxZoom 參數(shù)，也要使用此值。 （自 2.67 開(kāi)始）
trackMarkers	Boolean	指定標(biāo)記管理器是否應(yīng)跟蹤標(biāo)記移動(dòng)。如果希望使用 setPoint 方法移動(dòng)受管理的標(biāo)記，則應(yīng)將此選項(xiàng)設(shè)置為 true。默認(rèn)值為false。 （自 2.67 開(kāi)始）

GGeoXml 類

GGeoXml 對(duì)象將可公開(kāi)訪問(wèn)的網(wǎng)絡(luò)服務(wù)器上托管的 XML 文件（如 KML 文件）中的地理內(nèi)容添加到地圖上。它實(shí)現(xiàn)GOverlay 接口，因此可使用GMap2.addOverlay() 方法添加到地圖中。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GGeoXml(urlOfXml:String, callback?:function)	創(chuàng)建表示該 XML 文件的 GOverlay。當(dāng)GGeoXml 對(duì)象完成載入 XML 文件時(shí)會(huì)調(diào)用可選的回調(diào)函數(shù)。。 （自 2.108 開(kāi)始不推薦使用）
GGeoXml(urlOfXml:String)	創(chuàng)建表示該 XML 文件的 GOverlay。 （自 2.108 開(kāi)始）

方法

方法返回值說(shuō)明

getTileLayerOverlay()	GTileLayerOverlay	GGeoXml 對(duì)象可創(chuàng)建圖塊疊加層，在某些情況下可起到優(yōu)化作用。此方法將返回此圖塊層疊加層（如果有）。請(qǐng)注意，如果不需要圖塊疊加層或GGeoXml 文件尚未完成載入，則圖塊疊加層可能null。 （自 2.84 開(kāi)始）
getDefaultCenter()	GLatLng	以 lat/lng 返回默認(rèn)視口的中心點(diǎn)。只有在載入完文件后才可調(diào)用此函數(shù)。 （自 2.84 開(kāi)始）
getDefaultSpan()	GLatLng	以 lat/lng 返回默認(rèn)視口的跨度。只有在載入完文件后才可調(diào)用此函數(shù)。 （自 2.84 開(kāi)始）
getDefaultBounds()	GLatLngBounds	返回默認(rèn)視口的邊界框。只有在載入完文件后才可調(diào)用此函數(shù)。 （自 2.84 開(kāi)始）
gotoDefaultViewport(map:GMap2)	None	將地圖的視口設(shè)置為 XML 文件的默認(rèn)視口。 （自 2.84 開(kāi)始）
hasLoaded()	Boolean	檢查 XML 文件是否已完成載入，如果完成則返回 true。如果尚未載入完 XML 文件，則此方法返回 false。 （自 2.84 開(kāi)始）
hide()	None	如果疊加層當(dāng)前可見(jiàn)并且疊加層的 supportsHide() 方法返回 true，則隱藏 GGeoXml 對(duì)象創(chuàng)建的子疊加層。請(qǐng)注意，此方法會(huì)針對(duì)每個(gè)觸發(fā)了該事件（例如GMarker.visibilitychanged 和GGroundOverlay.visibilitychanged 等）的子疊加層分別觸發(fā)visibilitychanged 事件。如果當(dāng)前沒(méi)有使 supportsHide() 返回 true 的可見(jiàn)疊加層，則此方法無(wú)效。 （自 2.87 開(kāi)始）
isHidden()	Boolean	如果 GGeoXml 對(duì)象當(dāng)前因被GGeoXml.hide() 方法進(jìn)行了更改而不可見(jiàn)，則返回true。否則，返回 false。 （自 2.87 開(kāi)始）
loadedCorrectly()	Boolean	檢查 XML 文件是否已正確載入，如果是，則返回 true。如果 XML 文件未正確載入，則此方法返回 false。如果 XML 文件尚未完成載入，則此方法的返回值是“undefined”。 （自 2.84 開(kāi)始）
show()	None	如果 GGeoXml 對(duì)象創(chuàng)建的子疊加層當(dāng)前不可見(jiàn)，則顯示它們。請(qǐng)注意，此方法會(huì)針對(duì)每個(gè)觸發(fā)了該事件（例如GMarker.visibilitychanged 和GGroundOverlay.visibilitychanged 等）的子疊加層分別觸發(fā)visibilitychanged 事件。 （自 2.87 開(kāi)始）
supportsHide()	Boolean	總是返回 true。 （自 2.87 開(kāi)始）

事件

事件說(shuō)明

load()	已完整載入 GGeoXml 的 XML 文件并且所有關(guān)聯(lián)的疊加層已在地圖上顯示時(shí)，或者 XML 文件未正確載入時(shí)，會(huì)觸發(fā)此事件。 （自 2.108 開(kāi)始）

函數(shù) GDownloadUrl

此函數(shù)提供一種便利方式，可異步檢索按網(wǎng)址標(biāo)識(shí)的資源。請(qǐng)注意，由于 XmlHttpRequest 對(duì)象用于執(zhí)行請(qǐng)求，因此它受跨站腳本的同源限制，即網(wǎng)址必須指向與當(dāng)前執(zhí)行此代碼的文檔的網(wǎng)址相同的服務(wù)器。因此，對(duì)url 參數(shù)使用絕對(duì)網(wǎng)址通常是多余的，最好僅使用絕對(duì)或相對(duì)路徑。處理拋出的任何異常（如安全錯(cuò)誤）都是調(diào)用者的職責(zé)。

函數(shù)

方法返回值說(shuō)明

GDownloadUrl(url:String, onload:Function, postBody?:String, postContentType?:String)	None	從指定的網(wǎng)址中檢索資源，然后通過(guò)將文檔文本作為第一參數(shù)、將 HTTP 響應(yīng)狀態(tài)代碼作為第二參數(shù)來(lái)調(diào)用 onload 函數(shù)。如果請(qǐng)求超時(shí)，則可將 null 作為第一參數(shù)、-1 作為第二參數(shù)調(diào)用 onload 函數(shù)。此函數(shù)在默認(rèn)情況下會(huì)發(fā)送 HTTP GET 請(qǐng)求。要發(fā)送 HTTP POST 請(qǐng)求，請(qǐng)傳遞可選postBody 參數(shù)中的數(shù)據(jù)。如果發(fā)送的數(shù)據(jù)的類型不是“application/x-www-form-urlencoded”，則將內(nèi)容類型作為字符串傳遞到postContentType 參數(shù)中。此方法受跨站腳本限制。請(qǐng)注意，此方法使用瀏覽器的底層 XmlHttpRequest 實(shí)現(xiàn)。

函數(shù) GBrowserIsCompatible

此函數(shù)確定地圖 API 是否可用于當(dāng)前的瀏覽器中。

函數(shù)

方法返回值說(shuō)明

GBrowserIsCompatible()	Boolean	如果當(dāng)前瀏覽器支持地圖 API 庫(kù)，則返回 true。

函數(shù) GUnload

您可調(diào)用此函數(shù)使地圖 API 清理內(nèi)部數(shù)據(jù)結(jié)構(gòu)以釋放內(nèi)存。這有助于解除可導(dǎo)致網(wǎng)絡(luò)應(yīng)用程序中內(nèi)存泄漏的各種瀏覽器故障。您應(yīng)在頁(yè)面的 unload 事件處理程序中調(diào)用此函數(shù)。調(diào)用此函數(shù)后，在此頁(yè)面中創(chuàng)建的地圖對(duì)象會(huì)出現(xiàn)功能混亂。

函數(shù)

方法返回值說(shuō)明

GUnload()	None	刪除所有注冊(cè)的事件處理程序以防止內(nèi)存泄漏。應(yīng)作為 unload 事件的處理程序進(jìn)行調(diào)用。

GDirections 類

此類用于獲取行車路線的結(jié)果，并將它顯示在地圖上和/或文本面板中。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GDirections(map?:GMap2, panel?:Element)

創(chuàng)建行車路線對(duì)象的新實(shí)例，以請(qǐng)求和存儲(chǔ)行車路線的結(jié)果。如果使用 GDirections.load() 方法進(jìn)行查詢，則此行車路線對(duì)象可創(chuàng)建行車路線。 構(gòu)造函數(shù)采用可選的地圖對(duì)象（顯示計(jì)算出的行車路線的折線）和/或面板 DIV 元素（以文本形式顯示行車路線結(jié)果）。 如果傳遞了 map 參數(shù)，則只要計(jì)算出新的行車路線結(jié)果，與結(jié)果關(guān)聯(lián)的折線和標(biāo)記就會(huì)作為疊加層自動(dòng)添加到地圖上。同樣，傳遞了 panel 參數(shù)后，與結(jié)果關(guān)聯(lián)的文本格式的行車路線就會(huì)添加到指定的 DIV 中，以替換 DIV 中任何現(xiàn)有內(nèi)容。 如果上述參數(shù)中有任何一個(gè)為 null，則直到使用 GDirections.load() 方法發(fā)出顯式請(qǐng)求后才檢索相關(guān)元素。（如下所示。） 此外，該對(duì)象還包含三個(gè)事件偵聽(tīng)器，可以截獲： “l(fā)oad”：通過(guò) GDirections.load() 發(fā)布的行車路線查詢結(jié)果可用時(shí)會(huì)觸發(fā)此事件。請(qǐng)注意，load() 方法會(huì)啟動(dòng)一個(gè)新的查詢，該查詢一旦完成載入又會(huì)觸發(fā)一個(gè)“l(fā)oad”事件。將任何疊加層元素添加到地圖/面板之前都會(huì)觸發(fā)“l(fā)oad”事件。 “addoverlay”：在將折線和/或文本格式的行車路線組件添加到地圖和/或 DIV 元素之后會(huì)觸發(fā)此事件。請(qǐng)注意，如果不將其中任何一個(gè)元素附加到GDirections 對(duì)象，則不會(huì)觸發(fā)“addoverlay”事件。 “error”：如果行車路線請(qǐng)求導(dǎo)致錯(cuò)誤，則觸發(fā)此事件。調(diào)用者可以使用 GDirections.getStatus() 獲取有關(guān)該錯(cuò)誤的詳細(xì)信息。當(dāng)發(fā)生“error”事件時(shí)，不會(huì)觸發(fā)“l(fā)oad”或“addoverlay”事件。 （自 2.81 開(kāi)始）

方法

方法返回值說(shuō)明

load(query:String, queryOpts?:GDirectionsOptions)	None	此方法將發(fā)布新的行車路線查詢。query 參數(shù)為字符串，包含所有有效的行車路線查詢，例如，“from: Seattle to: San Francisco”或“from: Toronto to: Ottawa to: New York”。默認(rèn)情況下，如果在構(gòu)造GDirections 對(duì)象時(shí)指定了地圖，則該查詢將請(qǐng)求折線結(jié)果。同樣，如果指定了文本面板，該查詢也會(huì)請(qǐng)求詳細(xì)的文本結(jié)果。否則，結(jié)果只包含已找到路線的摘要信息。 為了覆蓋此行為（比如，即使未將地圖附加到此對(duì)象，也可請(qǐng)求折線信息），調(diào)用者可使用 queryOpts 可選參數(shù)。有關(guān)詳細(xì)信息，請(qǐng)參見(jiàn) GDirectionsOptions 文檔。 收到行車路線結(jié)果時(shí)，此對(duì)象清除舊結(jié)果，代之以新結(jié)果并用新結(jié)果更新地圖和/或面板。行車路線結(jié)果由多條路線組成（GRoute 類型的對(duì)象），查詢中指定的每個(gè)連續(xù)路標(biāo)/地址對(duì)都有一條路線。而路線又由多個(gè)路段組成（GStep 類型的對(duì)象）。 如果在重新調(diào)用 load() 時(shí)還未完成前一 load() 請(qǐng)求，則取消先前的請(qǐng)求。因此，可以使用單個(gè) GDirections 對(duì)象連續(xù)發(fā)布行車路線請(qǐng)求，但要并行生成多個(gè)請(qǐng)求則必須使用多個(gè)GDirections 對(duì)象。 （自 2.81 開(kāi)始）
loadFromWaypoints(waypoints:Array, queryOpts?:GDirectionsOptions)	None	使用路標(biāo)數(shù)組（而不是單一查詢字符串）作為輸入來(lái)發(fā)布新的行車路線查詢。此數(shù)組最多可包含 25 個(gè)路標(biāo)條目。數(shù)組中的每一項(xiàng)都是一個(gè)表示輸入地址或（緯度，經(jīng)度）點(diǎn)的字符串。有關(guān)此方法行為的詳細(xì)信息，請(qǐng)參見(jiàn)GDirections.load()。 （自 2.81 開(kāi)始）
clear()	None	清除全部現(xiàn)有的行車路線結(jié)果，從地圖和面板中刪除疊加層，并取消任何未決 load() 請(qǐng)求。 （自 2.81 開(kāi)始）
getStatus()	Object	返回行車路線請(qǐng)求狀態(tài)。返回的對(duì)象具有以下形式： { ??code: 200 ??request: "directions" } 該狀態(tài)代碼可以采用 GGeoStatusCode 中定義的任意值。 （自 2.81 開(kāi)始）
getBounds()	GLatLngBounds	此方法用于獲取此行車路線查詢結(jié)果的邊界框。如果無(wú)法提供成功的結(jié)果，則返回 GLatLngBounds 對(duì)象或 null。 （自 2.81 開(kāi)始）
getNumRoutes()	Number	返回結(jié)果中可用的路線數(shù)目。對(duì)于成功的查詢，該數(shù)目應(yīng)該是輸入路標(biāo)總數(shù)減 1。當(dāng)沒(méi)有可用結(jié)果時(shí)（因?yàn)槲窗l(fā)布查詢或先前的查詢失敗），此方法返回 0。 （自 2.81 開(kāi)始）
getRoute(i:Number)	GRoute	在響應(yīng)中為第 i 條路線返回 GRoute 對(duì)象。 （自 2.81 開(kāi)始）
getNumGeocodes()	Number	返回結(jié)果中可用的地址解析項(xiàng)的數(shù)目。對(duì)于成功的查詢，此數(shù)目應(yīng)等于輸入路標(biāo)的總數(shù)目。當(dāng)不存在可用結(jié)果時(shí)（因?yàn)槲窗l(fā)布查詢或先前的查詢失敗），此方法返回 0。 （自 2.81 開(kāi)始）
getGeocode(i:Number)	Object	返回第 i 個(gè)路標(biāo)的地址解析結(jié)果。此對(duì)象的結(jié)構(gòu)與 GClientGeocoder 對(duì)象的響應(yīng)中單個(gè)地標(biāo)的結(jié)構(gòu)相同。 （自 2.81 開(kāi)始）
getCopyrightsHtml()	String	返回 HTML 字符串，它包含此結(jié)果的版權(quán)信息。 （自 2.81 開(kāi)始）
getSummaryHtml()	String	返回包含對(duì)整個(gè)行車路線請(qǐng)求的距離和時(shí)間的概述的 HTML 代碼段。請(qǐng)注意，此摘要是返回給構(gòu)造時(shí)無(wú)關(guān)聯(lián)地圖或 DIV 元素的 GDirections 對(duì)象的唯一信息。 （自 2.81 開(kāi)始）
getDistance()	Object	返回一個(gè)表示行車路線請(qǐng)求總距離（跨所有路線）的對(duì)象常量。對(duì)象包含兩個(gè)字段：一個(gè)是稱為“meters”的數(shù)字，表示距離的數(shù)值（以米為單位）；一個(gè)是稱為“html”的字符串，包含本地化的距離字符串表示（以此行車路線組合的出發(fā)國(guó)家/地區(qū)的通用度量單位為單位）。 （自 2.81 開(kāi)始）
getDuration()	Object	返回一個(gè)表示行車路線請(qǐng)求總時(shí)間（跨所有路線）的對(duì)象常量。對(duì)象包含兩個(gè)字段：一個(gè)是稱為“seconds”的數(shù)字，表示時(shí)間的數(shù)值（以秒為單位），另一個(gè)是稱為“html”的字符串，包含時(shí)間的本地化字符串表示。 （自 2.81 開(kāi)始）
getPolyline()	GPolyline	返回與整個(gè)行車路線響應(yīng)相關(guān)聯(lián)的 GPolyline 對(duì)象。請(qǐng)注意，在響應(yīng)中有一條表示所有路線的折線。只有在載入了行車路線結(jié)果（即觸發(fā)“l(fā)oad”事件）后，才能定義此對(duì)象。 （自 2.81 開(kāi)始）
getMarker(i:Number)	GMarker	返回與第 i 條地址解析相關(guān)聯(lián)的標(biāo)記。只有在載入了行車路線結(jié)果（即觸發(fā)“l(fā)oad”事件）后，此方法才能返回非空值。 （自 2.81 開(kāi)始）

GDirectionsOptions 類

此類表示 GDirections.load() 和GDirections.loadFromWaypoints() 方法的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

locale	String	用于行車路線結(jié)果的區(qū)域。例如：“en_US”、“fr”和“fr_CA”等。
travelMode	GTravelModes	出行模式，如駕車（默認(rèn)值）或步行。 （自 2.129 開(kāi)始）
avoidHighways	Boolean	如果為 true，則行車路線會(huì)在計(jì)算行車路線時(shí)試圖排除高速公路。請(qǐng)注意，如果沒(méi)有可行方案，則行車路線可能仍會(huì)選擇高速公路。 （自 2.124 開(kāi)始）
getPolyline	Boolean	默認(rèn)情況下，僅在地圖與 GDirections 對(duì)象關(guān)聯(lián)時(shí)，GDirections.load*() 方法才會(huì)抓取折線數(shù)據(jù)。此字段可用于覆蓋此行為，使得即使地圖不與 Directions 對(duì)象關(guān)聯(lián)也可檢索折線數(shù)據(jù)。
getSteps	Boolean	默認(rèn)情況下，僅在面板與 GDirections.load*() 對(duì)象關(guān)聯(lián)時(shí)，GDirections 方法才會(huì)抓取步驟數(shù)據(jù)。此字段可用于覆蓋此行為，使得即使不向 Directions 對(duì)象添加面板也可檢索路段數(shù)據(jù)。
preserveViewport	Boolean	默認(rèn)情況下，當(dāng) Directions 對(duì)象包含地圖時(shí)，地圖將處于中心位置并縮放到行車路線結(jié)果的邊界框大小。當(dāng)此選項(xiàng)設(shè)置為 true 時(shí)，只為此請(qǐng)求保留視口（除非在第一個(gè)位置從未設(shè)置它）。

枚舉 GTravelModes

常數(shù)

常數(shù)說(shuō)明

G_TRAVEL_MODE_WALKING	步行 （自 2.129 開(kāi)始）
G_TRAVEL_MODE_DRIVING	駕車 （自 2.129 開(kāi)始）

GRoute 類

此類的對(duì)象由 GDirections 對(duì)象創(chuàng)建，可在行車路線結(jié)果中存儲(chǔ)單條路線的信息。此類沒(méi)有公共構(gòu)造函數(shù)。客戶端不應(yīng)直接創(chuàng)建此類的對(duì)象。

方法

方法返回值說(shuō)明

getNumSteps()	Number	返回此路線的路段數(shù)。 （自 2.81 開(kāi)始）
getStep(i:Number)	GStep	返回此路線中第 i 條路段的 Gstep 對(duì)象。 （自 2.81 開(kāi)始）
getStartGeocode()	Object	返回此路線出發(fā)點(diǎn)的地址解析結(jié)果。此對(duì)象的結(jié)構(gòu)與 GClientGeocoder 對(duì)象的響應(yīng)中單個(gè)地標(biāo)的結(jié)構(gòu)相同。 （自 2.83 開(kāi)始）
getEndGeocode()	Object	返回此路線終點(diǎn)的地址解析結(jié)果。此對(duì)象的結(jié)構(gòu)與 GClientGeocoder 對(duì)象的響應(yīng)中單個(gè)地標(biāo)的結(jié)構(gòu)相同。 （自 2.83 開(kāi)始）
getEndLatLng()	GLatLng	為此路線的折線最后一點(diǎn)返回 GLatLng 對(duì)象。請(qǐng)注意，此點(diǎn)可能不同于GRoute.getEndGeocode() 中的“經(jīng)度, 緯度”，因?yàn)間etEndLatLng() 總是返回對(duì)齊到路網(wǎng)的點(diǎn)。沒(méi)有對(duì)應(yīng)的 getStartLatLng() 方法，因?yàn)槠渑c調(diào)用GRoute.getStep(0).getLatLng() 相同。 （自 2.81 開(kāi)始）
getSummaryHtml()	String	返回包含此路線的距離和時(shí)間概述的 HTML 代碼段。 （自 2.81 開(kāi)始）
getDistance()	Object	返回表示此路線總距離的對(duì)象常量。有關(guān)此對(duì)象的結(jié)構(gòu)，請(qǐng)參見(jiàn) GDirections.getDistance()。 （自 2.81 開(kāi)始）
getDuration()	Object	返回表示此路線總時(shí)間的對(duì)象常量。有關(guān)此對(duì)象的結(jié)構(gòu)，請(qǐng)參見(jiàn) GDirections.getDuration()。 （自 2.81 開(kāi)始）

GStep 類

此類的對(duì)象由 GDirections 對(duì)象創(chuàng)建，可在行車路線結(jié)果中存儲(chǔ)一條路線中單個(gè)路段的信息。此類沒(méi)有公共構(gòu)造函數(shù)。客戶端不應(yīng)直接創(chuàng)建此類的對(duì)象。

方法

方法返回值說(shuō)明

getLatLng()	GLatLng	為此路段的折線開(kāi)始點(diǎn)返回 GLatLng 對(duì)象。 （自 2.81 開(kāi)始）
getPolylineIndex()	Number	返回此路段的折線開(kāi)始點(diǎn)的索引。 （自 2.81 開(kāi)始）
getDescriptionHtml()	String	返回包含此路段描述的 HTML 字符串。 （自 2.81 開(kāi)始）
getDistance()	Object	返回表示此路段總距離的對(duì)象常量。有關(guān)此對(duì)象的結(jié)構(gòu)，請(qǐng)參見(jiàn) GDirections.getDistance()。 （自 2.81 開(kāi)始）
getDuration()	Object	返回表示此路段總時(shí)間的對(duì)象常量。有關(guān)此對(duì)象的結(jié)構(gòu)，請(qǐng)參見(jiàn) GDirections.getDuration()。 （自 2.81 開(kāi)始）

GTrafficOverlay 類

GTrafficOverlay 對(duì)象將顯示道路交通信息的疊加層添加到地圖中。它實(shí)現(xiàn)GOverlay 接口，因此可使用GMap2.addOverlay() 方法添加到地圖中，并可使用GMap2.removeOverlay() 方法刪除。GTrafficOverlay 僅顯示受支持城市的交通信息。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GTrafficOverlay(opts?:GTrafficOverlayOptions)	創(chuàng)建新的 GTrafficOverlay 對(duì)象，顯示道路交通信息。 （自 2.81 開(kāi)始）

方法

方法返回值說(shuō)明

hide()	None	隱藏交通疊加層。 （自 2.81 開(kāi)始）
show()	None	顯示交通疊加層。 （自 2.81 開(kāi)始）

事件

事件說(shuō)明

changed(hasTrafficInView:Boolean)	在當(dāng)前的視口中更改交通數(shù)據(jù)的狀態(tài)時(shí)會(huì)觸發(fā)此事件。在含有交通數(shù)據(jù)和不含有交通數(shù)據(jù)的兩個(gè)地區(qū)之間移動(dòng)地圖時(shí)，或向地圖添加 GTrafficOverlay 導(dǎo)致交通數(shù)據(jù)顯示在當(dāng)前視口中時(shí)，會(huì)觸發(fā)此事件。如果視口包含交通數(shù)據(jù)，則hasTrafficInView 參數(shù)為 true，否則為 false。不管是隱藏還是顯示該層，此事件都會(huì)起作用。 （自 2.85 開(kāi)始）

GTrafficOverlayOptions 類

此類代表 GTrafficOverlay 構(gòu)造函數(shù)的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

incidents	Boolean	設(shè)置為 true 時(shí)，表示 GTrafficOverlay 應(yīng)在地圖相應(yīng)位置上顯示交通事故。默認(rèn)情況下，該值設(shè)置為false。 （自 2.121 開(kāi)始）
hide	Boolean	設(shè)置為 true 時(shí)，表示地圖不應(yīng)一開(kāi)始就顯示 GTrafficOverlay。要打開(kāi)疊加層，請(qǐng)調(diào)用GTrafficOverlay.show()。默認(rèn)情況下，該值設(shè)置為false。 （自 2.121 開(kāi)始）

GAdsManager 類

GAdsManager 對(duì)象抓取AdSense 廣告并將它們顯示在指定的地圖中。廣告顯示為 GMarker，點(diǎn)擊它可在標(biāo)記信息窗口顯示廣告。GAdsManager 根據(jù)當(dāng)前視口大小和周圍的頁(yè)面文本內(nèi)容選擇 AdSense 廣告。請(qǐng)注意，向地圖添加 GAdsManager 時(shí)，還必須使用enable() 方法專門(mén)啟用它。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GAdsManager(map:GMap2, publisherId:String, adsManagerOptions?:GAdsManagerOptions)	創(chuàng)建新的 GAdsManager 對(duì)象，從 Google 服務(wù)器請(qǐng)求 AdSense 廣告。map 參數(shù)可識(shí)別此GAdsManager 應(yīng)在其上顯示廣告的地圖。publisherId 參數(shù)指定開(kāi)發(fā)人員的 AdSense 帳戶。adsManagerOptions 參數(shù)是GAdsManagerOptions 對(duì)象常量。 （自 2.85 開(kāi)始）

方法

方法返回值說(shuō)明

enable()	None	啟用抓取廣告。默認(rèn)情況下，不抓取廣告。 （自 2.85 開(kāi)始）
disable()	None	禁用抓取廣告。 （自 2.85 開(kāi)始）

GAdsManagerOptions 類

此類存儲(chǔ) GAdsManager 構(gòu)造函數(shù)的可選參數(shù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

maxAdsOnMap	Number	任何時(shí)候可在地圖上顯示的最大廣告數(shù)。默認(rèn)值是 3。 （自 2.85 開(kāi)始）
channel	Number	用于抓取廣告的 AdSense 渠道數(shù)。渠道是 AdSense 發(fā)行人可用來(lái)從多個(gè)來(lái)源跟蹤廣告收入的可選功能。 （自 2.85 開(kāi)始）
minZoomLevel	Number	顯示廣告的最低縮放級(jí)別。默認(rèn)值是 6。 （自 2.85 開(kāi)始）

GStreetviewPanorama 類

GStreetviewPanorama 對(duì)象包含 Flash? Street View Panorama 查看器的實(shí)例。此類的每個(gè)對(duì)象都包含一個(gè)單獨(dú)的實(shí)例，顯示唯一視圖。該對(duì)象通常嵌入諸如DIV 的容器對(duì)象中，并且可以使用此類的方法更改其視圖。并不是所有位置都有街道視圖數(shù)據(jù)。使用 GStreetviewClient 對(duì)象或GStreetviewOverlay 對(duì)象確定是否有您的位置的街道視圖數(shù)據(jù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GStreetviewPanorama(container:Node, opts?:GStreetviewPanoramaOptions)	使用所提供容器中相應(yīng)的 flash 查看器創(chuàng)建新的 GStreetviewPanorama 對(duì)象。在可選的GStreetviewPanoramaOptionsopts 對(duì)象中或通過(guò)調(diào)用 setLocationAndPOV 指定位置之前，將不會(huì)顯示該查看器。 （自 2.104 開(kāi)始）

方法

方法返回值說(shuō)明

remove()	None	從 DOM 中刪除當(dāng)前與此對(duì)象關(guān)聯(lián)的 flash 查看器的實(shí)例。在刪除 HTML 容器元素之前必須調(diào)用此函數(shù)，否則有些瀏覽器將無(wú)法對(duì)該flash 查看器進(jìn)行垃圾收集。 （自 2.104 開(kāi)始）
setContainer(container:Node)	None	為該 flash 查看器設(shè)置容器元素，如果該查看器當(dāng)前是打開(kāi)的，則從其舊位置對(duì)它進(jìn)行移動(dòng)。 （自 2.104 開(kāi)始）
checkResize()	None	通知 flash 查看器其容器大小已更改。在更改了容器 DOM 對(duì)象的大小后調(diào)用此方法，以便查看器能夠適合于新的大小。 （自 2.104 開(kāi)始）
hide()	None	隱藏該 flash 查看器。要?jiǎng)h除該查看器，請(qǐng)調(diào)用 .remove()。 （自 2.104 開(kāi)始）
show()	None	顯示該 flash 查看器。 （自 2.104 開(kāi)始）
isHidden()	boolean	如果與此對(duì)象相關(guān)聯(lián)的 flash 查看器不可見(jiàn)，則返回 true，否則返回 false。 （自 2.104 開(kāi)始）
getPOV()	GPov	返回該 flash 查看器中顯示的當(dāng)前視點(diǎn) (POV)。 （自 2.104 開(kāi)始）
setPOV(pov:GPov)	None	在不更改其位置的情況下更改該 flash 查看器中顯示的當(dāng)前視點(diǎn) (POV)。 （自 2.104 開(kāi)始）
panTo(pov:GPov, opt_longRoute:Boolean)	None	在不更改其位置的情況下更改該 flash 查看器中顯示的當(dāng)前視點(diǎn) (POV)。執(zhí)行從當(dāng)前 POV 到新 POV 的平滑動(dòng)畫(huà)。如果設(shè)置了 opt_longRoute，則動(dòng)畫(huà)會(huì)沿球體的長(zhǎng)路線，否則沿最短的路線。 （自 2.104 開(kāi)始）
setLocationAndPOV(latlng:GLatLng, opt_pov:GPov)	None	設(shè)置該 flash 查看器的位置和 POV。調(diào)用該函數(shù)后，查看器會(huì)顯示距離提供的 latlng（若存在）最近的位置。如果該位置沒(méi)有數(shù)據(jù)，那么該 flash 播放器會(huì)保持不變并顯示錯(cuò)誤代碼。有關(guān)可能的響應(yīng)代碼，請(qǐng)參見(jiàn)GStreetviewClient.ReturnValues。 （自 2.104 開(kāi)始）
followLink(yaw:Number)	None	點(diǎn)擊從當(dāng)前全景到相鄰全景的鏈接。yaw 指定相鄰全景的方向；如果存在多個(gè)相鄰全景，則采用最近的匹配。 （自 2.104 開(kāi)始）

事件

事件說(shuō)明

yawchanged(yaw:Number)	flash 查看器中顯示的偏角更改時(shí)觸發(fā)該事件。 （自 2.104 開(kāi)始）
pitchchanged(pitch:Number)	flash 查看器中顯示的傾斜度更改時(shí)觸發(fā)該事件。 （自 2.104 開(kāi)始）
zoomchanged(zoom:Number)	flash 查看器的縮放級(jí)別更改時(shí)觸發(fā)該事件。 （自 2.104 開(kāi)始）
error(errorCode:GStreetviewPanorama.ErrorValues)	發(fā)生錯(cuò)誤時(shí)觸發(fā)該事件。有關(guān)錯(cuò)誤類型的列表，請(qǐng)參見(jiàn) GStreetviewPanorama.ErrorValues。 （自 2.104 開(kāi)始）
initialized(location:GStreetviewLocation)	移動(dòng)到新位置后初始化全景時(shí)觸發(fā)該事件。該位置是一個(gè) GStreetviewLocation 對(duì)象。注意：首次顯示全景時(shí)不會(huì)發(fā)送initialized 事件；這是一個(gè)已知問(wèn)題，我們計(jì)劃在以后的版本中對(duì)其進(jìn)行修正。 （自 2.104 開(kāi)始）

GStreetviewPanoramaOptions 類

此類表示傳遞到 GStreetviewPanorama 構(gòu)造函數(shù)的選項(xiàng)。該類沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。所有屬性都是“可選的”。

屬性

屬性類型說(shuō)明

latlng	GLatLng	打開(kāi) flash 查看器的 latlng。 （自 2.104 開(kāi)始）
pov	GPov	打開(kāi) flash 查看器的照相機(jī)方向。 （自 2.104 開(kāi)始）

GStreetviewOverlay 類

GStreetviewOverlay 對(duì)象是一個(gè)圖塊集，突出顯示有街道視圖數(shù)據(jù)的位置。此類實(shí)現(xiàn)GOverlay 接口，并且可使用map.addOverlay 添加到地圖中，使用 map.removeOverlay 刪除。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GStreetviewOverlay()	創(chuàng)建實(shí)現(xiàn) GOverlay 接口的新GStreetviewOverlay。 （自 2.104 開(kāi)始）

事件

事件說(shuō)明

changed(hasStreetviewData:Boolean)	當(dāng)前視口中街道視圖數(shù)據(jù)的狀態(tài)變化時(shí)會(huì)觸發(fā)此事件。將地圖從具有街道視圖數(shù)據(jù)的區(qū)域移動(dòng)到?jīng)]有街道視圖數(shù)據(jù)的區(qū)域時(shí)會(huì)觸發(fā)此事件，反之亦然。當(dāng)向地圖添加 GStreetviewOverlay 導(dǎo)致在視口中顯示街道視圖數(shù)據(jù)時(shí)也會(huì)觸發(fā)此事件。如果視口包含街道視圖數(shù)據(jù)，則hasStreetviewData 參數(shù)為 true，否則為 false。 （自 2.120 開(kāi)始）

GStreetviewClient 類

GStreetviewClient 對(duì)象基于傳遞到其方法的參數(shù)搜索街道視圖數(shù)據(jù)。

構(gòu)造函數(shù)

構(gòu)造函數(shù)說(shuō)明

GStreetviewClient()	創(chuàng)建新的 GStreetviewClient （自 2.104 開(kāi)始）

方法

方法返回值說(shuō)明

getNearestPanoramaLatLng(latlng:GLatLng, callback:Function(GLatLng))	None	查找離指定點(diǎn)最近的全景的 GLatLng，并將其傳遞給提供的回調(diào)函數(shù)。如果附近沒(méi)有全景，或者服務(wù)器發(fā)生錯(cuò)誤，則為提供的回調(diào)函數(shù)傳遞 null 值。 （自 2.104 開(kāi)始）
getNearestPanorama(latlng:GLatLng, callback:Function(GStreetviewData))	None	檢索離指定的 latlng 最近的全景的數(shù)據(jù)，并將其作為 GStreetviewData 對(duì)象傳遞給提供的回調(diào)函數(shù)。 （自 2.104 開(kāi)始）
getPanoramaById(panoId:string, callback:Function(GStreetviewData))	None	檢索指定全景 ID 的數(shù)據(jù)，并將其作為 GStreetviewData 對(duì)象傳遞給提供的回調(diào)函數(shù)。每個(gè)全景的 ID 是唯一的，在某個(gè)會(huì)話的生命期內(nèi)是穩(wěn)定的，但是很有可能在不同會(huì)話之間會(huì)改變。 （自 2.104 開(kāi)始）

枚舉 GStreetviewClient.ReturnValues

在圓括號(hào)中指定每個(gè)符號(hào)常數(shù)對(duì)應(yīng)的數(shù)值。

常數(shù)

常數(shù)說(shuō)明

SUCCESS = 200	成功 （自 2.104 開(kāi)始）
SERVER_ERROR = 500	服務(wù)器沒(méi)有響應(yīng)查詢。 （自 2.104 開(kāi)始）
NO_NEARBY_PANO = 600	沒(méi)有找到全景數(shù)據(jù)。 （自 2.104 開(kāi)始）

GStreetviewData 類

此類表示與全景相關(guān)的數(shù)據(jù)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

location	GStreetviewLocation	位置數(shù)據(jù)。 （自 2.104 開(kāi)始）
copyright	String	本地化的版權(quán)歸屬。 （自 2.104 開(kāi)始）
links	GStreetviewLink[]	到相鄰全景的鏈接（如果有）。 （自 2.104 開(kāi)始）
code	GStreetviewClient.ReturnValues	狀態(tài)代碼。請(qǐng)參見(jiàn) GStreetviewClient.ReturnValues. （自 2.104 開(kāi)始）

GStreetviewLocation 類

此類表示一個(gè)街道視圖位置。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

latlng	GLatLng	全景的 latlng。 （自 2.104 開(kāi)始）
pov	GPov	初始視點(diǎn)。 （自 2.104 開(kāi)始）
description	String	描述該位置的本地化字符串。 （自 2.104 開(kāi)始）
panoId	String	全景的唯一標(biāo)識(shí)符。該標(biāo)識(shí)符在某個(gè)會(huì)話內(nèi)是穩(wěn)定的，但是在會(huì)話之間不穩(wěn)定。 （自 2.104 開(kāi)始）

GStreetviewLink 類

此類表示從一個(gè) GStreetviewLocation 到相鄰GStreetviewLocation 的鏈接。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。

屬性

屬性類型說(shuō)明

yaw	Number	從當(dāng)前位置到相鄰位置的偏角。 （自 2.104 開(kāi)始）
description	String	描述相鄰位置的本地化字符串。 （自 2.104 開(kāi)始）
panoId	String	相鄰全景的唯一標(biāo)識(shí)符。該標(biāo)識(shí)符在某個(gè)會(huì)話內(nèi)是穩(wěn)定的，但是在會(huì)話之間不穩(wěn)定。 （自 2.104 開(kāi)始）

GPov 類

此類表示街道視圖所使用的照相機(jī)視點(diǎn)結(jié)構(gòu)。它沒(méi)有構(gòu)造函數(shù)，但可實(shí)例化為對(duì)象常量。所有屬性都是“可選的”。

屬性

屬性類型說(shuō)明

yaw	Number	相對(duì)于正北方的照相機(jī)偏角。正北方為 0 度，東方為 90 度，南方為 180 度，西方為 270 度。 （自 2.104 開(kāi)始）
pitch	Number	相對(duì)于街道視圖工具的照相機(jī)偏角（度數(shù)）。范圍從90 度（垂直向上）到 -90 度（垂直向下）。 （自 2.104 開(kāi)始）
zoom	Number	縮放級(jí)別。完全縮小為 0 級(jí)別，放大會(huì)增大級(jí)別。 （自 2.104 開(kāi)始）

枚舉 GStreetviewPanorama.ErrorValues

在圓括號(hào)中指定每個(gè)符號(hào)常數(shù)對(duì)應(yīng)的數(shù)值。

常數(shù)

常數(shù)說(shuō)明

NO_NEARBY_PANO = 600	沒(méi)有找到全景數(shù)據(jù)。 （自 2.104 開(kāi)始）
FLASH_UNAVAILABLE = 603	flash 查看器不可用，通常是因?yàn)橛脩舻臑g覽器不支持 flash。 （自 2.104 開(kāi)始）

楊航收集技術(shù)資料，分享給大家



總結(jié)

以上是生活随笔為你收集整理的Google 地图 API 参考的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。