谷歌地圖參考手冊

Map() 構造函數

創建谷歌地圖:

var map = new google.maps.Map(mapCanvas, mapOptions);

定義和用法

Map() 構造函數在指定的 HTML 元素(通常是 <div> 元素)內創建一個新地圖。

語法

new google.maps.Map(HTMLElement,MapOptions)

參數值

參數 描述
HTMLElement 規定將地圖放置在哪個 HTML 元素中。
MapOptions 保存地圖初始化變量/選項的 MapOptions 對象。

Map() 的方法

方法 返回值 描述
fitBounds(LatLngBounds) None 設置視口以包含給定的邊界。
getBounds() LatLng,LatLng 返回當前視口的西南緯度/經度和東北緯度/經度。
getCenter() LatLng 返回地圖中心的緯度/經度。
getDiv() Node 返回包含地圖的 DOM 對象。
getHeading() number

返回航空圖像的羅盤航向。

適用于 SATELLITE 和 HYBRID 地圖類型。

getMapTypeId()
  • HYBRID
  • ROADMAP
  • SATELLITE
  • TERRAIN
返回當前地圖類型。
getProjection() Projection 返回當前投影。
getStreetView() StreetViewPanorama 返回綁定到地圖的默認 StreetViewPanorama。
getTilt() number

返回航空圖像的入射角(以度為單位)。

適用于 SATELLITE 和 HYBRID 地圖類型。

getZoom() number 返回地圖的當前縮放級別。
panBy(xnumber,ynumber) None 以給定距離更改地圖中心(以像素為單位)。
panTo(LatLng) None 將地圖中心更改為給定的 LatLng。
panToBounds(LatLngBounds) None 將地圖平移包含給定 LatLngBounds 所需的最小量。
setCenter(LatLng) None 設置地圖中心的緯度/經度。
setHeading(number) None

設置航拍圖像的羅盤航向。

以從基本方向北測量的度數為單位。

setMapTypeId(MapTypeId) None 設置要顯示的地圖類型。
setOptions(MapOptions) None
setStreetView(StreetViewPanorama) None 將 StreetViewPanorama 綁定到地圖。
setTilt(number) None

設置航空圖像的入射角(以度為單位)。

適用于 SATELLITE 和 HYBRID 地圖類型。

setZoom(number) None 設置地圖的縮放級別。

Map() 的屬性

屬性 類型 描述
controls Array.<MVCArray.<Node>> 追加到地圖的附加控件。
mapTypes MapTypeRegistry 按字符串 ID 的 MapType 實例注冊表。
overlayMapTypes MVCArray.<MapType> 要疊加的其他地圖類型。

Map() 的事件

事件 參數 描述
bounds_changed None 當視口邊界發生變化時觸發。
center_changed None 地圖中心屬性更改時觸發。
click MouseEvent 當用戶點擊地圖時觸發。
dblclick MouseEvent 當用戶雙擊地圖時觸發。
drag None 當用戶拖動地圖時重復觸發。
dragend None 當用戶停止拖動地圖時觸發。
dragstart None 當用戶開始拖動地圖時觸發。
heading_changed None 地圖標題屬性改變時觸發。
idle None 當地圖在平移或縮放后變得空閑時觸發。
maptypeid_changed None 當 mapTypeId 屬性改變時觸發。
mousemove MouseEvent 每當用戶的鼠標移動到地圖容器上時觸發。
mouseout MouseEvent 當用戶鼠標退出地圖容器時觸發。
mouseover MouseEvent 當用戶鼠標進入地圖容器時觸發。
projection_changed None 投影更改時觸發。
resize None 當地圖(div)改變大小時觸發。
rightclick MouseEvent 當用戶右鍵單擊地圖時觸發。
tilesloaded None 當可見圖塊完成加載時觸發。
tilt_changed None 當地圖傾斜屬性改變時觸發。
zoom_changed None 當地圖縮放屬性更改時觸發。

疊加層

構造器/對象 描述
Marker 創建標記。(注意必須設置好標記的顯示位置)
MarkerOptions 供渲染標記的選項。
MarkerImage 表示標記圖標或陰影圖像的結構。
MarkerShape 定義用于確定標記的可點擊區域(類型和坐標)的標記形狀。
Animation 規定可以在標記上播放的動畫(彈起或下落)。
InfoWindow 創建信息窗口。
InfoWindowOptions 用于渲染信息窗口的選項。
Polyline 創建多段線(包含路徑和筆觸樣式)。
PolylineOptions 用于渲染折線的選項。
Polygon 創建多邊形(包含路徑和筆觸+填充樣式)。
PolygonOptions 用于渲染多邊形的選項。
Rectangle 創建矩形(包含邊界和筆觸+填充樣式)。
RectangleOptions 渲染矩形的選項。
Circle 創建圓(包含中心+半徑和筆觸+填充樣式)。
CircleOptions 用于渲染圓的選項。
GroundOverlay
GroundOverlayOptions
OverlayView
MapPanes
MapCanvasProjection

事件

構造器/對象 描述
MapsEventListener

它沒有方法,也沒有構造函數。

它的實例從addListener()、addDomListener()返回,并最終傳回removeListener()

event 添加/刪除/觸發事件監聽器。
MouseEvent 從地圖和疊加層上的各種鼠標事件返回。

控件

控件/對象 描述
MapTypeControlOptions 保存用于修改控件的選項(位置和樣式)。
MapTypeControlStyle 規定要顯示的地圖控件類型(下拉菜單或按鈕)。
OverviewMapControlOptions 用于渲染概覽地圖控件的選項(展開或折疊)。
PanControlOptions 用于渲染平移控件的選項(位置)。
RotateControlOptions 用于渲染旋轉控件的選項(位置)。
ScaleControlOptions 用于渲染比例控件的選項(位置和樣式)。
ScaleControlStyle 規定要顯示哪種比例控件。
StreetViewControlOptions 用于渲染街景 pegman 控件的選項(位置)。
ZoomControlOptions 用于渲染縮放控件的選項(位置和樣式)。
ZoomControlStyle 規定要顯示哪種縮放控件(大或小)。
ControlPosition 規定控件在地圖上的位置。