谷歌MAPV3api說(shuō)明文檔

GoogleMapsJavaScriptAPIV3Map：MapOptionsMapTypeIdMapTypeControlOptionsMapTypeControlStyleNavigationControlOptionsNavigationControlStyleScaleControlOptionsScaleControlStyleControlPositionMapPanesMapCanvasProjectionMarker：MarkerOptionsMarkerImageMarkerShapePolyline：PolylineOptionsPolygon：PolygonOptionsInfoWindow：InfoWindowOptionsGeocoder：GeocoderRequestGeocoderStatusGeocoderResultGeocoderAddressComponentGeocoderGeometryGeocoderLocationTypeDirectionsRenderer：DirectionsRendererOptionsDirectionsService：DirectionsRequestDirectionsTravelModeDirectionsUnitSystemDirectionsWaypointDirectionsStatusDirectionsResultDirectionsRouteDirectionsLegDirectionsStepDirectionsDistanceDirectionsDurationElevationService：LocationElevationRequestPathElevationRequestElevationResultElevationStatus疊加層和地圖類型：OverlayViewMapTypeMapTypeRegistryProjectionImageMapTypeImageMapTypeOptionsStyledMapTypeStyledMapTypeOptionsMapTypeStyleMapTypeStyleFeatureTypeMapTypeStyleElementTypeMapTypeStylerRectangleRectangleOptionsCircleCircleOptionsGroundOverlayGroundOverlayOptions圖層：BicyclingLayerFusionTablesLayerFusionTablesLayerOptionsFusionTablesMouseEventFusionTablesCellKmlLayerKmlLayerOptionsKmlLayerMetadataKmlMouseEventKmlFeatureDataKmlAuthorTrafficLayer街景視圖：StreetViewPanoramaStreetViewPanoramaOptionsStreetViewAddressControlOptionsStreetViewLinkStreetViewPovStreetViewPanoramaDataStreetViewLocationStreetViewTileDataStreetViewServiceStreetViewStatus事件：MapsEventListener事件MouseEventBase：LatLngLatLngBoundsPointSizeMVC：MVCObjectMVCArrayMap類此類擴(kuò)展了MVCObject。構(gòu)造函數(shù)構(gòu)造函數(shù)說(shuō)明Map(mapDiv:Node,opts?:MapOptions)在指定的HTML容器中創(chuàng)建新的地圖，該容器通常是一個(gè)DIV元素。方法方法返回值說(shuō)明fitBounds(bounds:LatLngBounds)None設(shè)置地圖，使其與指定范圍相符。getBounds()LatLngBounds返回當(dāng)前視口的緯度/經(jīng)度范圍。如果還未啟動(dòng)地圖（即mapType仍為Null），或者沒(méi)有設(shè)置中心和縮放，則結(jié)果為Null。getCenter()LatLnggetDiv()NodegetMapTypeId()MapTypeIdgetProjection()Projection傳回當(dāng)前的Projection。如果還未啟動(dòng)地圖（即mapType仍為Null），則結(jié)果為Null。偵聽projection_changed并檢查它的值以確保它的值不為Null。getStreetView()StreetViewPanorama將默認(rèn)StreetViewPanorama范圍傳回到地圖，該范圍可能是嵌入在地圖中的默認(rèn)全景圖，也可能是使用setStreetView()設(shè)置的全景圖。對(duì)地圖的streetViewControl所做的更改將反映在此類范圍全景圖的顯示中。getZoom()numberpanBy(x:number,y:number)None將地圖中心移動(dòng)一段指定的距離（以像素為單位）。如果這段距離既小于地圖的寬度，又小于地圖的高度，那么移動(dòng)的動(dòng)畫效果將會(huì)十分流暢。請(qǐng)注意，地圖坐標(biāo)系的x值從西向東增加，y值從北向南增加。panTo(latLng:LatLng)None將地圖中心更改為指定的LatLng。如果更改幅度既小于地圖的寬度，又小于地圖的高度，那么移動(dòng)的動(dòng)畫效果將會(huì)十分流暢。panToBounds(latLngBounds:LatLngBounds)None將地圖平移所需的最小距離以包含指定的LatLngBounds。范圍在地圖上的位置并不確定，除了盡可能多地顯示范圍。范圍將定位在由地圖類型和導(dǎo)航控件限定的區(qū)域內(nèi)部，但前提是它們出現(xiàn)在地圖上。如果范圍大于地圖，則地圖會(huì)移動(dòng)，以便包括范圍的西北角。如果地圖位置的移動(dòng)幅度既小于地圖的寬度，又小于地圖的高度，那么移動(dòng)的動(dòng)畫效果將會(huì)十分流暢。setCenter(latlng:LatLng)NonesetMapTypeId(mapTypeId:MapTypeId)NonesetOptions(options:MapOptions)NonesetStreetView(panorama:StreetViewPanorama)None將StreetViewPanorama綁定到地圖。此全景圖將覆蓋默認(rèn)StreetViewPanorama，從而使地圖可以綁定到地圖外的外部全景圖。將全景圖設(shè)置為null可將默認(rèn)的嵌入式全景圖綁定回到地圖。setZoom(zoom:number)None屬性屬性類型說(shuō)明controlsArray.<MVCArray.<Node>>附加到地圖的其他控件。要在地圖中添加控件，請(qǐng)將控件的<div>添加到與應(yīng)渲染它的ControlPosition相對(duì)應(yīng)的MVCArray中。mapTypesMapTypeRegistry按字符串ID劃分的MapType實(shí)例的注冊(cè)表。overlayMapTypesMVCArray.<MapType>要疊加的其他地圖類型。事件事件參數(shù)說(shuō)明bounds_changedNone當(dāng)可視區(qū)域范圍更改時(shí)會(huì)觸發(fā)此事件。center_changedNone當(dāng)?shù)貓D中心屬性更改時(shí)會(huì)觸發(fā)此事件。clickMouseEvent當(dāng)用戶點(diǎn)擊地圖（但不是點(diǎn)擊標(biāo)記或信息窗口）時(shí)會(huì)觸發(fā)此事件。dblclickMouseEvent當(dāng)用戶雙擊地圖時(shí)會(huì)觸發(fā)此事件。請(qǐng)注意，觸發(fā)此事件前還會(huì)觸發(fā)點(diǎn)擊事件。dragNone當(dāng)用戶拖動(dòng)地圖時(shí)會(huì)反復(fù)觸發(fā)此事件。dragendNone當(dāng)用戶停止拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。dragstartNone當(dāng)用戶開始拖動(dòng)地圖時(shí)會(huì)觸發(fā)此事件。idleNone如果地圖在平移或縮放之后變?yōu)殚e置狀態(tài)，則會(huì)觸發(fā)此事件。maptypeid_changedNone當(dāng)mapTypeId屬性更改時(shí)會(huì)觸發(fā)此事件。mousemoveMouseEvent只要用戶的鼠標(biāo)在地圖容器上移動(dòng)，就會(huì)觸發(fā)此事件。mouseoutMouseEvent當(dāng)用戶的鼠標(biāo)從地圖容器上退出時(shí)會(huì)觸發(fā)此事件。mouseoverMouseEvent當(dāng)用戶的鼠標(biāo)進(jìn)入地圖容器時(shí)會(huì)觸發(fā)此事件。projection_changedNone當(dāng)投影更改時(shí)會(huì)觸發(fā)此事件。resizeNone當(dāng)div更改大小時(shí)，開發(fā)人員應(yīng)在地圖上觸發(fā)此事件：google.maps.event.trigger(map,'resize')。rightclickMouseEvent在地圖容器中觸發(fā)DOMcontextmenu事件時(shí)會(huì)觸發(fā)此事件。tilesloadedNone可見圖塊載入完成后會(huì)觸發(fā)此事件。zoom_changedNone當(dāng)?shù)貓D縮放屬性更改時(shí)會(huì)觸發(fā)此事件。MapOptions對(duì)象規(guī)范屬性屬性類型說(shuō)明backgroundColorstring用作地圖div的背景顏色。當(dāng)用戶進(jìn)行平移時(shí)，如果尚未載入圖塊，則顯示此顏色。僅在啟動(dòng)地圖時(shí)，才能設(shè)置此選項(xiàng)。centerLatLng初始的地圖中心。必填。disableDefaultUIboolean啟用/停用所有默認(rèn)的用戶界面。該屬性可以單獨(dú)進(jìn)行重寫。disableDoubleClickZoomboolean啟用/停用在雙擊時(shí)縮放并居中。默認(rèn)情況下處于啟用狀態(tài)。draggableboolean如果為False，則禁止拖動(dòng)地圖。默認(rèn)情況下啟用拖動(dòng)。draggableCursorstring要在可拖動(dòng)對(duì)象上顯示的光標(biāo)的名稱或網(wǎng)址。draggingCursorstring要在拖動(dòng)對(duì)象時(shí)顯示的光標(biāo)的名稱或網(wǎng)址。keyboardShortcutsboolean如果為False，則禁止通過(guò)鍵盤控制地圖。默認(rèn)情況下啟用鍵盤快捷鍵。mapTypeControlboolean地圖類型控件的初始啟用/停用狀態(tài)。mapTypeControlOptionsMapTypeControlOptions地圖類型控件的初始顯示選項(xiàng)。mapTypeIdMapTypeId初始的地圖mapTypeId。必填。navigationControlboolean導(dǎo)航控件的初始啟用/停用狀態(tài)。navigationControlOptionsNavigationControlOptions導(dǎo)航控件的初始顯示選項(xiàng)。noClearboolean如果為true，則不會(huì)清除地圖div的內(nèi)容。scaleControlboolean縮放控件的初始啟用/停用狀態(tài)。scaleControlOptionsScaleControlOptions縮放控件的初始顯示選項(xiàng)。scrollwheelboolean如果為False，則停用通過(guò)滾輪縮放地圖的功能。默認(rèn)情況下啟用滾輪功能。streetViewStreetViewPanorama將街景視圖街景小人置于地圖上時(shí)顯示的StreetViewPanorama。如果未指定全景圖，則拖動(dòng)街景小人時(shí)，默認(rèn)StreetViewPanorama將顯示在地圖的div中。streetViewControlboolean街景視圖街景小人控件的初始啟用/停用狀態(tài)。zoomnumber初始的地圖縮放級(jí)別。必填。MapTypeId類常見MapTypes的標(biāo)識(shí)符。常數(shù)常數(shù)說(shuō)明HYBRID該地圖類型顯示衛(wèi)星圖像上的主要街道透明層。ROADMAP該地圖類型顯示普通的街道地圖。SATELLITE該地圖類型顯示衛(wèi)星圖像。TERRAIN該地圖類型顯示帶有自然特征（如地形和植被）的地圖。MapTypeControlOptions對(duì)象規(guī)范用于渲染地圖類型控件的選項(xiàng)。屬性屬性類型說(shuō)明mapTypeIdsArray.<MapTypeId>|Array.<string>要在控件中顯示的地圖類型的ID。positionControlPosition位置ID。用于指定控件在地圖上的位置。默認(rèn)位置為TOP_RIGHT。styleMapTypeControlStyle樣式ID。用于選擇要顯示的地圖類型控件的樣式。MapTypeControlStyle類常見MapTypesControls的標(biāo)識(shí)符。常數(shù)常數(shù)說(shuō)明DEFAULT使用默認(rèn)的地圖類型控件。地圖默認(rèn)使用的控件會(huì)因窗口大小和其他因素而有所不同。該控件可能在該API以后的版本中有所更改。DROPDOWN_MENU反映屏幕實(shí)際使用面積的下拉菜單。HORIZONTAL_BAR標(biāo)準(zhǔn)的水平單選按鈕欄。NavigationControlOptions對(duì)象規(guī)范用于渲染導(dǎo)航控件的選項(xiàng)。屬性屬性類型說(shuō)明positionControlPosition位置ID。用于指定控件在地圖上的位置。默認(rèn)位置為TOP_LEFT。styleNavigationControlStyle樣式ID。用于選擇要顯示的導(dǎo)航控件的樣式。NavigationControlStyle類導(dǎo)航控件常見類型的標(biāo)識(shí)符。常數(shù)常數(shù)說(shuō)明ANDROID這是一種小型縮放控件，與Android上的本機(jī)地圖應(yīng)用程序所用的控件相似。DEFAULT默認(rèn)的導(dǎo)航控件。地圖默認(rèn)使用的控件會(huì)因窗口大小和其他因素而有所不同。該控件可能在該API以后的版本中有所更改。SMALL只具有縮放功能的小型控件。ZOOM_PAN較大控件，具有縮放滑塊和平移方向柄。ScaleControlOptions對(duì)象規(guī)范用于渲染比例控件的選項(xiàng)。屬性屬性類型說(shuō)明positionControlPosition位置ID。用于指定控件在地圖上的位置。默認(rèn)位置為BOTTOM_LEFT。styleScaleControlStyle樣式ID。用于選擇要顯示的縮放控件的樣式。ScaleControlStyle類縮放控件ID的標(biāo)識(shí)符。常數(shù)常數(shù)說(shuō)明DEFAULT標(biāo)準(zhǔn)縮放控件。ControlPosition類用于指定控件在地圖上的位置的標(biāo)識(shí)符?？丶鄬?duì)于同一布局位置中的其他控件而定位。首先添加的控件將定位在靠近地圖邊緣的位置。

