# 地圖 API Map() 構造器 ## 實例 創建一個 Google 地圖: ``` var map=new google.maps.Map(document.getElementById("googleMap"),mapOpt); ``` ## 定義和用法 Map() 構造器創建了一個新的地圖并插入到指定的HTML元素中（&lt;div&gt; 元素)。 ## 語法 ``` new google.maps.Map(_HTMLElement_,_MapOptions_) ``` ## 參數值 | 參數 | 描述 | | --- | -- | | _HTMLElement_ | 規定要把地圖放置在那個 HTML 元素中。 | | _[MapOptions](ref-mapoptions.html)_ | 帶有地圖初始化變量/選項的 MapOptions 對象。 | ## Map() 的方法 | 方法 | 返回值 | 描述 | | --- | --- | --- | | fitBounds(_LatLngBounds_) | None | 設置要包含給定邊界的視口。 | | [getBounds()](ref-getbounds.html) | _LatLng,LatLng_ | 返回當前視口的西南緯度/經度和東北緯度/經度。 | | [getCenter()](ref-getcenter.html) | _LatLng_ | 返回地圖的中心的緯度/經度。 | | [getDiv()](ref-getdiv.html) | _Node_ | 返回包含地圖的 DOM 對象。 | | [getHeading()](ref-getheading.html) | _number_ | 返回航拍圖像的羅盤航向（支持 SATELLITE 和 HYBRID 地圖類型）。 | | [getMapTypeId()](ref-getmaptypeid.html) | HYBRID ROADMAP SATELLITE TERRAIN | 返回當前地圖類型。 | | getProjection() | _Projection_ | 返回當前 Projection（投影）。 | | getStreetView() | _StreetViewPanorama_ | 返回綁定到地圖的默認的 StreetViewPanorama。 | | getTilt() | _number_ | 返回航拍圖像的入射角度數（支持 SATELLITE 和 HYBRID 地圖類型）。 | | [getZoom()](ref-getzoom.html) | _number_ | 返回地圖的當前縮放級別。 | | panBy(_xnumber,ynumber_) | None | 通過以像素計的給定距離改變地圖的中心。 | | panTo(_LatLng_) | None | 改變地圖的中心為給定的 LatLng。 | | panToBounds(_LatLngBounds_) | None | 將地圖平移所需的最小距離以包含給定的 LatLngBounds。 | | setCenter(_LatLng_) | None | | setHeading(_number_) | None | 設置航拍圖像的羅盤方向（以度為單位進行測量），基本方向為北方。 | | [setMapTypeId(_MapTypeId_)](ref-setmaptypeid.html) | 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 | 當地圖 center（中心）屬性更改時會觸發此事件。 | | click | _MouseEvent_ | 當用戶點擊地圖（但不是點擊標記或信息窗口）時會觸發此事件。 | | dblclick | _MouseEvent_ | 當用戶雙擊地圖時會觸發此事件。請注意，觸發此事件前還會觸發點擊事件。 | | drag | None | 當用戶拖動地圖時會反復觸發此事件。 | | dragend | None | 當用戶停止拖動地圖時會觸發此事件。 | | dragstart | None | 當用戶開始拖動地圖時會觸發此事件。 | | heading_changed | None | 當地圖 heading（方向）屬性更改時會觸發此事件。 | | 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 | 當地圖 tilt（傾斜）屬性更改時會觸發此事件。 | | zoom_changed | None | 當地圖 zoom（縮放）屬性更改時會觸發此事件。 |