地图 API Map() 构造器
实例
创建一个 Google 地图:
<html> <head> <script src="http://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"> </script> <script> function initialize() { var mapOpt = { center:new google.maps.LatLng(51.508742,-0.120850), zoom:5, mapTypeId:google.maps.MapTypeId.ROADMAP }; var map=new google.maps.Map(document.getElementById("googleMap"),mapOpt); } google.maps.event.addDomListener(window, 'load', initialize); </script> </head> <body> <div></div> </body> </html>
定义和用法
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
返回当前 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
当地图 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(缩放)属性更改时会触发此事件。