《googleMapsAPIV3-中文參考手冊.doc》由會(huì)員分享,可在線閱讀,更多相關(guān)《googleMapsAPIV3-中文參考手冊.doc(57頁珍藏版)》請?jiān)谘b配圖網(wǎng)上搜索。
google Maps JavaScript API V3 參考
注意:以下網(wǎng)頁中提到的 Google Maps JavaScript API 第 3 版現(xiàn)在是正式的 JavaScript API 版本。該 API 的第 2 版已根據(jù)我們的棄用政策正式棄用。歡迎您將代碼移植到這個(gè)功能更強(qiáng)、最近更新的版本中!
最新版本
最后更新時(shí)間:2011 年 6 月 8 日,星期三
歡迎使用 JavaScript Maps API V3 參考。此參考將經(jīng)常更新,與 API 的最新更改保持同步。有關(guān)每個(gè)版本的新增功能的信息,請參考JavaScript Maps API V3 更改日志。
參考目錄
地圖:
Map
MapOptions
MapTypeId
控件:
MapTypeControlOptions
MapTypeControlStyle
OverviewMapControlOptions
PanControlOptions
RotateControlOptions
ScaleControlOptions
ScaleControlStyle
StreetViewControlOptions
ZoomControlOptions
ZoomControlStyle
ControlPosition
疊加層:
Marker
MarkerOptions
MarkerImage
MarkerShape
Animation
InfoWindow
InfoWindowOptions
Polyline
PolylineOptions
Polygon
PolygonOptions
Rectangle
RectangleOptions
Circle
CircleOptions
GroundOverlay
GroundOverlayOptions
OverlayView
MapPanes
MapCanvasProjection
服務(wù):
Geocoder
GeocoderRequest
GeocoderStatus
GeocoderResult
GeocoderAddressComponent
GeocoderGeometry
GeocoderLocationType
DirectionsRenderer
DirectionsRendererOptions
DirectionsService
DirectionsRequest
TravelMode
UnitSystem
DirectionsWaypoint
DirectionsStatus
DirectionsResult
DirectionsRoute
DirectionsLeg
DirectionsStep
Distance
Duration
ElevationService
LocationElevationRequest
PathElevationRequest
ElevationResult
ElevationStatus
MaxZoomService
MaxZoomResult
MaxZoomStatus
DistanceMatrixService
DistanceMatrixRequest
DistanceMatrixResponse
DistanceMatrixResponseRow
DistanceMatrixResponseElement
DistanceMatrixStatus
DistanceMatrixElementStatus
地圖類型:
MapType
MapTypeRegistry
Projection
ImageMapType
ImageMapTypeOptions
StyledMapType
StyledMapTypeOptions
MapTypeStyle
MapTypeStyleFeatureType
MapTypeStyleElementType
MapTypeStyler
圖層:
BicyclingLayer
FusionTablesLayer
FusionTablesLayerOptions
FusionTablesQuery
FusionTablesStyle
FusionTablesHeatmap
FusionTablesMarkerOptions
FusionTablesPolygonOptions
FusionTablesPolylineOptions
FusionTablesMouseEvent
FusionTablesCell
KmlLayer
KmlLayerOptions
KmlLayerMetadata
KmlMouseEvent
KmlFeatureData
KmlAuthor
TrafficLayer
Street View:
StreetViewPanorama
StreetViewPanoramaOptions
StreetViewAddressControlOptions
StreetViewLink
StreetViewPov
StreetViewPanoramaData
StreetViewLocation
StreetViewTileData
StreetViewService
StreetViewStatus
事件:
MapsEventListener
事件
MouseEvent
基本信息:
LatLng
LatLngBounds
Point
Size
MVC:
MVCObject
MVCArray
幾何圖形庫:
encoding
spherical
AdSense 庫:
AdUnit
AdUnitOptions
AdFormat
Panoramio 庫:
PanoramioLayer
PanoramioLayerOptions
PanoramioFeature
PanoramioMouseEvent
地方庫:
Autocomplete
AutocompleteOptions
PlaceDetailsRequest
PlaceGeometry
PlaceResult
PlaceSearchRequest
PlacesService
PlacesServiceStatus
google.maps.Map 類
此類擴(kuò)展了MVCObject。
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
Map(mapDiv:Node, opts?:MapOptions)
在指定的 HTML 容器中創(chuàng)建新的地圖,該容器通常是一個(gè)DIV元素。
方法
方法
返回值
說明
fitBounds(bounds:LatLngBounds)
None
用于設(shè)置視口,使其包含指定邊界。
getBounds()
LatLngBounds
用于返回當(dāng)前視口的緯度/經(jīng)度范圍。如果尚未啟動(dòng)地圖(即 mapType 仍為 Null),或尚未設(shè)置中心和縮放,則結(jié)果為null或undefined。
getCenter()
LatLng
getDiv()
Node
getHeading()
number
用于返回航拍圖像的羅盤方向。方向值按順時(shí)針方向計(jì)算(以度為單位),基本方向?yàn)楸狈健?
getMapTypeId()
MapTypeId
getProjection()
Projection
傳回當(dāng)前的Projection。如果還未啟動(dòng)地圖(即 mapType 仍為 Null),則結(jié)果為 Null。偵聽projection_changed并檢查它的值以確保它的值不為 Null。
getStreetView()
StreetViewPanorama
將默認(rèn)StreetViewPanorama范圍傳回到地圖,該范圍可能是嵌入在地圖中的默認(rèn)全景圖,也可能是使用setStreetView()設(shè)置的全景圖。對地圖的streetViewControl所做的更改將反映在此類范圍全景圖的顯示中。
getTilt()
number
用于返回從視口平面到地圖平面的航拍圖像(支持SATELLITE和HYBRID地圖類型)的入射角,以度為單位進(jìn)行測量。值0表明沒有入射角(沒有傾斜),而 45 圖像將會(huì)返回值45。
getZoom()
number
panBy(x:number, y:number)
None
將地圖中心移動(dòng)一段指定的距離(以像素為單位)。如果這段距離既小于地圖的寬度,又小于地圖的高度,那么移動(dòng)的動(dòng)畫效果將會(huì)十分流暢。請注意,地圖坐標(biāo)系的 x 值從西向東增加,y 值從北向南增加。
panTo(latLng:LatLng)
None
將地圖中心更改為指定的LatLng。如果更改幅度既小于地圖的寬度,又小于地圖的高度,那么移動(dòng)的動(dòng)畫效果將會(huì)十分流暢。
panToBounds(latLngBounds:LatLngBounds)
None
將地圖平移所需的最小距離以包含指定的LatLngBounds。范圍在地圖上的位置并不確定,除了盡可能多地顯示范圍。范圍將定位于由地圖類型和導(dǎo)航(平移、縮放和 Street View)控件所限定的區(qū)域內(nèi)(如果這些控件出現(xiàn)在地圖上的話)。如果范圍大于地圖,則地圖會(huì)移動(dòng),以便包括范圍的西北角。如果地圖位置的移動(dòng)幅度既小于地圖的寬度,又小于地圖的高度,那么移動(dòng)的動(dòng)畫效果將會(huì)十分流暢。
setCenter(latlng:LatLng)
None
setHeading(heading:number)
None
用于設(shè)置航拍圖像的羅盤方向(以度為單位進(jìn)行測量),基本方向?yàn)楸狈健?
setMapTypeId(mapTypeId:MapTypeId)
None
setOptions(options:MapOptions)
None
setStreetView(panorama:StreetViewPanorama)
None
將StreetViewPanorama綁定到地圖。此全景圖將覆蓋默認(rèn)StreetViewPanorama,從而使地圖可以綁定到地圖外的外部全景圖。將全景圖設(shè)置為null可將默認(rèn)的嵌入式全景圖綁定回到地圖。
setTilt(tilt:number)
None
用于設(shè)置從視口平面到地圖平面的航拍圖像(支持SATELLITE和HYBRID地圖類型)的入射角,以度為單位進(jìn)行測量。僅支持兩個(gè)值:0(表明沒有入射角,即沒有傾斜)和45(表明有 45 傾斜)。
setZoom(zoom:number)
None
屬性
屬性
類型
說明
controls
Array.
>
附加到地圖的其他控件。要在地圖中添加控件,請將控件的添加到與應(yīng)渲染它的ControlPosition相對應(yīng)的MVCArray中。
mapTypes
MapTypeRegistry
按字符串 ID 劃分的MapType實(shí)例的注冊表。
overlayMapTypes
MVCArray.
要疊加的其他地圖類型。
事件
事件
參數(shù)
說明
bounds_changed
None
當(dāng)可視區(qū)域范圍更改時(shí)會(huì)觸發(fā)此事件。
center_changed
None
當(dāng)?shù)貓D中心屬性更改時(shí)會(huì)觸發(fā)此事件。
click
MouseEvent
當(dāng)用戶點(diǎn)擊地圖(但不是點(diǎn)擊標(biāo)記或信息窗口)時(shí)會(huì)觸發(fā)此事件。
dblclick
MouseEvent
當(dāng)用戶雙擊地圖時(shí)會(huì)觸發(fā)此事件。請注意,觸發(fā)此事件前還會(huì)觸發(fā)點(diǎn)擊事件。
drag
None
當(dāng)用戶拖動(dòng)地圖時(shí)會(huì)反復(fù)觸發(fā)此事件。
dragend
None
當(dāng)用戶停止拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。
dragstart
None
當(dāng)用戶開始拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。
heading_changed
None
當(dāng)?shù)貓D方向?qū)傩愿臅r(shí)會(huì)觸發(fā)此事件。
idle
None
如果地圖在平移或縮放之后變?yōu)殚e置狀態(tài),則會(huì)觸發(fā)此事件。
maptypeid_changed
None
當(dāng) mapTypeId 屬性更改時(shí)會(huì)觸發(fā)此事件。
mousemove
MouseEvent
只要用戶的鼠標(biāo)在地圖容器上移動(dòng),就會(huì)觸發(fā)此事件。
mouseout
MouseEvent
當(dāng)用戶的鼠標(biāo)從地圖容器上退出時(shí)會(huì)觸發(fā)此事件。
mouseover
MouseEvent
當(dāng)用戶的鼠標(biāo)進(jìn)入地圖容器時(shí)會(huì)觸發(fā)此事件。
projection_changed
None
當(dāng)投影更改時(shí)會(huì)觸發(fā)此事件。
resize
None
當(dāng) div 更改大小時(shí),開發(fā)人員應(yīng)在地圖上觸發(fā)此事件:google.maps.event.trigger(map, resize) 。
rightclick
MouseEvent
在地圖容器中觸發(fā) DOM contextmenu 事件時(shí)會(huì)觸發(fā)此事件。
tilesloaded
None
可見圖塊載入完成后會(huì)觸發(fā)此事件。
tilt_changed
None
當(dāng)?shù)貓D傾斜屬性更改時(shí)會(huì)觸發(fā)此事件。
zoom_changed
None
當(dāng)?shù)貓D縮放屬性更改時(shí)會(huì)觸發(fā)此事件。
google.maps.MapOptions 對象規(guī)范
屬性
屬性
類型
說明
backgroundColor
string
用作地圖 div 的背景顏色。當(dāng)用戶進(jìn)行平移時(shí),如果尚未載入圖塊,則顯示此顏色。僅在啟動(dòng)地圖時(shí),才能設(shè)置此選項(xiàng)。
center
LatLng
初始的地圖中心。必填。
disableDefaultUI
boolean
啟用/停用所有默認(rèn)的用戶界面。該屬性可以單獨(dú)進(jìn)行重寫。
disableDoubleClickZoom
boolean
啟用/停用在雙擊時(shí)縮放并居中。默認(rèn)情況下處于啟用狀態(tài)。
draggable
boolean
如果為 False,則禁止拖動(dòng)地圖。默認(rèn)情況下啟用拖動(dòng)。
draggableCursor
string
要在可拖動(dòng)對象上顯示的光標(biāo)的名稱或網(wǎng)址。
draggingCursor
string
要在拖動(dòng)對象時(shí)顯示的光標(biāo)的名稱或網(wǎng)址。
heading
number
航拍圖像的方向值按順時(shí)針方向計(jì)算(以度為單位),基本方向?yàn)楸狈?。方向?huì)與可以查看到圖像的距離最近的可用角度相對齊。
keyboardShortcuts
boolean
如果為 False,則禁止通過鍵盤控制地圖。默認(rèn)情況下啟用鍵盤快捷鍵。
mapTypeControl
boolean
地圖類型控件的初始啟用/停用狀態(tài)。
mapTypeControlOptions
MapTypeControlOptions
地圖類型控件的初始顯示選項(xiàng)。
mapTypeId
MapTypeId
初始的地圖 mapTypeId。必填。
maxZoom
number
將會(huì)在地圖上顯示的最大縮放級(jí)別。如果將該屬性省略或設(shè)置為 Null,則系統(tǒng)會(huì)改為使用當(dāng)前地圖類型的最大縮放級(jí)別。
minZoom
number
將會(huì)在地圖上顯示的最小縮放級(jí)別。如果將該屬性省略或設(shè)置為 Null,則系統(tǒng)會(huì)改為使用當(dāng)前地圖類型的最小縮放級(jí)別。
noClear
boolean
如果為 true,則不會(huì)清除地圖 div 中的內(nèi)容。
overviewMapControl
boolean
總覽圖控件的啟用/停用狀態(tài)。
overviewMapControlOptions
OverviewMapControlOptions
總覽圖控件的顯示選項(xiàng)。
panControl
boolean
平移控件的啟用/停用狀態(tài)。
panControlOptions
PanControlOptions
平移控件的顯示選項(xiàng)。
rotateControl
boolean
旋轉(zhuǎn)控件的啟用/停用狀態(tài)。
rotateControlOptions
RotateControlOptions
旋轉(zhuǎn)控件的顯示選項(xiàng)。
scaleControl
boolean
比例控件的初始啟用/停用狀態(tài)。
scaleControlOptions
ScaleControlOptions
比例控件的初始顯示選項(xiàng)。
scrollwheel
boolean
如果為 False,則停用通過滾輪縮放地圖的功能。默認(rèn)情況下啟用滾輪功能。
streetView
StreetViewPanorama
將街景視圖街景小人置于地圖上時(shí)顯示的StreetViewPanorama。如果未指定全景圖,則拖動(dòng)街景小人時(shí),默認(rèn)StreetViewPanorama將顯示在地圖的div中。
streetViewControl
boolean
Street View 街景小人控件的初始啟用/停用狀態(tài)。
streetViewControlOptions
StreetViewControlOptions
Street View 街景小人控件的初始顯示選項(xiàng)。
tilt
number
從視口平面到地圖平面地圖的入射角,以度為單位進(jìn)行測量。目前僅支持兩個(gè)值:0(表明沒有入射角,即沒有傾斜)和45(表明有 45 傾斜)。45 圖像僅支持針對某些位置和采用某些縮放級(jí)別的SATELLITE和HYBRID地圖類型。
zoom
number
初始的地圖縮放級(jí)別。必填。
zoomControl
boolean
縮放控件的啟用/停用狀態(tài)。
zoomControlOptions
ZoomControlOptions
縮放控件的顯示選項(xiàng)。
google.maps.MapTypeId 類
常見 MapTypes 的標(biāo)識(shí)符。
常數(shù)
常數(shù)
說明
HYBRID
該地圖類型顯示衛(wèi)星圖像上的主要街道透明層。
ROADMAP
該地圖類型顯示普通的街道地圖。
SATELLITE
該地圖類型顯示衛(wèi)星圖像。
TERRAIN
該地圖類型顯示帶有自然特征(如地形和植被)的地圖。
google.maps.MapTypeControlOptions 對象規(guī)范
用于渲染地圖類型控件的選項(xiàng)。
屬性
屬性
類型
說明
mapTypeIds
Array.|Array.
要在控件中顯示的地圖類型的 ID。
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認(rèn)位置為TOP_RIGHT。
style
MapTypeControlStyle
樣式 ID。用于選擇要顯示的地圖類型控件的樣式。
google.maps.MapTypeControlStyle 類
常見 MapTypesControls 的標(biāo)識(shí)符。
常數(shù)
常數(shù)
說明
DEFAULT
使用默認(rèn)的地圖類型控件。地圖默認(rèn)使用的控件會(huì)因窗口大小和其他因素而有所不同。該控件可能在該 API 以后的版本中有所更改。
DROPDOWN_MENU
反映屏幕實(shí)際使用面積的下拉菜單。
HORIZONTAL_BAR
標(biāo)準(zhǔn)的水平單選按鈕欄。
google.maps.OverviewMapControlOptions 對象規(guī)范
用于呈現(xiàn)總覽圖控件的選項(xiàng)。
屬性
屬性
類型
說明
opened
boolean
用于指示控件應(yīng)以開放模式還是緊縮(最小化)模式顯示。默認(rèn)情況下,該控件處于關(guān)閉狀態(tài)。
google.maps.PanControlOptions 對象規(guī)范
用于呈現(xiàn)平移控件的選項(xiàng)。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認(rèn)位置為TOP_LEFT。
google.maps.RotateControlOptions 對象規(guī)范
用于呈現(xiàn)旋轉(zhuǎn)控件的選項(xiàng)。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認(rèn)位置為TOP_LEFT。
google.maps.ScaleControlOptions 對象規(guī)范
用于渲染比例控件的選項(xiàng)。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認(rèn)位置為BOTTOM_LEFT。
style
ScaleControlStyle
樣式 ID。用于選擇要顯示的縮放控件的樣式。
google.maps.ScaleControlStyle 類
縮放控件 ID 的標(biāo)識(shí)符。
常數(shù)
常數(shù)
說明
DEFAULT
標(biāo)準(zhǔn)縮放控件。
google.maps.StreetViewControlOptions 對象規(guī)范
用于在地圖上呈現(xiàn) Street View 街景小人控件的選項(xiàng)。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認(rèn)位置已嵌入到導(dǎo)航(縮放和平移)控件中。如果此位置為空或與zoomControlOptions或panControlOptions中指定位置的相同,則 Street View 控件將會(huì)作為導(dǎo)航控件的一部分顯示。其他情況下,該控件會(huì)單獨(dú)顯示。
google.maps.ZoomControlOptions 對象規(guī)范
用于呈現(xiàn)縮放控件的選項(xiàng)。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認(rèn)位置為TOP_LEFT。
style
ZoomControlStyle
樣式 ID。用于選擇要顯示的縮放控件的樣式。
google.maps.ZoomControlStyle 類
縮放控件的標(biāo)識(shí)符。
常數(shù)
常數(shù)
說明
DEFAULT
默認(rèn)的縮放控件。地圖默認(rèn)使用的控件會(huì)因窗口大小和其他因素而有所不同。該控件可能在該 API 以后的版本中有所更改。
LARGE
大型控件,除 +/- 按鈕以外還帶有縮放滑塊。
SMALL
小型控件,僅帶有縮放按鈕。
google.maps.ControlPosition 類
用于指定控件在地圖上的位置的標(biāo)識(shí)符??丶鄬τ谕徊季治恢弥械钠渌丶ㄎ?。首先添加的控件將定位在靠近地圖邊緣的位置。
+----------------+
+TLTCTR +
+LTRT +
++
+LCRC +
++
+LBRB +
+BLBCBR +
+----------------+
頂部或底部行中的元素將向中間流動(dòng)。左側(cè)或右側(cè)的元素向下流動(dòng)。
常數(shù)
常數(shù)
說明
BOTTOM_CENTER
元素定位在底部行的中間。
BOTTOM_LEFT
元素定位在左下角并向中間流動(dòng)。元素定位在 Google 徽標(biāo)的右側(cè)。
BOTTOM_RIGHT
元素定位在右下角并向中間流動(dòng)。元素定位在版權(quán)的左側(cè)。
LEFT_BOTTOM
元素定位在左側(cè),位于左下角元素的上方,并向上流動(dòng)。
LEFT_CENTER
元素定位在左側(cè)的中間。
LEFT_TOP
元素定位在左側(cè),位于左上角元素的下方,并向下流動(dòng)。
RIGHT_BOTTOM
元素定位在右側(cè),位于右下角元素的上方,并向上流動(dòng)。
RIGHT_CENTER
元素定位在右側(cè)的中間。
RIGHT_TOP
元素定位在右側(cè),位于右上角的元素下面,并向下流動(dòng)。
TOP_CENTER
元素定位在頂部行的中間。
TOP_LEFT
元素定位在左上角并向中間流動(dòng)。
TOP_RIGHT
元素定位在右上角并向中間流動(dòng)。
google.maps.Marker 類
此類擴(kuò)展了MVCObject。
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
Marker(opts?:MarkerOptions)
創(chuàng)建帶有指定選項(xiàng)的標(biāo)記。如果已指定地圖,則標(biāo)記會(huì)在構(gòu)造完成后立即添加到該地圖。請注意,您必須設(shè)置標(biāo)記的顯示位置。
方法
方法
返回值
說明
getAnimation()
Animation
getClickable()
boolean
getCursor()
string
getDraggable()
boolean
getFlat()
boolean
getIcon()
string|MarkerImage
getMap()
Map|StreetViewPanorama
getPosition()
LatLng
getShadow()
string|MarkerImage
getShape()
MarkerShape
getTitle()
string
getVisible()
boolean
getZIndex()
number
setAnimation(animation:Animation)
None
啟動(dòng)動(dòng)畫。系統(tǒng)將會(huì)取消所有正在播放的動(dòng)畫。當(dāng)前支持的動(dòng)畫類型為:BOUNCE、DROP。傳入null將會(huì)導(dǎo)致系統(tǒng)停放全部動(dòng)畫。
setClickable(flag:boolean)
None
setCursor(cursor:string)
None
setDraggable(flag:boolean)
None
setFlat(flag:boolean)
None
setIcon(icon:string|MarkerImage)
None
setMap(map:Map|StreetViewPanorama)
None
在指定地圖或全景圖上渲染標(biāo)記。如果地圖設(shè)置為 Null,則會(huì)刪除此標(biāo)記。
setOptions(options:MarkerOptions)
None
setPosition(latlng:LatLng)
None
setShadow(shadow:string|MarkerImage)
None
setShape(shape:MarkerShape)
None
setTitle(title:string)
None
setVisible(visible:boolean)
None
setZIndex(zIndex:number)
None
常數(shù)
常數(shù)
說明
MAX_ZINDEX
API 分配給標(biāo)記的最大默認(rèn) Z-index。您可以設(shè)置較高的 Z-index 值,以使相關(guān)標(biāo)記顯示在前面。
事件
事件
參數(shù)
說明
animation_changed
None
當(dāng)標(biāo)記的動(dòng)畫屬性發(fā)生更改時(shí)會(huì)觸發(fā)此事件。
click
MouseEvent
點(diǎn)擊標(biāo)記圖標(biāo)時(shí)會(huì)觸發(fā)此事件。
clickable_changed
None
當(dāng)標(biāo)記的可點(diǎn)擊屬性更改時(shí)會(huì)觸發(fā)此事件。
cursor_changed
None
當(dāng)標(biāo)記的光標(biāo)屬性更改時(shí)會(huì)觸發(fā)此事件。
dblclick
MouseEvent
當(dāng)雙擊標(biāo)記圖標(biāo)時(shí)會(huì)觸發(fā)此事件。
drag
MouseEvent
當(dāng)用戶拖動(dòng)標(biāo)記時(shí)會(huì)反復(fù)觸發(fā)此事件。
dragend
MouseEvent
當(dāng)用戶停止拖動(dòng)標(biāo)記時(shí)會(huì)觸發(fā)此事件。
draggable_changed
None
當(dāng)標(biāo)記的可拖動(dòng)屬性更改時(shí)會(huì)觸發(fā)此事件。
dragstart
MouseEvent
當(dāng)用戶開始拖動(dòng)標(biāo)記時(shí)會(huì)觸發(fā)此事件。
flat_changed
None
當(dāng)標(biāo)記的平面屬性更改時(shí)會(huì)觸發(fā)此事件。
icon_changed
None
當(dāng)標(biāo)記圖標(biāo)屬性更改時(shí)會(huì)觸發(fā)此事件。
mousedown
MouseEvent
對標(biāo)記觸發(fā) mousedown 事件時(shí)會(huì)觸發(fā)此事件。
mouseout
MouseEvent
當(dāng)鼠標(biāo)離開標(biāo)記圖標(biāo)區(qū)域時(shí)會(huì)觸發(fā)此事件。
mouseover
MouseEvent
當(dāng)鼠標(biāo)進(jìn)入標(biāo)記圖標(biāo)區(qū)域時(shí)會(huì)觸發(fā)此事件。
mouseup
MouseEvent
對標(biāo)記觸發(fā) mouseup 事件時(shí)會(huì)觸發(fā)此事件。
position_changed
None
當(dāng)標(biāo)記位置屬性更改時(shí)會(huì)觸發(fā)此事件。
rightclick
MouseEvent
對標(biāo)記觸發(fā) rightclick 事件時(shí)會(huì)觸發(fā)此事件。
shadow_changed
None
當(dāng)標(biāo)記的陰影屬性更改時(shí)會(huì)觸發(fā)此事件。
shape_changed
None
當(dāng)標(biāo)記的形狀屬性更改時(shí)會(huì)觸發(fā)此事件。
title_changed
None
當(dāng)標(biāo)記名稱屬性更改時(shí)會(huì)觸發(fā)此事件。
visible_changed
None
當(dāng)標(biāo)記的可見屬性更改時(shí)會(huì)觸發(fā)此事件。
zindex_changed
None
當(dāng)標(biāo)記的 zIndex 屬性更改時(shí)會(huì)觸發(fā)此事件。
google.maps.MarkerOptions 對象規(guī)范
屬性
屬性
類型
說明
animation
Animation
將標(biāo)記添加到地圖時(shí)所播放的動(dòng)畫。
clickable
boolean
如果為 true,則標(biāo)記會(huì)收到鼠標(biāo)事件和觸摸事件。默認(rèn)值為 true。
cursor
string
鼠標(biāo)懸停時(shí)顯示的光標(biāo)。
draggable
boolean
如果為 true,則可拖動(dòng)標(biāo)記。默認(rèn)值為 false。
flat
boolean
如果為 true,則不會(huì)顯示標(biāo)記陰影。
icon
string|MarkerImage
前景的圖標(biāo)
map
Map|StreetViewPanorama
要在其上顯示標(biāo)記的地圖。
optimized
boolean
用于將多個(gè)標(biāo)記呈現(xiàn)為單個(gè)靜態(tài)元素的優(yōu)化。系統(tǒng)會(huì)默認(rèn)啟用優(yōu)化呈現(xiàn)。應(yīng)針對動(dòng)態(tài) GIF/PNG 或在必須將每個(gè)標(biāo)記呈現(xiàn)為單獨(dú) DOM 元素時(shí)停用優(yōu)化呈現(xiàn)。
position
LatLng
標(biāo)記位置。必填。
raiseOnDrag
boolean
如果為 false,則停用拖動(dòng)標(biāo)記時(shí)的升降效果。默認(rèn)情況下,該選項(xiàng)為true。
shadow
string|MarkerImage
陰影圖像
shape
MarkerShape
用于拖動(dòng)/點(diǎn)擊的圖像地圖區(qū)域定義。
title
string
滾動(dòng)文本
visible
boolean
如果為 true,則顯示標(biāo)記。
zIndex
number
所有標(biāo)記均按其 zIndex 的順序在地圖上顯示,值較大的標(biāo)記會(huì)顯示在值較小的標(biāo)記之前。默認(rèn)情況下,標(biāo)記會(huì)按照它們在屏幕上的垂直位置來顯示,位置較低的標(biāo)記會(huì)顯示在位置較高的標(biāo)記之前。
google.maps.MarkerImage 類
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
MarkerImage(url:string, size?:Size, origin?:Point, anchor?:Point, scaledSize?:Size)
表示標(biāo)記圖標(biāo)或陰影圖片的結(jié)構(gòu)。
屬性
屬性
類型
說明
anchor
Point
地圖上與標(biāo)記位置相對應(yīng)的圖片錨定位置。默認(rèn)情況下,錨點(diǎn)會(huì)放置在圖片底部的中心點(diǎn)附近。
origin
Point
圖片在拼合圖片中的位置(如果有的話)。默認(rèn)情況下,原點(diǎn)位于圖片(0, 0)的左上角。
scaledSize
Size
進(jìn)行縮放后的整幅圖片的尺寸(如果有的話)??墒褂么藢傩陨煺?收縮圖片或拼合圖片。
size
Size
拼合圖片或圖片的顯示尺寸。使用拼合圖片時(shí)必須指定其尺寸。如果未提供尺寸,則系統(tǒng)會(huì)在加載圖片時(shí)進(jìn)行設(shè)置。
url
string
圖片或拼合圖片的網(wǎng)址。
google.maps.MarkerShape 對象規(guī)范
此對象定義用于確定標(biāo)記的可點(diǎn)擊區(qū)域的標(biāo)記形狀。該形狀包括兩個(gè)屬性(type和coord),這兩個(gè)屬性定義該類型的標(biāo)記特有的常規(guī)類型的標(biāo)記和坐標(biāo)。
屬性
屬性
類型
說明
coords
Array.
此屬性的格式取決于type的值,并且遵循h(huán)ttp://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords上的 w3 AREA coords規(guī)范。
coords屬性是一個(gè)整數(shù)數(shù)組,指定了形狀相對于目標(biāo)圖片左上角的像素位置。坐標(biāo)取決于type的值,具體如下:
- circle:坐標(biāo)為[x1,y1,r],其中 x1,y2 為圓心坐標(biāo),而 r 為圓的半徑。
- poly:坐標(biāo)為[x1,y1,x2,y2...xn,yn],其中每個(gè) x,y 對分別包含了多邊形的其中一個(gè)頂點(diǎn)的坐標(biāo)。
- rect:坐標(biāo)為[x1,y1,x2,y2],其中 x1,y1 是矩形左上角的坐標(biāo),而 x2,y2 是矩形右下角的坐標(biāo)。
type
string
用于描述形狀的類型,可能的值為circle、poly或rect。
google.maps.Animation 類
可以在標(biāo)記上播放的動(dòng)畫。在標(biāo)記上使用setAnimation方法或使用animation選項(xiàng)來播放動(dòng)畫。
常數(shù)
常數(shù)
說明
BOUNCE
在動(dòng)畫停止播放前,標(biāo)記會(huì)不斷地彈跳。
DROP
標(biāo)記會(huì)從地圖頂部掉落下來,然后稍微彈跳幾下。
google.maps.InfoWindow 類
疊加層外觀與提示框類似,通常會(huì)連接到某個(gè)標(biāo)記。此類擴(kuò)展了MVCObject。
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
InfoWindow(opts?:InfoWindowOptions)
創(chuàng)建帶有指定選項(xiàng)的信息窗口。信息窗口可以放置在地圖的特定位置,也可以位于標(biāo)記上方,具體取決于選項(xiàng)中指定的內(nèi)容。除非停用自動(dòng)平移,否則,信息窗口會(huì)在打開后平移地圖,以便讓自己顯示出來。信息窗口構(gòu)建完成后,您需要調(diào)用 open 函數(shù),才能在地圖上顯示該窗口。用戶可以點(diǎn)擊信息窗口上的關(guān)閉按鈕將其從地圖中關(guān)閉,開發(fā)人員也可以調(diào)用 close() 函數(shù)實(shí)現(xiàn)同樣的效果。
方法
方法
返回值
說明
close()
None
關(guān)閉此信息窗口,方法是將其從 DOM 結(jié)構(gòu)中刪除。
getContent()
string|Node
getPosition()
LatLng
getZIndex()
number
open(map?:Map|StreetViewPanorama, anchor?:MVCObject)
None
在指定的地圖上打開這個(gè)信息窗口。信息窗口可以與錨點(diǎn)相關(guān)聯(lián),但這屬于可選操作。在核心 API 中,唯一的錨點(diǎn)是 Marker 類。不過,錨點(diǎn)可以是用于展示位置屬性的任意 MVCObject,也可以是用于計(jì)算 pixelOffset 時(shí)的可選 anchorPoint(請參見 InfoWindowOptions)。anchorPoint 是從錨點(diǎn)位置到信息窗口頂端的偏移量。
setContent(content:string|Node)
None
setOptions(options:InfoWindowOptions)
None
setPosition(position:LatLng)
None
setZIndex(zIndex:number)
None
事件
事件
參數(shù)
說明
closeclick
None
點(diǎn)擊關(guān)閉按鈕時(shí)會(huì)觸發(fā)此事件。
content_changed
None
內(nèi)容屬性更改時(shí)會(huì)觸發(fā)此事件。
domready
None
當(dāng)包含InfoWindow的內(nèi)容的附加到 DOM 時(shí),會(huì)觸發(fā)此事件。如果您要?jiǎng)討B(tài)構(gòu)建信息窗口內(nèi)容,則可能希望監(jiān)視此事件。
position_changed
None
位置屬性更改時(shí)會(huì)觸發(fā)此事件。
zindex_changed
None
信息窗口的 zIndex 更改時(shí)會(huì)觸發(fā)此事件。
google.maps.InfoWindowOptions 對象規(guī)范
屬性
屬性
類型
說明
content
string|Node
要在信息窗口中顯示的內(nèi)容。該內(nèi)容可以是 HTML 元素、純文本字符串或包含 HTML 的字符串。信息窗口將會(huì)根據(jù)相應(yīng)內(nèi)容調(diào)整大小。要設(shè)置內(nèi)容的具體大小,請將內(nèi)容設(shè)置為相應(yīng)大小的 HTML 元素。
disableAutoPan
boolean
停用在打開時(shí)自動(dòng)平移的功能。默認(rèn)情況下,信息窗口會(huì)在打開后平移地圖,以便讓自己完全顯示出來。
maxWidth
number
信息窗口的最大寬度(不考慮內(nèi)容的寬度)。僅在已調(diào)用 open 函數(shù)前設(shè)置了該值時(shí),才考慮使用這個(gè)值。在更改內(nèi)容時(shí),如果要更改最大寬度,請調(diào)用 close 函數(shù)、setOptions 函數(shù),然后調(diào)用 open 函數(shù)。
pixelOffset
Size
信息窗口的箭頭距離信息窗口在地圖上所錨定地理坐標(biāo)點(diǎn)的偏移量(以像素為單位)。如果信息窗口是通過錨點(diǎn)打開的,則從錨點(diǎn)范圍的頂部中心開始計(jì)算 pixelOffset。
position
LatLng
用于顯示此信息窗口的 LatLng。如果信息窗口是通過錨點(diǎn)打開的,則使用錨點(diǎn)的位置。
zIndex
number
所有信息窗口按 zIndex 值的大小順序在地圖上顯示,zIndex 值較大的信息窗口顯示在值較小的信息窗口之前。默認(rèn)情況下,信息窗口是按緯度顯示的,緯度較低的信息窗口顯示在緯度較高的信息窗口前。信息窗口始終在標(biāo)記前面顯示。
google.maps.Polyline 類
折線是地圖上的連接線段的線性疊加層。此類擴(kuò)展了MVCObject。
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
Polyline(opts?:PolylineOptions)
使用傳遞的PolylineOptions創(chuàng)建折線,這些選項(xiàng)可以指定折線的路徑以及繪制折線時(shí)要使用的筆觸樣式。您可以在構(gòu)造折線時(shí)傳遞LatLng數(shù)組或LatLng的MVCArray,但在實(shí)例化時(shí),簡單的數(shù)組會(huì)在折線中轉(zhuǎn)換為MVCArray。
方法
方法
返回值
說明
getMap()
Map
傳回已附加此折線或多邊形的地圖。
getPath()
MVCArray.
檢索第一條路徑。
setMap(map:Map)
None
在指定地圖上渲染此折線或多邊形。如果地圖設(shè)置為 Null,則會(huì)刪除此折線或多邊形。
setOptions(options:PolylineOptions)
None
setPath(path:
MVCArray.|
Array.)
None
設(shè)置第一條路徑。有關(guān)詳細(xì)信息,請參見PolylineOptions。
事件
事件
參數(shù)
說明
click
MouseEvent
對折線觸發(fā) DOM click 事件時(shí)會(huì)觸發(fā)此事件。
dblclick
MouseEvent
對折線觸發(fā) DOM dblclick 事件時(shí)會(huì)觸發(fā)此事件。
mousedown
MouseEvent
對折線觸發(fā) DOM mousedown 事件時(shí)會(huì)觸發(fā)此事件。
mousemove
MouseEvent
對折線觸發(fā) DOM mousemove 事件時(shí)會(huì)觸發(fā)此事件。
mouseout
MouseEvent
此事件針對折線 mouseout 觸發(fā)。
mouseover
MouseEvent
此事件針對折線 mouseover 觸發(fā)。
mouseup
MouseEvent
對折線觸發(fā) DOM mouseup 事件時(shí)會(huì)觸發(fā)此事件。
rightclick
MouseEvent
右鍵點(diǎn)擊折線時(shí)會(huì)觸發(fā)此事件。
google.maps.PolylineOptions 對象規(guī)范
屬性
屬性
類型
說明
clickable
boolean
指示此Polyline是否處理click事件。默認(rèn)值為true。
geodesic
boolean
將每條邊渲染為測地線(“大圓”的一段)。測地線是沿地球表面的兩點(diǎn)之間的最短路徑。
map
Map
要在其上顯示折線的地圖。
path
MVCArray.|
Array.
折線坐標(biāo)的有序序列。可以使用一個(gè)簡單的LatLng數(shù)組或者LatLng的MVCArray指定此路徑。請注意,如果您傳遞簡單的數(shù)組,則它會(huì)轉(zhuǎn)換為MVCArray。在MVCArray中插入或刪除 LatLng 將自動(dòng)更新地圖上的折線。
strokeColor
string
筆觸顏色。支持所有 CSS3 顏色,擴(kuò)展命名的顏色除外。
strokeOpacity
number
介于 0.0 和 1.0 之間的筆觸不透明度
strokeWeight
number
筆觸寬度(以像素為單位)。
zIndex
number
相對于其他折線的 zIndex。
google.maps.Polygon 類
多邊形(類似于折線)可在一個(gè)有序序列中定義一系列連接坐標(biāo);此外,多邊形會(huì)形成一個(gè)閉合環(huán)并定義一個(gè)填充區(qū)域。此類擴(kuò)展了MVCObject。
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
Polygon(opts?:PolygonOptions)
使用傳遞的PolygonOptions創(chuàng)建多邊形,這些選項(xiàng)可以指定多邊形的路徑、多邊形邊緣的筆觸樣式,以及多邊形內(nèi)部區(qū)域的填充樣式。一個(gè)多邊形可以包含一條或多條路徑,其中每條路徑由一個(gè)LatLng數(shù)組組成。您可以在構(gòu)造這些路徑時(shí)傳遞一個(gè) LatLng 數(shù)組或LatLng的MVCArray。實(shí)例化時(shí),數(shù)組會(huì)在多邊形中轉(zhuǎn)換為MVCArray。
方法
方法
返回值
說明
getMap()
Map
傳回已附加此折線或多邊形的地圖。
getPath()
MVCArray.
檢索第一條路徑。
getPaths()
MVCArray.>
檢索此多邊形的路徑。
setMap(map:Map)
None
在指定地圖上渲染此折線或多邊形。如果地圖設(shè)置為 Null,則會(huì)刪除此折線或多邊形。
setOptions(options:PolygonOptions)
None
setPath(path:
MVCArray.|
Array.)
None
設(shè)置第一條路徑。有關(guān)詳細(xì)信息,請參見PolylineOptions。
setPaths(paths:
MVCArray.>|
MVCArray.|
Array.>|
Array.)
None
設(shè)置此多邊形的路徑。
事件
事件
參數(shù)
說明
click
MouseEvent
對多邊形觸發(fā) DOM click 事件時(shí)會(huì)觸發(fā)此事件。
dblclick
MouseEvent
對多邊形觸發(fā) DOM dblclick 事件時(shí)會(huì)觸發(fā)此事件。
mousedown
MouseEvent
對多邊形觸發(fā) DOM mousedown 事件時(shí)會(huì)觸發(fā)此事件。
mousemove
MouseEvent
對多邊形觸發(fā) DOM mousemove 事件時(shí)會(huì)觸發(fā)此事件。
mouseout
MouseEvent
此事件針對多邊形 mouseout 觸發(fā)。
mouseover
MouseEvent
此事件針對多邊形 mouseover 觸發(fā)。
mouseup
MouseEvent
對多邊形觸發(fā) DOM mouseup 事件時(shí)會(huì)觸發(fā)此事件。
rightclick
MouseEvent
右鍵點(diǎn)擊多邊形時(shí)會(huì)觸發(fā)此事件。
google.maps.PolygonOptions 對象規(guī)范
屬性
屬性
類型
說明
clickable
boolean
指示此Polygon是否處理click事件。默認(rèn)值為true。
fillColor
string
填充色。支持所有 CSS3 顏色,擴(kuò)展命名的顏色除外。
fillOpacity
number
介于 0.0 和 1.0 之間的填充不透明度
geodesic
boolean
將每條邊渲染為測地線(“大圓”的一段)。測地線是沿地球表面的兩點(diǎn)之間的最短路徑。
map
Map
要在其上顯示多邊形的地圖。
paths
MVCArray.>|
MVCArray.|
Array.>|
Array.
用于指定閉合環(huán)的坐標(biāo)的有序序列。不同于折線,一個(gè)多邊形由一條或多條路徑組成。因此,路徑屬性可以指定一個(gè)或多個(gè)LatLng坐標(biāo)數(shù)組??梢允褂靡粋€(gè)LatLng數(shù)組定義簡單的多邊形。多個(gè)復(fù)雜的多邊形可以指定一系列數(shù)組。任何簡單數(shù)組都可以轉(zhuǎn)換為MVCArray。在MVCArray中插入或刪除LatLng將自動(dòng)更新地圖上的多邊形。
strokeColor
string
筆觸顏色。支持所有 CSS3 顏色,擴(kuò)展命名的顏色除外。
strokeOpacity
number
介于 0.0 和 1.0 之間的筆觸不透明度
strokeWeight
number
筆觸寬度(以像素為單位)。
zIndex
number
相對于其他折線的 zIndex。
google.maps.Rectangle 類
矩形疊加層。此類擴(kuò)展了MVCObject。
構(gòu)造函數(shù)
構(gòu)造函數(shù)
說明
Rectangle(opts?:RectangleOptions)
使用傳遞的RectangleOptions(它指定范圍和樣式)創(chuàng)建矩形。
方法
方法
返回值
說明
getBounds()
LatLngBounds
傳回此矩形的范圍。
getMap()
Map
傳回顯示此矩形的地圖。
setBounds(bounds:LatLngBounds)
None
設(shè)置此矩形的范圍。
setMap(map:Map)
None
在指定地圖上渲染此矩形。如果地圖設(shè)置為 Null,則會(huì)刪除此矩形。
se
下載提示(請認(rèn)真閱讀)
- 1.請仔細(xì)閱讀文檔,確保文檔完整性,對于不預(yù)覽、不比對內(nèi)容而直接下載帶來的問題本站不予受理。
- 2.下載的文檔,不會(huì)出現(xiàn)我們的網(wǎng)址水印。
- 3、該文檔所得收入(下載+內(nèi)容+預(yù)覽)歸上傳者、原創(chuàng)作者;如果您是本文檔原作者,請點(diǎn)此認(rèn)領(lǐng)!既往收益都?xì)w您。
文檔包含非法信息?點(diǎn)此舉報(bào)后獲取現(xiàn)金獎(jiǎng)勵(lì)!
下載文檔到電腦,查找使用更方便
9.9
積分
- 配套講稿:
如PPT文件的首頁顯示word圖標(biāo),表示該P(yáng)PT已包含配套word講稿。雙擊word圖標(biāo)可打開word文檔。
- 特殊限制:
部分文檔作品中含有的國旗、國徽等圖片,僅作為作品整體效果示例展示,禁止商用。設(shè)計(jì)者僅對作品中獨(dú)創(chuàng)性部分享有著作權(quán)。
- 關(guān) 鍵 詞:
-
googleMapsAPIV3
中文
參考手冊
- 溫馨提示:
1: 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
2: 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
3.本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
5. 裝配圖網(wǎng)僅提供信息存儲(chǔ)空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
裝配圖網(wǎng)所有資源均是用戶自行上傳分享,僅供網(wǎng)友學(xué)習(xí)交流,未經(jīng)上傳用戶書面授權(quán),請勿作他用。
鏈接地址:http://www.820124.com/p-8847233.html