googleMapsAPIV3-中文參考手冊.doc
《googleMapsAPIV3-中文參考手冊.doc》由會員分享,可在線閱讀,更多相關《googleMapsAPIV3-中文參考手冊.doc(57頁珍藏版)》請在裝配圖網(wǎng)上搜索。
google Maps JavaScript API V3 參考 注意:以下網(wǎng)頁中提到的 Google Maps JavaScript API 第 3 版現(xiàn)在是正式的 JavaScript API 版本。該 API 的第 2 版已根據(jù)我們的棄用政策正式棄用。歡迎您將代碼移植到這個功能更強、最近更新的版本中! 最新版本 最后更新時間:2011 年 6 月 8 日,星期三 歡迎使用 JavaScript Maps API V3 參考。此參考將經常更新,與 API 的最新更改保持同步。有關每個版本的新增功能的信息,請參考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 服務: 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 類 此類擴展了MVCObject。 構造函數(shù) 構造函數(shù) 說明 Map(mapDiv:Node, opts?:MapOptions) 在指定的 HTML 容器中創(chuàng)建新的地圖,該容器通常是一個DIV元素。 方法 方法 返回值 說明 fitBounds(bounds:LatLngBounds) None 用于設置視口,使其包含指定邊界。 getBounds() LatLngBounds 用于返回當前視口的緯度/經度范圍。如果尚未啟動地圖(即 mapType 仍為 Null),或尚未設置中心和縮放,則結果為null或undefined。 getCenter() LatLng getDiv() Node getHeading() number 用于返回航拍圖像的羅盤方向。方向值按順時針方向計算(以度為單位),基本方向為北方。 getMapTypeId() MapTypeId getProjection() Projection 傳回當前的Projection。如果還未啟動地圖(即 mapType 仍為 Null),則結果為 Null。偵聽projection_changed并檢查它的值以確保它的值不為 Null。 getStreetView() StreetViewPanorama 將默認StreetViewPanorama范圍傳回到地圖,該范圍可能是嵌入在地圖中的默認全景圖,也可能是使用setStreetView()設置的全景圖。對地圖的streetViewControl所做的更改將反映在此類范圍全景圖的顯示中。 getTilt() number 用于返回從視口平面到地圖平面的航拍圖像(支持SATELLITE和HYBRID地圖類型)的入射角,以度為單位進行測量。值0表明沒有入射角(沒有傾斜),而 45 圖像將會返回值45。 getZoom() number panBy(x:number, y:number) None 將地圖中心移動一段指定的距離(以像素為單位)。如果這段距離既小于地圖的寬度,又小于地圖的高度,那么移動的動畫效果將會十分流暢。請注意,地圖坐標系的 x 值從西向東增加,y 值從北向南增加。 panTo(latLng:LatLng) None 將地圖中心更改為指定的LatLng。如果更改幅度既小于地圖的寬度,又小于地圖的高度,那么移動的動畫效果將會十分流暢。 panToBounds(latLngBounds:LatLngBounds) None 將地圖平移所需的最小距離以包含指定的LatLngBounds。范圍在地圖上的位置并不確定,除了盡可能多地顯示范圍。范圍將定位于由地圖類型和導航(平移、縮放和 Street View)控件所限定的區(qū)域內(如果這些控件出現(xiàn)在地圖上的話)。如果范圍大于地圖,則地圖會移動,以便包括范圍的西北角。如果地圖位置的移動幅度既小于地圖的寬度,又小于地圖的高度,那么移動的動畫效果將會十分流暢。 setCenter(latlng:LatLng) None setHeading(heading:number) None 用于設置航拍圖像的羅盤方向(以度為單位進行測量),基本方向為北方。 setMapTypeId(mapTypeId:MapTypeId) None setOptions(options:MapOptions) None setStreetView(panorama:StreetViewPanorama) None 將StreetViewPanorama綁定到地圖。此全景圖將覆蓋默認StreetViewPanorama,從而使地圖可以綁定到地圖外的外部全景圖。將全景圖設置為null可將默認的嵌入式全景圖綁定回到地圖。 setTilt(tilt:number) None 用于設置從視口平面到地圖平面的航拍圖像(支持SATELLITE和HYBRID地圖類型)的入射角,以度為單位進行測量。僅支持兩個值:0(表明沒有入射角,即沒有傾斜)和45(表明有 45 傾斜)。 setZoom(zoom:number) None 屬性 屬性 類型 說明 controls Array.添加到與應渲染它的ControlPosition相對應的MVCArray中。
mapTypes
MapTypeRegistry
按字符串 ID 劃分的MapType實例的注冊表。
overlayMapTypes
MVCArray.
要疊加的其他地圖類型。
事件
事件
參數(shù)
說明
bounds_changed
None
當可視區(qū)域范圍更改時會觸發(fā)此事件。
center_changed
None
當?shù)貓D中心屬性更改時會觸發(fā)此事件。
click
MouseEvent
當用戶點擊地圖(但不是點擊標記或信息窗口)時會觸發(fā)此事件。
dblclick
MouseEvent
當用戶雙擊地圖時會觸發(fā)此事件。請注意,觸發(fā)此事件前還會觸發(fā)點擊事件。
drag
None
當用戶拖動地圖時會反復觸發(fā)此事件。
dragend
None
當用戶停止拖動地圖時會觸發(fā)此事件。
dragstart
None
當用戶開始拖動地圖時會觸發(fā)此事件。
heading_changed
None
當?shù)貓D方向屬性更改時會觸發(fā)此事件。
idle
None
如果地圖在平移或縮放之后變?yōu)殚e置狀態(tài),則會觸發(fā)此事件。
maptypeid_changed
None
當 mapTypeId 屬性更改時會觸發(fā)此事件。
mousemove
MouseEvent
只要用戶的鼠標在地圖容器上移動,就會觸發(fā)此事件。
mouseout
MouseEvent
當用戶的鼠標從地圖容器上退出時會觸發(fā)此事件。
mouseover
MouseEvent
當用戶的鼠標進入地圖容器時會觸發(fā)此事件。
projection_changed
None
當投影更改時會觸發(fā)此事件。
resize
None
當 div 更改大小時,開發(fā)人員應在地圖上觸發(fā)此事件:google.maps.event.trigger(map, resize) 。
rightclick
MouseEvent
在地圖容器中觸發(fā) DOM contextmenu 事件時會觸發(fā)此事件。
tilesloaded
None
可見圖塊載入完成后會觸發(fā)此事件。
tilt_changed
None
當?shù)貓D傾斜屬性更改時會觸發(fā)此事件。
zoom_changed
None
當?shù)貓D縮放屬性更改時會觸發(fā)此事件。
google.maps.MapOptions 對象規(guī)范
屬性
屬性
類型
說明
backgroundColor
string
用作地圖 div 的背景顏色。當用戶進行平移時,如果尚未載入圖塊,則顯示此顏色。僅在啟動地圖時,才能設置此選項。
center
LatLng
初始的地圖中心。必填。
disableDefaultUI
boolean
啟用/停用所有默認的用戶界面。該屬性可以單獨進行重寫。
disableDoubleClickZoom
boolean
啟用/停用在雙擊時縮放并居中。默認情況下處于啟用狀態(tài)。
draggable
boolean
如果為 False,則禁止拖動地圖。默認情況下啟用拖動。
draggableCursor
string
要在可拖動對象上顯示的光標的名稱或網(wǎng)址。
draggingCursor
string
要在拖動對象時顯示的光標的名稱或網(wǎng)址。
heading
number
航拍圖像的方向值按順時針方向計算(以度為單位),基本方向為北方。方向會與可以查看到圖像的距離最近的可用角度相對齊。
keyboardShortcuts
boolean
如果為 False,則禁止通過鍵盤控制地圖。默認情況下啟用鍵盤快捷鍵。
mapTypeControl
boolean
地圖類型控件的初始啟用/停用狀態(tài)。
mapTypeControlOptions
MapTypeControlOptions
地圖類型控件的初始顯示選項。
mapTypeId
MapTypeId
初始的地圖 mapTypeId。必填。
maxZoom
number
將會在地圖上顯示的最大縮放級別。如果將該屬性省略或設置為 Null,則系統(tǒng)會改為使用當前地圖類型的最大縮放級別。
minZoom
number
將會在地圖上顯示的最小縮放級別。如果將該屬性省略或設置為 Null,則系統(tǒng)會改為使用當前地圖類型的最小縮放級別。
noClear
boolean
如果為 true,則不會清除地圖 div 中的內容。
overviewMapControl
boolean
總覽圖控件的啟用/停用狀態(tài)。
overviewMapControlOptions
OverviewMapControlOptions
總覽圖控件的顯示選項。
panControl
boolean
平移控件的啟用/停用狀態(tài)。
panControlOptions
PanControlOptions
平移控件的顯示選項。
rotateControl
boolean
旋轉控件的啟用/停用狀態(tài)。
rotateControlOptions
RotateControlOptions
旋轉控件的顯示選項。
scaleControl
boolean
比例控件的初始啟用/停用狀態(tài)。
scaleControlOptions
ScaleControlOptions
比例控件的初始顯示選項。
scrollwheel
boolean
如果為 False,則停用通過滾輪縮放地圖的功能。默認情況下啟用滾輪功能。
streetView
StreetViewPanorama
將街景視圖街景小人置于地圖上時顯示的StreetViewPanorama。如果未指定全景圖,則拖動街景小人時,默認StreetViewPanorama將顯示在地圖的div中。
streetViewControl
boolean
Street View 街景小人控件的初始啟用/停用狀態(tài)。
streetViewControlOptions
StreetViewControlOptions
Street View 街景小人控件的初始顯示選項。
tilt
number
從視口平面到地圖平面地圖的入射角,以度為單位進行測量。目前僅支持兩個值:0(表明沒有入射角,即沒有傾斜)和45(表明有 45 傾斜)。45 圖像僅支持針對某些位置和采用某些縮放級別的SATELLITE和HYBRID地圖類型。
zoom
number
初始的地圖縮放級別。必填。
zoomControl
boolean
縮放控件的啟用/停用狀態(tài)。
zoomControlOptions
ZoomControlOptions
縮放控件的顯示選項。
google.maps.MapTypeId 類
常見 MapTypes 的標識符。
常數(shù)
常數(shù)
說明
HYBRID
該地圖類型顯示衛(wèi)星圖像上的主要街道透明層。
ROADMAP
該地圖類型顯示普通的街道地圖。
SATELLITE
該地圖類型顯示衛(wèi)星圖像。
TERRAIN
該地圖類型顯示帶有自然特征(如地形和植被)的地圖。
google.maps.MapTypeControlOptions 對象規(guī)范
用于渲染地圖類型控件的選項。
屬性
屬性
類型
說明
mapTypeIds
Array.|Array.
要在控件中顯示的地圖類型的 ID。
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認位置為TOP_RIGHT。
style
MapTypeControlStyle
樣式 ID。用于選擇要顯示的地圖類型控件的樣式。
google.maps.MapTypeControlStyle 類
常見 MapTypesControls 的標識符。
常數(shù)
常數(shù)
說明
DEFAULT
使用默認的地圖類型控件。地圖默認使用的控件會因窗口大小和其他因素而有所不同。該控件可能在該 API 以后的版本中有所更改。
DROPDOWN_MENU
反映屏幕實際使用面積的下拉菜單。
HORIZONTAL_BAR
標準的水平單選按鈕欄。
google.maps.OverviewMapControlOptions 對象規(guī)范
用于呈現(xiàn)總覽圖控件的選項。
屬性
屬性
類型
說明
opened
boolean
用于指示控件應以開放模式還是緊縮(最小化)模式顯示。默認情況下,該控件處于關閉狀態(tài)。
google.maps.PanControlOptions 對象規(guī)范
用于呈現(xiàn)平移控件的選項。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認位置為TOP_LEFT。
google.maps.RotateControlOptions 對象規(guī)范
用于呈現(xiàn)旋轉控件的選項。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認位置為TOP_LEFT。
google.maps.ScaleControlOptions 對象規(guī)范
用于渲染比例控件的選項。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認位置為BOTTOM_LEFT。
style
ScaleControlStyle
樣式 ID。用于選擇要顯示的縮放控件的樣式。
google.maps.ScaleControlStyle 類
縮放控件 ID 的標識符。
常數(shù)
常數(shù)
說明
DEFAULT
標準縮放控件。
google.maps.StreetViewControlOptions 對象規(guī)范
用于在地圖上呈現(xiàn) Street View 街景小人控件的選項。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認位置已嵌入到導航(縮放和平移)控件中。如果此位置為空或與zoomControlOptions或panControlOptions中指定位置的相同,則 Street View 控件將會作為導航控件的一部分顯示。其他情況下,該控件會單獨顯示。
google.maps.ZoomControlOptions 對象規(guī)范
用于呈現(xiàn)縮放控件的選項。
屬性
屬性
類型
說明
position
ControlPosition
位置 ID。用于指定控件在地圖上的位置。默認位置為TOP_LEFT。
style
ZoomControlStyle
樣式 ID。用于選擇要顯示的縮放控件的樣式。
google.maps.ZoomControlStyle 類
縮放控件的標識符。
常數(shù)
常數(shù)
說明
DEFAULT
默認的縮放控件。地圖默認使用的控件會因窗口大小和其他因素而有所不同。該控件可能在該 API 以后的版本中有所更改。
LARGE
大型控件,除 +/- 按鈕以外還帶有縮放滑塊。
SMALL
小型控件,僅帶有縮放按鈕。
google.maps.ControlPosition 類
用于指定控件在地圖上的位置的標識符。控件相對于同一布局位置中的其他控件而定位。首先添加的控件將定位在靠近地圖邊緣的位置。
+----------------+
+TLTCTR +
+LTRT +
++
+LCRC +
++
+LBRB +
+BLBCBR +
+----------------+
頂部或底部行中的元素將向中間流動。左側或右側的元素向下流動。
常數(shù)
常數(shù)
說明
BOTTOM_CENTER
元素定位在底部行的中間。
BOTTOM_LEFT
元素定位在左下角并向中間流動。元素定位在 Google 徽標的右側。
BOTTOM_RIGHT
元素定位在右下角并向中間流動。元素定位在版權的左側。
LEFT_BOTTOM
元素定位在左側,位于左下角元素的上方,并向上流動。
LEFT_CENTER
元素定位在左側的中間。
LEFT_TOP
元素定位在左側,位于左上角元素的下方,并向下流動。
RIGHT_BOTTOM
元素定位在右側,位于右下角元素的上方,并向上流動。
RIGHT_CENTER
元素定位在右側的中間。
RIGHT_TOP
元素定位在右側,位于右上角的元素下面,并向下流動。
TOP_CENTER
元素定位在頂部行的中間。
TOP_LEFT
元素定位在左上角并向中間流動。
TOP_RIGHT
元素定位在右上角并向中間流動。
google.maps.Marker 類
此類擴展了MVCObject。
構造函數(shù)
構造函數(shù)
說明
Marker(opts?:MarkerOptions)
創(chuàng)建帶有指定選項的標記。如果已指定地圖,則標記會在構造完成后立即添加到該地圖。請注意,您必須設置標記的顯示位置。
方法
方法
返回值
說明
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
啟動動畫。系統(tǒng)將會取消所有正在播放的動畫。當前支持的動畫類型為:BOUNCE、DROP。傳入null將會導致系統(tǒ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
在指定地圖或全景圖上渲染標記。如果地圖設置為 Null,則會刪除此標記。
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 分配給標記的最大默認 Z-index。您可以設置較高的 Z-index 值,以使相關標記顯示在前面。
事件
事件
參數(shù)
說明
animation_changed
None
當標記的動畫屬性發(fā)生更改時會觸發(fā)此事件。
click
MouseEvent
點擊標記圖標時會觸發(fā)此事件。
clickable_changed
None
當標記的可點擊屬性更改時會觸發(fā)此事件。
cursor_changed
None
當標記的光標屬性更改時會觸發(fā)此事件。
dblclick
MouseEvent
當雙擊標記圖標時會觸發(fā)此事件。
drag
MouseEvent
當用戶拖動標記時會反復觸發(fā)此事件。
dragend
MouseEvent
當用戶停止拖動標記時會觸發(fā)此事件。
draggable_changed
None
當標記的可拖動屬性更改時會觸發(fā)此事件。
dragstart
MouseEvent
當用戶開始拖動標記時會觸發(fā)此事件。
flat_changed
None
當標記的平面屬性更改時會觸發(fā)此事件。
icon_changed
None
當標記圖標屬性更改時會觸發(fā)此事件。
mousedown
MouseEvent
對標記觸發(fā) mousedown 事件時會觸發(fā)此事件。
mouseout
MouseEvent
當鼠標離開標記圖標區(qū)域時會觸發(fā)此事件。
mouseover
MouseEvent
當鼠標進入標記圖標區(qū)域時會觸發(fā)此事件。
mouseup
MouseEvent
對標記觸發(fā) mouseup 事件時會觸發(fā)此事件。
position_changed
None
當標記位置屬性更改時會觸發(fā)此事件。
rightclick
MouseEvent
對標記觸發(fā) rightclick 事件時會觸發(fā)此事件。
shadow_changed
None
當標記的陰影屬性更改時會觸發(fā)此事件。
shape_changed
None
當標記的形狀屬性更改時會觸發(fā)此事件。
title_changed
None
當標記名稱屬性更改時會觸發(fā)此事件。
visible_changed
None
當標記的可見屬性更改時會觸發(fā)此事件。
zindex_changed
None
當標記的 zIndex 屬性更改時會觸發(fā)此事件。
google.maps.MarkerOptions 對象規(guī)范
屬性
屬性
類型
說明
animation
Animation
將標記添加到地圖時所播放的動畫。
clickable
boolean
如果為 true,則標記會收到鼠標事件和觸摸事件。默認值為 true。
cursor
string
鼠標懸停時顯示的光標。
draggable
boolean
如果為 true,則可拖動標記。默認值為 false。
flat
boolean
如果為 true,則不會顯示標記陰影。
icon
string|MarkerImage
前景的圖標
map
Map|StreetViewPanorama
要在其上顯示標記的地圖。
optimized
boolean
用于將多個標記呈現(xiàn)為單個靜態(tài)元素的優(yōu)化。系統(tǒng)會默認啟用優(yōu)化呈現(xiàn)。應針對動態(tài) GIF/PNG 或在必須將每個標記呈現(xiàn)為單獨 DOM 元素時停用優(yōu)化呈現(xiàn)。
position
LatLng
標記位置。必填。
raiseOnDrag
boolean
如果為 false,則停用拖動標記時的升降效果。默認情況下,該選項為true。
shadow
string|MarkerImage
陰影圖像
shape
MarkerShape
用于拖動/點擊的圖像地圖區(qū)域定義。
title
string
滾動文本
visible
boolean
如果為 true,則顯示標記。
zIndex
number
所有標記均按其 zIndex 的順序在地圖上顯示,值較大的標記會顯示在值較小的標記之前。默認情況下,標記會按照它們在屏幕上的垂直位置來顯示,位置較低的標記會顯示在位置較高的標記之前。
google.maps.MarkerImage 類
構造函數(shù)
構造函數(shù)
說明
MarkerImage(url:string, size?:Size, origin?:Point, anchor?:Point, scaledSize?:Size)
表示標記圖標或陰影圖片的結構。
屬性
屬性
類型
說明
anchor
Point
地圖上與標記位置相對應的圖片錨定位置。默認情況下,錨點會放置在圖片底部的中心點附近。
origin
Point
圖片在拼合圖片中的位置(如果有的話)。默認情況下,原點位于圖片(0, 0)的左上角。
scaledSize
Size
進行縮放后的整幅圖片的尺寸(如果有的話)??墒褂么藢傩陨煺?收縮圖片或拼合圖片。
size
Size
拼合圖片或圖片的顯示尺寸。使用拼合圖片時必須指定其尺寸。如果未提供尺寸,則系統(tǒng)會在加載圖片時進行設置。
url
string
圖片或拼合圖片的網(wǎng)址。
google.maps.MarkerShape 對象規(guī)范
此對象定義用于確定標記的可點擊區(qū)域的標記形狀。該形狀包括兩個屬性(type和coord),這兩個屬性定義該類型的標記特有的常規(guī)類型的標記和坐標。
屬性
屬性
類型
說明
coords
Array.
此屬性的格式取決于type的值,并且遵循h(huán)ttp://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords上的 w3 AREA coords規(guī)范。
coords屬性是一個整數(shù)數(shù)組,指定了形狀相對于目標圖片左上角的像素位置。坐標取決于type的值,具體如下:
- circle:坐標為[x1,y1,r],其中 x1,y2 為圓心坐標,而 r 為圓的半徑。
- poly:坐標為[x1,y1,x2,y2...xn,yn],其中每個 x,y 對分別包含了多邊形的其中一個頂點的坐標。
- rect:坐標為[x1,y1,x2,y2],其中 x1,y1 是矩形左上角的坐標,而 x2,y2 是矩形右下角的坐標。
type
string
用于描述形狀的類型,可能的值為circle、poly或rect。
google.maps.Animation 類
可以在標記上播放的動畫。在標記上使用setAnimation方法或使用animation選項來播放動畫。
常數(shù)
常數(shù)
說明
BOUNCE
在動畫停止播放前,標記會不斷地彈跳。
DROP
標記會從地圖頂部掉落下來,然后稍微彈跳幾下。
google.maps.InfoWindow 類
疊加層外觀與提示框類似,通常會連接到某個標記。此類擴展了MVCObject。
構造函數(shù)
構造函數(shù)
說明
InfoWindow(opts?:InfoWindowOptions)
創(chuàng)建帶有指定選項的信息窗口。信息窗口可以放置在地圖的特定位置,也可以位于標記上方,具體取決于選項中指定的內容。除非停用自動平移,否則,信息窗口會在打開后平移地圖,以便讓自己顯示出來。信息窗口構建完成后,您需要調用 open 函數(shù),才能在地圖上顯示該窗口。用戶可以點擊信息窗口上的關閉按鈕將其從地圖中關閉,開發(fā)人員也可以調用 close() 函數(shù)實現(xiàn)同樣的效果。
方法
方法
返回值
說明
close()
None
關閉此信息窗口,方法是將其從 DOM 結構中刪除。
getContent()
string|Node
getPosition()
LatLng
getZIndex()
number
open(map?:Map|StreetViewPanorama, anchor?:MVCObject)
None
在指定的地圖上打開這個信息窗口。信息窗口可以與錨點相關聯(lián),但這屬于可選操作。在核心 API 中,唯一的錨點是 Marker 類。不過,錨點可以是用于展示位置屬性的任意 MVCObject,也可以是用于計算 pixelOffset 時的可選 anchorPoint(請參見 InfoWindowOptions)。anchorPoint 是從錨點位置到信息窗口頂端的偏移量。
setContent(content:string|Node)
None
setOptions(options:InfoWindowOptions)
None
setPosition(position:LatLng)
None
setZIndex(zIndex:number)
None
事件
事件
參數(shù)
說明
closeclick
None
點擊關閉按鈕時會觸發(fā)此事件。
content_changed
None
內容屬性更改時會觸發(fā)此事件。
domready
None
當包含InfoWindow的內容的
附加到 DOM 時,會觸發(fā)此事件。如果您要動態(tài)構建信息窗口內容,則可能希望監(jiān)視此事件。
position_changed
None
位置屬性更改時會觸發(fā)此事件。
zindex_changed
None
信息窗口的 zIndex 更改時會觸發(fā)此事件。
google.maps.InfoWindowOptions 對象規(guī)范
屬性
屬性
類型
說明
content
string|Node
要在信息窗口中顯示的內容。該內容可以是 HTML 元素、純文本字符串或包含 HTML 的字符串。信息窗口將會根據(jù)相應內容調整大小。要設置內容的具體大小,請將內容設置為相應大小的 HTML 元素。
disableAutoPan
boolean
停用在打開時自動平移的功能。默認情況下,信息窗口會在打開后平移地圖,以便讓自己完全顯示出來。
maxWidth
number
信息窗口的最大寬度(不考慮內容的寬度)。僅在已調用 open 函數(shù)前設置了該值時,才考慮使用這個值。在更改內容時,如果要更改最大寬度,請調用 close 函數(shù)、setOptions 函數(shù),然后調用 open 函數(shù)。
pixelOffset
Size
信息窗口的箭頭距離信息窗口在地圖上所錨定地理坐標點的偏移量(以像素為單位)。如果信息窗口是通過錨點打開的,則從錨點范圍的頂部中心開始計算 pixelOffset。
position
LatLng
用于顯示此信息窗口的 LatLng。如果信息窗口是通過錨點打開的,則使用錨點的位置。
zIndex
number
所有信息窗口按 zIndex 值的大小順序在地圖上顯示,zIndex 值較大的信息窗口顯示在值較小的信息窗口之前。默認情況下,信息窗口是按緯度顯示的,緯度較低的信息窗口顯示在緯度較高的信息窗口前。信息窗口始終在標記前面顯示。
google.maps.Polyline 類
折線是地圖上的連接線段的線性疊加層。此類擴展了MVCObject。
構造函數(shù)
構造函數(shù)
說明
Polyline(opts?:PolylineOptions)
使用傳遞的PolylineOptions創(chuàng)建折線,這些選項可以指定折線的路徑以及繪制折線時要使用的筆觸樣式。您可以在構造折線時傳遞LatLng數(shù)組或LatLng的MVCArray,但在實例化時,簡單的數(shù)組會在折線中轉換為MVCArray。
方法
方法
返回值
說明
getMap()
Map
傳回已附加此折線或多邊形的地圖。
getPath()
MVCArray.
檢索第一條路徑。
setMap(map:Map)
None
在指定地圖上渲染此折線或多邊形。如果地圖設置為 Null,則會刪除此折線或多邊形。
setOptions(options:PolylineOptions)
None
setPath(path:
MVCArray.|
Array.)
None
設置第一條路徑。有關詳細信息,請參見PolylineOptions。
事件
事件
參數(shù)
說明
click
MouseEvent
對折線觸發(fā) DOM click 事件時會觸發(fā)此事件。
dblclick
MouseEvent
對折線觸發(fā) DOM dblclick 事件時會觸發(fā)此事件。
mousedown
MouseEvent
對折線觸發(fā) DOM mousedown 事件時會觸發(fā)此事件。
mousemove
MouseEvent
對折線觸發(fā) DOM mousemove 事件時會觸發(fā)此事件。
mouseout
MouseEvent
此事件針對折線 mouseout 觸發(fā)。
mouseover
MouseEvent
此事件針對折線 mouseover 觸發(fā)。
mouseup
MouseEvent
對折線觸發(fā) DOM mouseup 事件時會觸發(fā)此事件。
rightclick
MouseEvent
右鍵點擊折線時會觸發(fā)此事件。
google.maps.PolylineOptions 對象規(guī)范
屬性
屬性
類型
說明
clickable
boolean
指示此Polyline是否處理click事件。默認值為true。
geodesic
boolean
將每條邊渲染為測地線(“大圓”的一段)。測地線是沿地球表面的兩點之間的最短路徑。
map
Map
要在其上顯示折線的地圖。
path
MVCArray.|
Array.
折線坐標的有序序列??梢允褂靡粋€簡單的LatLng數(shù)組或者LatLng的MVCArray指定此路徑。請注意,如果您傳遞簡單的數(shù)組,則它會轉換為MVCArray。在MVCArray中插入或刪除 LatLng 將自動更新地圖上的折線。
strokeColor
string
筆觸顏色。支持所有 CSS3 顏色,擴展命名的顏色除外。
strokeOpacity
number
介于 0.0 和 1.0 之間的筆觸不透明度
strokeWeight
number
筆觸寬度(以像素為單位)。
zIndex
number
相對于其他折線的 zIndex。
google.maps.Polygon 類
多邊形(類似于折線)可在一個有序序列中定義一系列連接坐標;此外,多邊形會形成一個閉合環(huán)并定義一個填充區(qū)域。此類擴展了MVCObject。
構造函數(shù)
構造函數(shù)
說明
Polygon(opts?:PolygonOptions)
使用傳遞的PolygonOptions創(chuàng)建多邊形,這些選項可以指定多邊形的路徑、多邊形邊緣的筆觸樣式,以及多邊形內部區(qū)域的填充樣式。一個多邊形可以包含一條或多條路徑,其中每條路徑由一個LatLng數(shù)組組成。您可以在構造這些路徑時傳遞一個 LatLng 數(shù)組或LatLng的MVCArray。實例化時,數(shù)組會在多邊形中轉換為MVCArray。
方法
方法
返回值
說明
getMap()
Map
傳回已附加此折線或多邊形的地圖。
getPath()
MVCArray.
檢索第一條路徑。
getPaths()
MVCArray.>
檢索此多邊形的路徑。
setMap(map:Map)
None
在指定地圖上渲染此折線或多邊形。如果地圖設置為 Null,則會刪除此折線或多邊形。
setOptions(options:PolygonOptions)
None
setPath(path:
MVCArray.|
Array.)
None
設置第一條路徑。有關詳細信息,請參見PolylineOptions。
setPaths(paths:
MVCArray.>|
MVCArray.|
Array.>|
Array.)
None
設置此多邊形的路徑。
事件
事件
參數(shù)
說明
click
MouseEvent
對多邊形觸發(fā) DOM click 事件時會觸發(fā)此事件。
dblclick
MouseEvent
對多邊形觸發(fā) DOM dblclick 事件時會觸發(fā)此事件。
mousedown
MouseEvent
對多邊形觸發(fā) DOM mousedown 事件時會觸發(fā)此事件。
mousemove
MouseEvent
對多邊形觸發(fā) DOM mousemove 事件時會觸發(fā)此事件。
mouseout
MouseEvent
此事件針對多邊形 mouseout 觸發(fā)。
mouseover
MouseEvent
此事件針對多邊形 mouseover 觸發(fā)。
mouseup
MouseEvent
對多邊形觸發(fā) DOM mouseup 事件時會觸發(fā)此事件。
rightclick
MouseEvent
右鍵點擊多邊形時會觸發(fā)此事件。
google.maps.PolygonOptions 對象規(guī)范
屬性
屬性
類型
說明
clickable
boolean
指示此Polygon是否處理click事件。默認值為true。
fillColor
string
填充色。支持所有 CSS3 顏色,擴展命名的顏色除外。
fillOpacity
number
介于 0.0 和 1.0 之間的填充不透明度
geodesic
boolean
將每條邊渲染為測地線(“大圓”的一段)。測地線是沿地球表面的兩點之間的最短路徑。
map
Map
要在其上顯示多邊形的地圖。
paths
MVCArray.>|
MVCArray.|
Array.>|
Array.
用于指定閉合環(huán)的坐標的有序序列。不同于折線,一個多邊形由一條或多條路徑組成。因此,路徑屬性可以指定一個或多個LatLng坐標數(shù)組。可以使用一個LatLng數(shù)組定義簡單的多邊形。多個復雜的多邊形可以指定一系列數(shù)組。任何簡單數(shù)組都可以轉換為MVCArray。在MVCArray中插入或刪除LatLng將自動更新地圖上的多邊形。
strokeColor
string
筆觸顏色。支持所有 CSS3 顏色,擴展命名的顏色除外。
strokeOpacity
number
介于 0.0 和 1.0 之間的筆觸不透明度
strokeWeight
number
筆觸寬度(以像素為單位)。
zIndex
number
相對于其他折線的 zIndex。
google.maps.Rectangle 類
矩形疊加層。此類擴展了MVCObject。
構造函數(shù)
構造函數(shù)
說明
Rectangle(opts?:RectangleOptions)
使用傳遞的RectangleOptions(它指定范圍和樣式)創(chuàng)建矩形。
方法
方法
返回值
說明
getBounds()
LatLngBounds
傳回此矩形的范圍。
getMap()
Map
傳回顯示此矩形的地圖。
setBounds(bounds:LatLngBounds)
None
設置此矩形的范圍。
setMap(map:Map)
None
在指定地圖上渲染此矩形。如果地圖設置為 Null,則會刪除此矩形。
se
- 配套講稿:
如PPT文件的首頁顯示word圖標,表示該PPT已包含配套word講稿。雙擊word圖標可打開word文檔。
- 特殊限制:
部分文檔作品中含有的國旗、國徽等圖片,僅作為作品整體效果示例展示,禁止商用。設計者僅對作品中獨創(chuàng)性部分享有著作權。
- 關 鍵 詞:
- googleMapsAPIV3 中文 參考手冊
裝配圖網(wǎng)所有資源均是用戶自行上傳分享,僅供網(wǎng)友學習交流,未經上傳用戶書面授權,請勿作他用。
相關資源
更多
正為您匹配相似的精品文檔
相關搜索
鏈接地址:http://ioszen.com/p-8847233.html