【正文】 google Maps JavaScript API V3 參考 注意：以下網(wǎng)頁(yè)中提到的 Google Maps JavaScript API 第 3 版現(xiàn)在是正式的 JavaScript API 版本。該 API 的第 2 版已根據(jù)我們的棄用政策正式棄用。歡迎您將代碼移植到這個(gè)功能更強(qiáng)、最近更新的版本中！ 最新版本 最后更新時(shí)間： 2020 年 6 月 8 日，星期三 歡迎使用 JavaScript Maps API V3 參考。此參考將經(jīng)常更新，與 API 的最新更改保持同步。有關(guān)每個(gè)版本的新增功能的信息 ，請(qǐng)參考 JavaScript Maps API V3 更改日志 。 參考目錄 地圖 ： ? Map ? MapOptions ? MapTypeId 控件 ： ? MapTypeControlOptions ? MapTypeControlStyle ? OverviewMapControlOptions ? PanControlOptions ? RotateControlOptions ? ScaleControlOptions ? ScaleControlStyle ? StreetViewControlOptions ? ZoomControlOptions ? ZoomControlStyle ? ControlPosition 疊加層 ： ? Marker ? MarkerOptions ? MarkerImage ? MarkerShape ? Animation ? InfoWindow ? InfoWindowOptions ? Polyline ? PolylineOptions ? Polygon ? PolygonOptions ? Rectangle ? RectangleOptions ? Circle ? CircleOptions ? GroundOverlay ? GroundOverlayOptions ? OverlayView ? MapPanes ? MapCanvasProjection 服務(wù) ： ? Geocoder ? GeocoderRequest ? GeocoderStatus ? GeocoderResult ? GeocoderAddressComponent ? GeocoderGeometry ? GeocoderLocationType ? DirectionsRenderer ? DirectionsRendererOptions ? DirectionsService ? DirectionsRequest ? TravelMode ? UnitSystem ? DirectionsWaypoint ? DirectionsStatus ? DirectionsResult ? DirectionsRoute ? DirectionsLeg ? DirectionsStep ? Distance ? Duration ? ElevationService ? LocationElevationRequest ? PathElevationRequest ? ElevationResult ? ElevationStatus ? MaxZoomService ? MaxZoomResult ? MaxZoomStatus ? DistanceMatrixService ? DistanceMatrixRequest ? DistanceMatrixResponse ? DistanceMatrixResponseRow ? DistanceMatrixResponseElement ? DistanceMatrixStatus ? DistanceMatrixElementStatus 地圖類(lèi)型 ： ? MapType ? MapTypeRegistry ? Projection ? ImageMapType ? ImageMapTypeOptions ? StyledMapType ? StyledMapTypeOptions ? MapTypeStyle ? MapTypeStyleFeatureType ? MapTypeStyleElementType ? MapTypeStyler 圖層 ： ? BicyclingLayer ? FusionTablesLayer ? FusionTablesLayerOptions ? FusionTablesQuery ? FusionTablesStyle ? FusionTablesHeatmap ? FusionTablesMarkerOptions ? FusionTablesPolygonOptions ? FusionTablesPolylineOptions ? FusionTablesMouseEvent ? FusionTablesCell ? KmlLayer ? KmlLayerOptions ? KmlLayerMetadata ? KmlMouseEvent ? KmlFeatureData ? KmlAuthor ? TrafficLayer Street View： ? StreetViewPanorama ? StreetViewPanoramaOptions ? StreetViewAddressControlOptions ? StreetViewLink ? StreetViewPov ? StreetViewPanoramaData ? StreetViewLocation ? StreetViewTileData ? StreetViewService ? StreetViewStatus 事件 ： ? MapsEventListener ? 事件 ? MouseEvent 基本信息 ： ? LatLng ? LatLngBounds ? Point ? Size MVC： ? MVCObject ? MVCArray 幾何圖形庫(kù) ： ? encoding ? spherical AdSense 庫(kù) ： ? AdUnit ? AdUnitOptions ? AdFormat Panoramio 庫(kù) ： ? PanoramioLayer ? PanoramioLayerOptions ? PanoramioFeature ? PanoramioMouseEvent 地方庫(kù) ： ? Autoplete ? AutopleteOptions ? PlaceDetailsRequest ? PlaceGeometry ? PlaceResult ? PlaceSearchRequest ? PlacesService ? PlacesServiceStatus 類(lèi) 此類(lèi)擴(kuò)展了 MVCObject。 構(gòu)造函數(shù) 構(gòu)造函數(shù) 說(shuō)明 Map(mapDiv:Node, opts?:MapOptions) 在指定的 HTML 容器中創(chuàng)建新的地圖，該容器通常是一個(gè) DIV元素。 方法 方法 返回值 說(shuō)明 fitBounds(bounds:LatLngBounds) None 用于設(shè)置視口，使其包含指定邊界。 getBounds() LatLngBounds 用于返回當(dāng)前視口的緯度 /經(jīng)度范圍。如果尚未啟動(dòng)地圖（即 mapType 仍為 Null），或尚未設(shè)置中心和縮放，則結(jié)果為 null或undefined。 getCenter() LatLng getDiv() Node getHeading() number 用于返回航拍圖像的羅盤(pán)方向。方向值按順時(shí)針?lè)较蛴?jì)算（以度為單位），基本方向?yàn)楸狈健? getMapTypeId() MapTypeId getProjection() Projection 傳回當(dāng)前的Projection。如果還未啟動(dòng)地圖（即 mapType 仍為 Null），則結(jié)果為 Null。偵聽(tīng)projection_changed并檢查它的值以確保它的值不為 Null。 getStreetView() StreetViewPanorama 將默認(rèn)StreetViewPanorama范圍傳回到地圖，該范圍可能是嵌入在地圖中的默認(rèn)全景圖，也可能是使用setStreetView()設(shè)置的全景圖。對(duì)地圖的streetViewControl所做的更改將反映在此類(lèi)范圍全景圖的顯示中。 getTilt() number 用于返回從視口平面到地圖平面的航拍圖像（支持SATELLITE和 HYBRID地圖類(lèi)型）的入射角，以度為單位進(jìn)行測(cè)量。值 0表明沒(méi)有入射角（沒(méi)有傾斜），而 45176。 圖像將會(huì)返回值 45。 getZoom() number panBy(x:number, y:number) None 將地圖中心移動(dòng)一段指定的距離（以像素為單位）。如果這段距離既小于地圖的寬度，又小于地圖的高度，那么移動(dòng)的動(dòng)畫(huà)效果將會(huì)十分流暢。請(qǐng)注意，地圖坐標(biāo)系的 x 值從西向東增加， y 值從北向南增加。 panTo(latLng:LatLng) None 將地圖中心更改為指定的LatLng。如果更改幅度既小于地圖的寬度，又小于地圖的高度，那么移動(dòng)的動(dòng)畫(huà)效果將會(huì)十分流暢。 panToBounds(latLngBounds:LatLngBounds) None 將地圖平移所需的最小距離以包含指定的LatLngBounds。范圍在地圖上的位置并不確定，除了盡可能多地顯示范圍。范圍將定位于由地圖類(lèi)型和導(dǎo)航（平移、縮放和 Street View）控件所限定的區(qū)域內(nèi)（如果這些控件出現(xiàn)在地圖上的話(huà)）。如果范圍大于地圖，則地圖會(huì)移動(dòng)，以便包括范圍的西北角。如果地圖位置的移動(dòng)幅度既小于地圖的寬度，又小于地圖的高度，那么移動(dòng)的動(dòng)畫(huà)效果將會(huì)十分流暢。 setCenter(latlng:LatLng) None setHeading(heading:number) None 用于設(shè)置航拍圖像的羅盤(pán)方向（以度為單位進(jìn)行測(cè)量），基本方向?yàn)楸狈健? setMapTypeId(mapTypeId:MapTypeId) None setOptions(options:MapOptions) None setStreetView(panorama:StreetViewPanorama) None 將StreetViewPanorama綁定到地圖。此全景圖將覆蓋默認(rèn)StreetViewPanorama，從而使地圖可以綁定到地圖外的外部全景圖。將全景圖設(shè)置為 null可將默認(rèn)的嵌入式全景圖綁定回到地圖。 setTilt(tilt:number) None 用于設(shè)置從視口平面到地圖平面的航拍圖像（支持SATELLITE和 HYBRID地圖類(lèi)型）的入射角，以度為單位進(jìn)行測(cè)量。僅支持兩個(gè)值： 0（表明沒(méi)有入射角，即沒(méi)有傾斜）和 45（表明有 45176。 傾斜）。 setZoom(zoom:number) None 屬性 屬性 類(lèi)型 說(shuō)明 controls Array.MVCArray.Node 附加到地圖的其他控件。要在地圖中添加控件，請(qǐng)將控件的 div添加到與應(yīng)渲染它的ControlPosition相對(duì)應(yīng)的 MVCArray中。 mapTypes MapTypeRegistry 按字符串 ID 劃分的 MapType實(shí)例的注冊(cè)表。 overlayMapTypes MVCArray.MapType 要疊加的其他地圖類(lèi)型。 事件 事件 參數(shù) 說(shuō)明 bounds_changed None 當(dāng)可視區(qū)域范圍更改時(shí)會(huì)觸發(fā)此事件。 center_changed None 當(dāng)?shù)貓D中心屬性更改時(shí)會(huì)觸發(fā)此事件。 click MouseEvent 當(dāng)用戶(hù)點(diǎn)擊地圖（但不是點(diǎn)擊標(biāo)記或信息窗口）時(shí)會(huì)觸發(fā)此事件。 dblclick MouseEvent 當(dāng)用戶(hù)雙擊地圖時(shí)會(huì) 觸發(fā)此事件。請(qǐng)注意，觸發(fā)此事件前還會(huì)觸發(fā)點(diǎn)擊事件。 drag None 當(dāng)用戶(hù)拖動(dòng)地圖時(shí)會(huì)反復(fù)觸發(fā)此事件。 dragend None 當(dāng)用戶(hù)停止拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。 dragstart None 當(dāng)用戶(hù)開(kāi)始拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。 heading_changed None 當(dāng)?shù)貓D方向?qū)傩愿臅r(shí)會(huì)觸發(fā)此事件。 idle None 如果地圖在平移或縮放之后變?yōu)殚e置狀態(tài)，則會(huì)觸發(fā)此事件。 maptypeid_changed None 當(dāng) mapTypeId 屬性更改時(shí)會(huì)觸發(fā)此事件。 mousemove MouseEvent 只要用戶(hù)的鼠標(biāo)在地圖容器上移動(dòng)，就會(huì)觸發(fā)此事件。 mouseout MouseEvent 當(dāng)用戶(hù)的鼠標(biāo)從地圖容器上退出時(shí)會(huì)觸發(fā)此事件。