谷歌地图参考手册
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() |
|
返回当前地图类型。 |
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 | 规定控件在地图上的位置。 |