谷歌MAPV3 api说明文档详解.docx
- 文档编号:25944451
- 上传时间:2023-06-16
- 格式:DOCX
- 页数:87
- 大小:48.57KB
谷歌MAPV3 api说明文档详解.docx
《谷歌MAPV3 api说明文档详解.docx》由会员分享,可在线阅读,更多相关《谷歌MAPV3 api说明文档详解.docx(87页珍藏版)》请在冰豆网上搜索。
谷歌MAPV3api说明文档详解
窗体底端
∙GoogleMapsJavaScriptAPIV3
∙Map:
oMapOptions
oMapTypeId
oMapTypeControlOptions
oMapTypeControlStyle
oNavigationControlOptions
oNavigationControlStyle
oScaleControlOptions
oScaleControlStyle
oControlPosition
oMapPanes
oMapCanvasProjection
∙Marker:
oMarkerOptions
oMarkerImage
oMarkerShape
∙Polyline:
oPolylineOptions
∙Polygon:
oPolygonOptions
∙InfoWindow:
oInfoWindowOptions
∙Geocoder:
oGeocoderRequest
oGeocoderStatus
oGeocoderResult
oGeocoderAddressComponent
oGeocoderGeometry
oGeocoderLocationType
∙DirectionsRenderer:
oDirectionsRendererOptions
∙DirectionsService:
oDirectionsRequest
oDirectionsTravelMode
oDirectionsUnitSystem
oDirectionsWaypoint
oDirectionsStatus
oDirectionsResult
oDirectionsRoute
oDirectionsLeg
oDirectionsStep
oDirectionsDistance
oDirectionsDuration
∙ElevationService:
oLocationElevationRequest
oPathElevationRequest
oElevationResult
oElevationStatus
∙叠加层和地图类型:
oOverlayView
oMapType
oMapTypeRegistry
oProjection
oImageMapType
oImageMapTypeOptions
oStyledMapType
oStyledMapTypeOptions
oMapTypeStyle
oMapTypeStyleFeatureType
oMapTypeStyleElementType
oMapTypeStyler
oRectangle
oRectangleOptions
oCircle
oCircleOptions
oGroundOverlay
oGroundOverlayOptions
∙图层:
oBicyclingLayer
oFusionTablesLayer
oFusionTablesLayerOptions
oFusionTablesMouseEvent
oFusionTablesCell
oKmlLayer
oKmlLayerOptions
oKmlLayerMetadata
oKmlMouseEvent
oKmlFeatureData
oKmlAuthor
oTrafficLayer
∙街景视图:
oStreetViewPanorama
oStreetViewPanoramaOptions
oStreetViewAddressControlOptions
oStreetViewLink
oStreetViewPov
oStreetViewPanoramaData
oStreetViewLocation
oStreetViewTileData
oStreetViewService
oStreetViewStatus
∙事件:
oMapsEventListener
o事件
oMouseEvent
∙Base:
oLatLng
oLatLngBounds
oPoint
oSize
∙MVC:
oMVCObject
oMVCArray
Map类
此类扩展了MVCObject。
构造函数
构造函数
说明
Map(mapDiv:
Node,opts?
:
MapOptions)
在指定的HTML容器中创建新的地图,该容器通常是一个DIV元素。
方法
方法
返回值
说明
fitBounds(bounds:
LatLngBounds)
None
设置地图,使其与指定范围相符。
getBounds()
LatLngBounds
返回当前视口的纬度/经度范围。
如果还未启动地图(即mapType仍为Null),或者没有设置中心和缩放,则结果为Null。
getCenter()
LatLng
getDiv()
Node
getMapTypeId()
MapTypeId
getProjection()
Projection
传回当前的Projection。
如果还未启动地图(即mapType仍为Null),则结果为Null。
侦听projection_changed并检查它的值以确保它的值不为Null。
getStreetView()
StreetViewPanorama
将默认StreetViewPanorama范围传回到地图,该范围可能是嵌入在地图中的默认全景图,也可能是使用setStreetView()设置的全景图。
对地图的streetViewControl所做的更改将反映在此类范围全景图的显示中。
getZoom()
number
panBy(x:
number,y:
number)
None
将地图中心移动一段指定的距离(以像素为单位)。
如果这段距离既小于地图的宽度,又小于地图的高度,那么移动的动画效果将会十分流畅。
请注意,地图坐标系的x值从西向东增加,y值从北向南增加。
panTo(latLng:
LatLng)
None
将地图中心更改为指定的LatLng。
如果更改幅度既小于地图的宽度,又小于地图的高度,那么移动的动画效果将会十分流畅。
panToBounds(latLngBounds:
LatLngBounds)
None
将地图平移所需的最小距离以包含指定的LatLngBounds。
范围在地图上的位置并不确定,除了尽可能多地显示范围。
范围将定位在由地图类型和导航控件限定的区域内部,但前提是它们出现在地图上。
如果范围大于地图,则地图会移动,以便包括范围的西北角。
如果地图位置的移动幅度既小于地图的宽度,又小于地图的高度,那么移动的动画效果将会十分流畅。
setCenter(latlng:
LatLng)
None
setMapTypeId(mapTypeId:
MapTypeId)
None
setOptions(options:
MapOptions)
None
setStreetView(panorama:
StreetViewPanorama)
None
将StreetViewPanorama绑定到地图。
此全景图将覆盖默认StreetViewPanorama,从而使地图可以绑定到地图外的外部全景图。
将全景图设置为null可将默认的嵌入式全景图绑定回到地图。
setZoom(zoom:
number)
None
属性
属性
类型
说明
controls
Array.
附加到地图的其他控件。
要在地图中添加控件,请将控件的
mapTypes
MapTypeRegistry
按字符串ID划分的MapType实例的注册表。
overlayMapTypes
MVCArray.
要叠加的其他地图类型。
事件
事件
参数
说明
bounds_changed
None
当可视区域范围更改时会触发此事件。
center_changed
None
当地图中心属性更改时会触发此事件。
click
MouseEvent
当用户点击地图(但不是点击标记或信息窗口)时会触发此事件。
dblclick
MouseEvent
当用户双击地图时会触发此事件。
请注意,触发此事件前还会触发点击事件。
drag
None
当用户拖动地图时会反复触发此事件。
dragend
None
当用户停止拖动地图时会触发此事件。
dragstart
None
当用户开始拖动地图时会触发此事件。
idle
None
如果地图在平移或缩放之后变为闲置状态,则会触发此事件。
maptypeid_changed
None
当mapTypeId属性更改时会触发此事件。
mousemove
MouseEvent
只要用户的鼠标在地图容器上移动,就会触发此事件。
mouseout
MouseEvent
当用户的鼠标从地图容器上退出时会触发此事件。
mouseover
MouseEvent
当用户的鼠标进入地图容器时会触发此事件。
projection_changed
None
当投影更改时会触发此事件。
resize
None
当div更改大小时,开发人员应在地图上触发此事件:
google.maps.event.trigger(map,'resize')。
rightclick
MouseEvent
在地图容器中触发DOMcontextmenu事件时会触发此事件。
tilesloaded
None
可见图块载入完成后会触发此事件。
zoom_changed
None
当地图缩放属性更改时会触发此事件。
MapOptions对象规范
属性
属性
类型
说明
backgroundColor
string
用作地图div的背景颜色。
当用户进行平移时,如果尚未载入图块,则显示此颜色。
仅在启动地图时,才能设置此选项。
center
LatLng
初始的地图中心。
必填。
disableDefaultUI
boolean
启用/停用所有默认的用户界面。
该属性可以单独进行重写。
disableDoubleClickZoom
boolean
启用/停用在双击时缩放并居中。
默认情况下处于启用状态。
draggable
boolean
如果为False,则禁止拖动地图。
默认情况下启用拖动。
draggableCursor
string
要在可拖动对象上显示的光标的名称或网址。
draggingCursor
string
要在拖动对象时显示的光标的名称或网址。
keyboardShortcuts
boolean
如果为False,则禁止通过键盘控制地图。
默认情况下启用键盘快捷键。
mapTypeControl
boolean
地图类型控件的初始启用/停用状态。
mapTypeControlOptions
MapTypeControlOptions
地图类型控件的初始显示选项。
mapTypeId
MapTypeId
初始的地图mapTypeId。
必填。
navigationControl
boolean
导航控件的初始启用/停用状态。
navigationControlOptions
NavigationControlOptions
导航控件的初始显示选项。
noClear
boolean
如果为true,则不会清除地图div的内容。
scaleControl
boolean
缩放控件的初始启用/停用状态。
scaleControlOptions
ScaleControlOptions
缩放控件的初始显示选项。
scrollwheel
boolean
如果为False,则停用通过滚轮缩放地图的功能。
默认情况下启用滚轮功能。
streetView
StreetViewPanorama
将街景视图街景小人置于地图上时显示的StreetViewPanorama。
如果未指定全景图,则拖动街景小人时,默认StreetViewPanorama将显示在地图的div中。
streetViewControl
boolean
街景视图街景小人控件的初始启用/停用状态。
zoom
number
初始的地图缩放级别。
必填。
MapTypeId类
常见MapTypes的标识符。
常数
常数
说明
HYBRID
该地图类型显示卫星图像上的主要街道透明层。
ROADMAP
该地图类型显示普通的街道地图。
SATELLITE
该地图类型显示卫星图像。
TERRAIN
该地图类型显示带有自然特征(如地形和植被)的地图。
MapTypeControlOptions对象规范
用于渲染地图类型控件的选项。
属性
属性
类型
说明
mapTypeIds
Array.
要在控件中显示的地图类型的ID。
position
ControlPosition
位置ID。
用于指定控件在地图上的位置。
默认位置为TOP_RIGHT。
style
MapTypeControlStyle
样式ID。
用于选择要显示的地图类型控件的样式。
MapTypeControlStyle类
常见MapTypesControls的标识符。
常数
常数
说明
DEFAULT
使用默认的地图类型控件。
地图默认使用的控件会因窗口大小和其他因素而有所不同。
该控件可能在该API以后的版本中有所更改。
DROPDOWN_MENU
反映屏幕实际使用面积的下拉菜单。
HORIZONTAL_BAR
标准的水平单选按钮栏。
NavigationControlOptions对象规范
用于渲染导航控件的选项。
属性
属性
类型
说明
position
ControlPosition
位置ID。
用于指定控件在地图上的位置。
默认位置为TOP_LEFT。
style
NavigationControlStyle
样式ID。
用于选择要显示的导航控件的样式。
NavigationControlStyle类
导航控件常见类型的标识符。
常数
常数
说明
ANDROID
这是一种小型缩放控件,与Android上的本机地图应用程序所用的控件相似。
DEFAULT
默认的导航控件。
地图默认使用的控件会因窗口大小和其他因素而有所不同。
该控件可能在该API以后的版本中有所更改。
SMALL
只具有缩放功能的小型控件。
ZOOM_PAN
较大控件,具有缩放滑块和平移方向柄。
ScaleControlOptions对象规范
用于渲染比例控件的选项。
属性
属性
类型
说明
position
ControlPosition
位置ID。
用于指定控件在地图上的位置。
默认位置为BOTTOM_LEFT。
style
ScaleControlStyle
样式ID。
用于选择要显示的缩放控件的样式。
ScaleControlStyle类
缩放控件ID的标识符。
常数
常数
说明
DEFAULT
标准缩放控件。
ControlPosition类
用于指定控件在地图上的位置的标识符。
控件相对于同一布局位置中的其他控件而定位。
首先添加的控件将定位在靠近地图边缘的位置。
+---------------+
+ TL T TR+
+ +
+ L R+
+ +
+ +
+ +
+ BL B BR+
+---------------+
顶部或底部行中的元素将向中间流动。
左侧或右侧的元素向下流动。
常数
常数
说明
BOTTOM
元素定位在底部行的中间。
BOTTOM_LEFT
元素定位在左下角并向中间流动。
元素定位在Google徽标的右侧。
BOTTOM_RIGHT
元素定位在右下角并向中间流动。
元素定位在版权的左侧。
LEFT
元素定位在左侧,位于左上角的元素下面,并向下流动。
RIGHT
元素定位在右侧,位于右上角的元素下面,并向下流动。
TOP
元素定位在顶部行的中间。
TOP_LEFT
元素定位在左上角并向中间流动。
TOP_RIGHT
元素定位在右上角并向中间流动。
MapPanes对象规范
此对象包含渲染叠加层的DOM元素。
下面列出了这些元素,底部为“窗格0”,顶部为“窗格6”。
属性
属性
类型
说明
floatPane
Node
此窗格包含信息窗口。
它位于所有地图叠加层之上。
(窗格6)。
floatShadow
Node
此窗格包含信息窗口阴影。
该窗格在overlayImage之上,这样标记便可位于信息窗口的阴影中。
(窗格4)。
mapPane
Node
此窗格是最下面的窗格,位于图块之上。
(窗格0)。
overlayImage
Node
此窗格包含标记前景图像。
(窗格3)。
overlayLayer
Node
此窗格包含折线、多边形、地面叠加层和图块图层叠加层。
(窗格1)。
overlayMouseTarget
Node
此窗格包含透明元素,可接收针对标记的DOM鼠标事件。
该窗格在floatShadow之上,这样便可点击信息窗口阴影中的标记。
(窗格5)。
overlayShadow
Node
此窗格包含标记阴影。
(窗格2)。
MapCanvasProjection对象规范
方法
方法
返回值
说明
fromContainerPixelToLatLng(pixel:
Point)
LatLng
根据地图容器中的像素坐标计算地理坐标。
fromDivPixelToLatLng(pixel:
Point)
LatLng
根据存放可拖动地图的div中的像素坐标计算地理坐标。
fromLatLngToContainerPixel(latLng:
LatLng)
Point
计算地图外部容器的DOM元素中指定地理位置的像素坐标。
fromLatLngToDivPixel(latLng:
LatLng)
Point
计算存放可拖动地图的DOM元素中指定地理位置的像素坐标。
getWorldWidth()
number
当前缩放级别下世界地图的宽度(以像素为单位)。
Marker类
此类扩展了MVCObject。
构造函数
构造函数
说明
Marker(opts?
:
MarkerOptions)
创建带有指定选项的标记。
如果已指定地图,则标记会在构造完成后立即添加到该地图。
请注意,您必须设置标记的显示位置。
方法
方法
返回值
说明
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
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
事件
事件
参数
说明
click
Event
点击标记图标后会触发此事件。
clickable_changed
None
当标记的可点击属性更改时会触发此事件。
cursor_changed
None
当标记的光标属性更改时会触发此事件。
dblclick
Event
当双击标记图标时会触发此事件。
drag
MouseEvent
当用户拖动标记时会反复触发此事件。
dragend
MouseEvent
当用户停止拖动标记时会触发此事件。
draggable_changed
None
当标记的可拖动属性更改时会触发此事件。
dragstart
MouseEvent
当用户开始拖动标记时会触发此事件。
flat_changed
None
当标记的平面属性更改时会触发此事件。
icon_changed
None
当标记图标属性更改时会触发此事件。
mousedown
Event
对标记图标触发DOMmousedown事件时会触发此事件。
mouseout
Event
当鼠标离开标记图标区域时会触发此事件。
mouseover
Event
当鼠标进入标记图标区域时会触发此事件。
mouseup
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 谷歌MAPV3 api说明文档详解 谷歌 MAPV3 api 说明 文档 详解