【導(dǎo)讀】歡迎您將代碼移植到這個(gè)功能更強(qiáng)、最近更新的。此參考將經(jīng)常更新，與API的最新更改保持同步。

　　

【正文】 顯示此 OverlayView 的窗格。僅在調(diào)用 draw 函數(shù)后才可用。 getProjection() MapCanvasProjection 用于返回與該 OverlayView相關(guān)聯(lián)的MapCanvasProjection對(duì)象。僅在調(diào)用 draw 函數(shù)后才可用。 onAdd() None 實(shí)現(xiàn)此方法可初始化疊加層 DOM 元素。對(duì)有效地圖調(diào)用 setMap() 之后，調(diào)用該方法一次。此時(shí)將會(huì)初始化窗格和投影。 onRemove() None 實(shí)現(xiàn)此方法可將您的元素從 DOM 刪除。調(diào)用 setMap(null) 之后立即調(diào)用此方法。 setMap(map:Map|StreetViewPanorama) None 將疊加層添加到地圖或全景圖。 對(duì)象規(guī)范 此對(duì)象包含渲染疊加層的 DOM 元素。下面 列出了這些元素，底部為 “窗格 0”，頂部為 “窗格 6”。 屬性 屬性 類型 說(shuō)明 floatPane Node 此窗格包含信息窗口。它位于所有地圖疊加層之上。（窗格 6）。 floatShadow Node 此窗格包含信息窗口陰影。該窗格在 overlayImage 之上，這樣標(biāo)記便可位于信息窗口的陰影中。（窗格 4）。 mapPane Node 此窗格是最下面的窗格，位于圖塊之上。可能無(wú)法接收 DOM 事件（窗格 0）。 overlayImage Node 此窗格包含標(biāo)記前景圖像。（窗格 3）。 overlayLayer Node 此窗格包含折線、多邊形、地面疊加層和圖塊圖層疊加層。可能無(wú)法 接收 DOM 事件（窗格 1）。 overlayMouseTarget Node 此窗格包含可接收 DOM 鼠標(biāo)事件的元素，例如標(biāo)記的透明目標(biāo)。該窗格在 floatShadow 之上，這樣便可點(diǎn)擊信息窗口陰影中的標(biāo)記。（窗格 5）。 overlayShadow Node 此窗格包含標(biāo)記陰影。可能無(wú)法接收 DOM 事件（窗格 2）。 對(duì)象規(guī)范 此對(duì)象會(huì)從繪制方法內(nèi)向 OverlayView提供。在調(diào)用繪制之前，系統(tǒng)無(wú)法保證對(duì)其進(jìn)行初始化。 方法 方法 返回值 說(shuō)明 fromContainerPixelToLatLng(pixel:Point) LatLng 根據(jù)地圖容器中的像素坐標(biāo)計(jì)算地理坐標(biāo)。 fromDivPixelToLatLng(pixel:Point) LatLng 根據(jù)存放可拖動(dòng)地圖的 div 中的像素坐標(biāo)計(jì)算地理坐標(biāo)。 fromLatLngToContainerPixel(latLng:LatLng) Point 計(jì)算地圖外部容器的 DOM 元素中指定地理位置的像素坐標(biāo)。 fromLatLngToDivPixel(latLng:LatLng) Point 計(jì)算存放可拖動(dòng)地圖的 DOM 元素中指定地理位置的像素坐標(biāo)。 getWorldWidth() number 當(dāng)前縮放級(jí)別下世界地圖的寬度（以像素為單位）。 類 用于在地址和 LatLng之間進(jìn)行轉(zhuǎn)換的服務(wù)。 構(gòu)造函數(shù) 構(gòu)造函數(shù) 說(shuō)明 Geocoder() 創(chuàng)建可將地址解析請(qǐng)求發(fā)送到 Google 服務(wù)器的新 Geocoder實(shí)例。 方法 方 法 返回值 說(shuō)明 geocode(request:GeocoderRequest, callback:function(Array.GeocoderResult, GeocoderStatus)) None 對(duì)請(qǐng)求內(nèi)容進(jìn)行地址解析。 對(duì)象規(guī)范 要發(fā)送到 Geocoder的地址解析請(qǐng)求的規(guī)范。 屬性 屬性 類型 說(shuō)明 address string 地址?？蛇x。 bounds LatLngBounds 要在其中進(jìn)行搜 索的 LatLngBounds。可選。 location LatLng 要搜索的 LatLng?？蛇x。 region string 要在其中進(jìn)行搜索的國(guó)家 /地區(qū)代碼的頂級(jí)域名?？蛇x。 類 完成對(duì) geocode()的調(diào)用時(shí)由 Geocoder傳回的狀態(tài)。 常數(shù) 常 數(shù) 說(shuō)明 ERROR 連接 Google 服務(wù)器時(shí)出錯(cuò)。 INVALID_REQUEST GeocoderRequest無(wú)效。 OK 響應(yīng)包含有效的 GeocoderResponse。 OVER_QUERY_LIMIT 網(wǎng)頁(yè)發(fā)出請(qǐng)求的頻率過(guò)高，超過(guò)了最短時(shí)間限制。 REQUEST_DENIED 不允許網(wǎng)頁(yè)使用地址解析器。 UNKNOWN_ERROR 由于服務(wù)器錯(cuò)誤而無(wú)法處理地址解析請(qǐng)求。如果您再試一次，該請(qǐng)求可能會(huì) 成功。 ZERO_RESULTS 未找到此 GeocoderRequest的結(jié)果。 對(duì)象規(guī)范 從地址解析服務(wù)器檢索獲得的單個(gè)地址解析器結(jié)果。一個(gè)地址解析請(qǐng)求可能會(huì)返回多個(gè)結(jié)果對(duì)象。請(qǐng)注意，盡管該結(jié)果為 “類 JSON”，但它并非嚴(yán)格意義上的 JSON，因?yàn)樵摻Y(jié)果間接包含了 LatLng對(duì)象。 屬性 屬性 類型 說(shuō)明 address_ponents Array.GeocoderAddressComponent 一個(gè)GeocoderAddressComponent數(shù)組 geometry GeocoderGeometry 一個(gè) GeocoderGeometry對(duì)象 types Array.string 一個(gè)字符串?dāng)?shù)組，這些字符串表示傳回的地址解析元素的類型。一種類型，由標(biāo)識(shí)地址解析結(jié)果的唯一字符串組成。（例如，“administrative_area_level_1”、“country”等等。） 對(duì)象規(guī)范 GeocoderResult中的一個(gè)地址組件。一個(gè)完整地址可能由多個(gè)地址組件組成。 屬性 屬性 類型 說(shuō)明 long_name string 地址組件的完整文本 short_name string 指定地址組件的簡(jiǎn)短縮寫文本 types Array.string 一個(gè)字符串?dāng)?shù)組，這些字符串指示此地址組件的類型 對(duì)象規(guī)范 有關(guān)此 GeocoderResult的幾何信息 屬性 屬性 類型 說(shuō)明 bounds LatLngBounds 此 GeocodeResult的精確范圍（如果有） location LatLng 此結(jié)果的緯度 /經(jīng)度坐標(biāo) location_type GeocoderLocationType 在 location中傳回的位置類型 viewport LatLngBounds 用于顯示此 GeocodeResult的建議可視區(qū)域的范圍 類 描述地址解析返回的位置類型。 常數(shù) 常數(shù) 說(shuō)明 APPROXIMATE 傳回的結(jié)果是近似值。 GEOMETRIC_CENTER 傳回的結(jié)果是線（例如街道）或多邊形（區(qū)域）等結(jié)果的幾何中心。 RANGE_INTERPOLATED 返回的結(jié)果反映了通過(guò)插值取得的近似地址（通常在某條道路上），該地址處于兩個(gè)精確點(diǎn)（如十字路口）之 間。當(dāng)無(wú)法對(duì)街道地址進(jìn)行公開的地址解析時(shí)，通常會(huì)返回插值結(jié)果。 ROOFTOP 傳回的結(jié)果反映了精確的地址解析。 類 以從 DirectionsService檢索的 DirectionsResult對(duì)象的形式渲染檢索的路線。此類擴(kuò)展了 MVCObject。 構(gòu)造函數(shù) 構(gòu)造函數(shù) 說(shuō)明 DirectionsRenderer(opts?:DirectionsRendererOptions) 使用指定選項(xiàng)創(chuàng)建渲染程序。路線可以渲染在地圖（作為可視疊加層）上，也可以渲染在 div面板（作為文本說(shuō)明）上。 方法 方法 返回值 說(shuō)明 getDirections() DirectionsResult 傳回渲染程序的當(dāng)前路線集。 getMap() Map 傳回在其上渲染DirectionsResult的地圖。 getPanel() Node 傳回在其中渲染DirectionsResult的面板 div。 getRouteIndex() number 傳回此DirectionsRenderer對(duì)象使用的當(dāng)前（基于零的）路線索引。 setDirections(directions:DirectionsResult) None 將渲染程序設(shè)置為使用DirectionsService中的結(jié)果。以這種方式設(shè)置一組有效的路線將在渲染程序的指定地圖和面板上顯示這些路線。 setMap(map:Map) None 此方法指定將在其上渲染路線的地圖。傳遞null可從地圖中刪除路線。 setOptions(options:DirectionsRendererOptions) None 在初始化后更改此DirectionsRenderer的選項(xiàng)設(shè)置。 setPanel(panel:Node) None 此方法在 div中渲染路線。傳遞 null可從面板中刪除內(nèi)容。 setRouteIndex(routeIndex:number) None 在DirectionsResult對(duì)象中設(shè)置要渲染的路線的（基于零的）索引。默認(rèn)情況下，將渲染數(shù)組中的第一條路線。 事件 事件 參數(shù) 說(shuō)明 directions_changed None 當(dāng)呈現(xiàn)的路線發(fā)生更改（在設(shè)置了新的 DirectionsResult或用戶將更改內(nèi)容拖到路線路徑上時(shí)）時(shí)會(huì)觸發(fā)此事件。 對(duì)象規(guī)范 此對(duì)象定義可在 DirectionsRenderer 對(duì)象上設(shè)置的屬性。 屬性 屬性 類型 說(shuō)明 directions DirectionsResult 要在地圖上和 /或 div面板中顯示的路線，作為 DirectionsResult對(duì)象從DirectionsService中檢索。 draggable boolean 如果為 true，則允許用戶拖動(dòng)并修改此DirectionsRenderer所呈現(xiàn)的路線路徑。 hideRouteList boolean 此屬性指示渲染程序是否應(yīng)提供用戶界面以在備選路線中進(jìn)行選擇。默認(rèn)情況下，此標(biāo)記為 false，并且用戶可選擇的路線列表將顯示在路線的關(guān)聯(lián)面板中。要隱藏該列表，請(qǐng)將hideRouteList設(shè)置為 true。 infoWindow InfoWindow InfoWindow，當(dāng)用戶點(diǎn)擊標(biāo)記時(shí)，系統(tǒng)會(huì)在其中呈現(xiàn)文本信息。現(xiàn)有的信息窗口內(nèi)容將會(huì)被覆蓋，其位置也會(huì)移動(dòng)。如果未指定信息窗口，則 DirectionsRenderer 會(huì)創(chuàng)建并使用自己的信息窗口。如果將suppressInfoWindows設(shè)置為 true，則系統(tǒng)將會(huì)忽略該屬性。 map Map 要在其上顯 示路線的地圖。 markerOptions MarkerOptions 標(biāo)記的選項(xiàng)。由 DirectionsRenderer 渲染的所有標(biāo)記都將使用這些選項(xiàng)。 panel Node 要在其中顯示路線路段的 div。 polylineOptions PolylineOptions 折線的選項(xiàng)。由 DirectionsRenderer 渲染的所有折線都將使用這些選項(xiàng)。 preserveViewport boolean 默認(rèn)情況下，輸入地圖會(huì)居中并縮放以適應(yīng)此組路線的邊框。如果此選項(xiàng)設(shè)置為 true，則可視區(qū)域?qū)⒈３植蛔?，但如果從未設(shè)置地圖的中心和縮放則例外。 routeIndex number DirectionsResult對(duì)象中路線的索引。默認(rèn)值為 0。 suppressBicyclingLayer boolean 當(dāng)請(qǐng)求騎車路線時(shí)，取消 BicyclingLayer的渲染。 suppressInfoWindows boolean 取消信息窗口的渲染。 suppressMarkers boolean 取消標(biāo)記的渲染。 suppressPolylines boolean 取消折線的渲染。 類 用于計(jì)算兩個(gè)或多個(gè)位置之間路線的服務(wù)。 構(gòu)造函數(shù) 構(gòu)造函數(shù) 說(shuō)明 DirectionsService() 創(chuàng)建可將路線查詢發(fā)送到 Google 服務(wù)器的新 DirectionsService實(shí)例。 方法 方法 返回值 說(shuō)明 route(request:DirectionsRequest, callback:function(DirectionsResult, DirectionsStatus)) None 發(fā)出路線搜索請(qǐng)求。 對(duì)象規(guī)范 將發(fā)送到 DirectionsService的路線查詢。 屬性 屬性 類型 說(shuō)明 avoidHighways boolean 如果為 true，則指示路線服務(wù)盡可能避開高速公路?？蛇x。 avoidTolls boolean 如果為 true，則指示路線服務(wù)盡可能避開收費(fèi)公路。可選。 destination LatLng|string 目標(biāo)位置?？蓪⒋隧?xiàng)指定為要進(jìn)行地址解析的字符串或 LatLng。必填。 optimizeWaypoints boolean 如果設(shè)置為 true，