谷歌地圖參考手冊
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 | 規定控件在地圖上的位置。 |