Google 地图参考手册

Map() 构造函数

实例

创建谷歌地图:

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

定义和用法

Map() 构造函数在指定的 HTML 元素(通常是 div 元素)内创建一个新地图。


语法

new google.maps.Map(HTMLElement,MapOptions)

参数值

参数 描述
HTMLElement 指定放置地图的 HTML 元素
MapOptions 保存地图初始化变量/选项的 MapOptions 对象

Map() 方法

方法 Return Value 描述
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() 事件

事件 Arguments 描述
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 用于渲染街景街景小人控件(位置)的选项
ZoomControlOptions 用于渲染缩放控件的选项(位置和样式)
ZoomControlStyle 指定要显示的缩放控件类型(大或小)
ControlPosition 指定控件在地图上的位置