+---------------+

+

TL

T

TR+

+

+

+

L

R+

+

+

+

+

+

+

+

BL

B

BR+

+---------------+

頂部或底部行中的元素將向中間流動(dòng)。左側(cè)或右側(cè)的元素向下流動(dòng)。常數(shù)常數(shù)說(shuō)明BOTTOM元素定位在底部行的中間。BOTTOM_LEFT元素定位在左下角并向中間流動(dòng)。元素定位在Google徽標(biāo)的右側(cè)。BOTTOM_RIGHT元素定位在右下角并向中間流動(dòng)。元素定位在版權(quán)的左側(cè)。LEFT元素定位在左側(cè)，位于左上角的元素下面，并向下流動(dòng)。RIGHT元素定位在右側(cè)，位于右上角的元素下面，并向下流動(dòng)。TOP元素定位在頂部行的中間。TOP_LEFT元素定位在左上角并向中間流動(dòng)。TOP_RIGHT元素定位在右上角并向中間流動(dòng)。MapPanes對(duì)象規(guī)范此對(duì)象包含渲染疊加層的DOM元素。下面列出了這些元素，底部為“窗格0”，頂部為“窗格6”。屬性屬性類型說(shuō)明floatPaneNode此窗格包含信息窗口。它位于所有地圖疊加層之上。（窗格6）。floatShadowNode此窗格包含信息窗口陰影。該窗格在overlayImage之上，這樣標(biāo)記便可位于信息窗口的陰影中。（窗格4）。mapPaneNode此窗格是最下面的窗格，位于圖塊之上。（窗格0）。overlayImageNode此窗格包含標(biāo)記前景圖像。（窗格3）。overlayLayerNode此窗格包含折線、多邊形、地面疊加層和圖塊圖層疊加層。（窗格1）。overlayMouseTargetNode此窗格包含透明元素，可接收針對(duì)標(biāo)記的DOM鼠標(biāo)事件。該窗格在floatShadow之上，這樣便可點(diǎn)擊信息窗口陰影中的標(biāo)記。（窗格5）。overlayShadowNode此窗格包含標(biāo)記陰影。（窗格2）。MapCanvasProjection對(duì)象規(guī)范方法方法返回值說(shuō)明fromContainerPixelToLatLng(pixel:Point)LatLng根據(jù)地圖容器中的像素坐標(biāo)計(jì)算地理坐標(biāo)。fromDivPixelToLatLng(pixel:Point)LatLng根據(jù)存放可拖動(dòng)地圖的div中的像素坐標(biāo)計(jì)算地理坐標(biāo)。fromLatLngToContainerPixel(latLng:LatLng)Point計(jì)算地圖外部容器的DOM元素中指定地理位置的像素坐標(biāo)。fromLatLngToDivPixel(latLng:LatLng)Point計(jì)算存放可拖動(dòng)地圖的DOM元素中指定地理位置的像素坐標(biāo)。getWorldWidth()number當(dāng)前縮放級(jí)別下世界地圖的寬度（以像素為單位）。Marker類此類擴(kuò)展了MVCObject。構(gòu)造函數(shù)構(gòu)造函數(shù)說(shuō)明Marker(opts?:MarkerOptions)創(chuàng)建帶有指定選項(xiàng)的標(biāo)記。如果已指定地圖，則標(biāo)記會(huì)在構(gòu)造完成后立即添加到該地圖。請(qǐng)注意，您必須設(shè)置標(biāo)記的顯示位置。方法方法返回值說(shuō)明getClickable()booleangetCursor()stringgetDraggable()booleangetFlat()booleangetIcon()string|MarkerImagegetMap()Map|StreetViewPanoramagetPosition()LatLnggetShadow()string|MarkerImagegetShape()MarkerShapegetTitle()stringgetVisible()booleangetZIndex()numbersetClickable(flag:boolean)NonesetCursor(cursor:string)NonesetDraggable(flag:boolean)NonesetFlat(flag:boolean)NonesetIcon(icon:string|MarkerImage)NonesetMap(map:Map|StreetViewPanorama)None在指定地圖或全景圖上渲染標(biāo)記。如果地圖設(shè)置為Null，則會(huì)刪除此標(biāo)記。setOptions(options:MarkerOptions)NonesetPosition(latlng:LatLng)NonesetShadow(shadow:string|MarkerImage)NonesetShape(shape:MarkerShape)NonesetTitle(title:string)NonesetVisible(visible:boolean)NonesetZIndex(zIndex:number)None事件事件參數(shù)說(shuō)明clickEvent點(diǎn)擊標(biāo)記圖標(biāo)后會(huì)觸發(fā)此事件。clickable_changedNone當(dāng)標(biāo)記的可點(diǎn)擊屬性更改時(shí)會(huì)觸發(fā)此事件。cursor_changedNone當(dāng)標(biāo)記的光標(biāo)屬性更改時(shí)會(huì)觸發(fā)此事件。dblclickEvent當(dāng)雙擊標(biāo)記圖標(biāo)時(shí)會(huì)觸發(fā)此事件。dragMouseEvent當(dāng)用戶拖動(dòng)標(biāo)記時(shí)會(huì)反復(fù)觸發(fā)此事件。dragendMouseEvent當(dāng)用戶停止拖動(dòng)標(biāo)記時(shí)會(huì)觸發(fā)此事件。draggable_changedNone當(dāng)標(biāo)記的可拖動(dòng)屬性更改時(shí)會(huì)觸發(fā)此事件。dragstartMouseEvent當(dāng)用戶開始拖動(dòng)標(biāo)記時(shí)會(huì)觸發(fā)此事件。flat_changedNone當(dāng)標(biāo)記的平面屬性更改時(shí)會(huì)觸發(fā)此事件。icon_changedNone當(dāng)標(biāo)記圖標(biāo)屬性更改時(shí)會(huì)觸發(fā)此事件。mousedownEvent對(duì)標(biāo)記圖標(biāo)觸發(fā)DOMmousedown事件時(shí)會(huì)觸發(fā)此事件。mouseoutEvent當(dāng)鼠標(biāo)離開標(biāo)記圖標(biāo)區(qū)域時(shí)會(huì)觸發(fā)此事件。mouseoverEvent當(dāng)鼠標(biāo)進(jìn)入標(biāo)記圖標(biāo)區(qū)域時(shí)會(huì)觸發(fā)此事件。mouseupEvent對(duì)標(biāo)記觸發(fā)DOMmouseup事件時(shí)會(huì)觸發(fā)此事件。position_changedNone當(dāng)標(biāo)記位置屬性更改時(shí)會(huì)觸發(fā)此事件。rightclickEvent右鍵點(diǎn)擊標(biāo)記時(shí)會(huì)觸發(fā)此事件。shadow_changedNone當(dāng)標(biāo)記的陰影屬性更改時(shí)會(huì)觸發(fā)此事件。shape_changedNone當(dāng)標(biāo)記的形狀屬性更改時(shí)會(huì)觸發(fā)此事件。title_changedNone當(dāng)標(biāo)記名稱屬性更改時(shí)會(huì)觸發(fā)此事件。visible_changedNone當(dāng)標(biāo)記的可見屬性更改時(shí)會(huì)觸發(fā)此事件。zindex_changedNone當(dāng)標(biāo)記的zIndex屬性更改時(shí)會(huì)觸發(fā)此事件。MarkerOptions對(duì)象規(guī)范屬性屬性類型說(shuō)明clickableboolean如果為true，則標(biāo)記會(huì)收到鼠標(biāo)事件和觸摸事件。默認(rèn)值為true。cursorstring鼠標(biāo)懸停時(shí)顯示的光標(biāo)。draggableboolean如果為true，則可拖動(dòng)標(biāo)記。默認(rèn)值為false。flatboolean如果為true，則不會(huì)顯示標(biāo)記陰影。iconstring|MarkerImage前景的圖標(biāo)mapMap|StreetViewPanorama待顯示標(biāo)記的地圖。positionLatLng標(biāo)記位置。必填。shadowstring|MarkerImage陰影圖像shapeMarkerShape用于拖動(dòng)/點(diǎn)擊的圖像地圖區(qū)域定義。titlestring滾動(dòng)文本visibleboolean如果為true，則顯示標(biāo)記。zIndexnumber所有標(biāo)記按其zIndex值的大小順序在地圖上顯示，zIndex值較大的標(biāo)記顯示在值較小的標(biāo)記之前。默認(rèn)情況下，標(biāo)記是按緯度顯示的，緯度較低的標(biāo)記顯示在緯度較高的標(biāo)記前。MarkerImage類構(gòu)造函數(shù)構(gòu)造函數(shù)說(shuō)明MarkerImage(url:string,size?:Size,origin?:HYPERLINK"/intl/zh-CN/apis/maps/documentation/javascript/reference.