谷歌地图参考手册

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 规定控件在地图上的位置。