# 地图 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（缩放）属性更改时会触发此事件。 |