Rendering

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

StreetViewPanorama

google.maps.StreetViewPanorama

显示指定 LatLng 的全景图片或全景图片 ID。StreetViewPanorama 对象提供街景“查看器”,该查看器可以独立位于单独的 <div> 中,也可以绑定到 Map

此类扩展了 MVCObject

使用 v=beta 时,可通过调用 const {StreetViewPanorama} = await google.map.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

StreetViewPanorama
StreetViewPanorama(container[, opts])
参数
使用传递的 StreetViewPanoramaOptions 创建全景图片。
controls
附加到全景图的其他控件。如需向全景图片添加控件,请将控件的 <div> 添加到与其应渲染到的 ControlPosition 对应的 MVCArray 中。
focus
focus()
参数:无
返回值:无
将焦点转到此 StreetViewPanorama。您不妨考虑结合使用此方法和 visible_changed 事件,以确保 StreetViewPanorama 可见,然后再设置焦点。不可见的 StreetViewPanorama 无法聚焦。
getLocation
getLocation()
参数:无
返回值StreetViewLocation
用于返回当前全景图像的 StreetViewLocation。
getMotionTracking
getMotionTracking()
参数:无
返回值boolean
返回运动跟踪器的状态。如果用户手动移动设备并且浏览器支持 true,那么街景全景图片会跟踪身体的移动。
getPano
getPano()
参数:无
返回值string
传回街景视图全景图的当前全景图 ID。此 ID 仅在浏览器的当前会话中固定不变。
getPhotographerPov
getPhotographerPov()
参数:无
返回值StreetViewPov
返回拍摄此全景图片时摄影师的朝向和倾斜度。对于道路上的街景全景图片,这也能显示汽车行驶的方向。此数据在 pano_changed 事件之后可用。
getPosition
getPosition()
参数:无
返回值LatLng
返回街景全景图片的当前 LatLng 位置。
getPov
getPov()
参数:无
返回值StreetViewPov
传回街景视图全景图的当前视点。
getStatus
getStatus()
参数:无
返回值StreetViewStatus
setPosition()setPano() 请求完成后,返回全景图片的状态。
getVisible
getVisible()
参数:无
返回值boolean
如果全景可见,则返回 true。它不指定在指定的位置是否提供街景视图图像。
getZoom
getZoom()
参数:无
返回值number
用于返回全景图像的缩放级别。完全缩小级别为 0,级别为 180 度。放大会增加缩放级别。
registerPanoProvider
registerPanoProvider(provider[, opt_options])
参数
返回值:无
设置针对全景图更改调用的自定义全景图提供程序以载入自定义全景图。
setMotionTracking
setMotionTracking(motionTracking)
参数
  • motionTrackingboolean
返回值:无
设置运动跟踪器的状态。如果用户手动移动设备并且浏览器支持 true,那么街景全景图片会跟踪身体的移动。
setOptions
setOptions(options)
参数
返回值:无
设置键值对集合。
setPano
setPano(pano)
参数
  • panostring
返回值:无
设置街景视图全景图的当前全景图 ID。
setPosition
setPosition(latLng)
参数
返回值:无
设置街景全景图片的当前 LatLng 位置。
setPov
setPov(pov)
参数
返回值:无
设置街景视图全景图的视点。
setVisible
setVisible(flag)
参数
  • flagboolean
返回值:无
设置为 true 可使全景可见。如果设置为 false,则全景图片将隐藏在地图中或自身的 <div> 中。
setZoom
setZoom(zoom)
参数
  • zoomnumber
返回值:无
设置全景的缩放级别。完全缩小级别为 0,级别为 180 度。放大会增加缩放级别。
继承的设置addListenerbindTogetnotifysetsetValuesunbindunbindAll
closeclick
function(event)
参数
  • eventEvent 触发的事件。
当点击关闭按钮时会触发此事件。
pano_changed
function()
参数:None
当全景图的全景图 ID 更改时会触发此事件。当用户浏览全景图时或者当手动设置位置时,全景图会更改。请注意,并非所有位置变化都会触发 pano_changed
position_changed
function()
参数:None
当全景图的位置更改时会触发此事件。当用户浏览全景图时或者当手动设置位置时,位置会改变。
pov_changed
function()
参数:None
当全景图的视点更改时会触发此事件。当倾斜度、缩放或方向更改时,视点会改变。
resize
function()
参数:None
当全景图片 div 更改大小时,开发者应针对其触发此事件: google.maps.event.trigger(panorama, 'resize')
status_changed
function()
参数:None
在每次通过 ID 或位置查找全景图片后,通过 setPosition()setPano() 会触发此事件。
visible_changed
function()
参数:None
全景图的可见性更改时会触发此事件。将街景小人拖动到地图上、点击关闭按钮或调用 setVisible() 时,可见性会发生变化。
zoom_changed
function()
参数:None
当全景缩放级别更改时会触发此事件。

StreetViewPanoramaOptions 接口

google.maps.StreetViewPanoramaOptions接口

用于定义 StreetViewPanorama 对象的属性的选项。

addressControl optional
类型boolean optional
地址控件的启用/停用状态。
addressControlOptions optional
地址控件的显示选项。
clickToGo optional
类型boolean optional
点击即可启用/已停用的状态。
controlSize optional
类型number optional
控件上显示的像素尺寸。该值必须在创建全景图片时直接提供,稍后更新此值可能会导致控件进入未定义状态。仅控制 Maps API 本身执行的控件。不扩缩开发者创建的自定义控件。
disableDefaultUI optional
类型boolean optional
启用/停用所有默认界面。该属性可以单独进行重写。
disableDoubleClickZoom optional
类型boolean optional
默认true
启用/停用双击缩放。
enableCloseButton optional
类型boolean optional
默认false
如果为 true,系统会显示关闭按钮。
fullscreenControl optional
类型boolean optional
全屏控件的启用/停用状态。
fullscreenControlOptions optional
类型FullscreenControlOptions optional
全屏控件的显示选项。
imageDateControl optional
类型boolean optional
图像获取日期控件的启用/停用状态。默认情况下,该环境处于停用状态。
linksControl optional
类型boolean optional
链接控件的启用/停用状态。
motionTracking optional
类型boolean optional
动作跟踪是处于开启还是关闭状态。当动作跟踪控件存在且用户已授予权限或无需授予权限时,此选项默认处于启用状态,以便 POV(视角)遵循设备的方向。这主要适用于移动设备。如果在启用 motionTrackingControl 的情况下将 motionTracking 设置为 false,系统就会显示动作跟踪控件,但跟踪功能处于关闭状态。用户可以点按动作跟踪控件来切换此选项。如果在需要权限但尚未请求权限时,motionTracking 设为 true,系统就会显示动作跟踪控件,但跟踪功能处于关闭状态。用户可以点按动作跟踪控件来请求权限。如果 motionTracking 设为 true,而用户拒绝授予相应权限,则关闭动作跟踪控件后,跟踪会处于关闭状态。
motionTrackingControl optional
类型boolean optional
动作跟踪控件的启用/停用状态。在设备具有移动数据时默认处于启用状态,以便该控件显示在地图上。这主要适用于移动设备。
motionTrackingControlOptions optional
动作跟踪控件的显示选项。
panControl optional
类型boolean optional
平移控件的启用/停用状态。
panControlOptions optional
类型PanControlOptions optional
平移控件的显示选项。
pano optional
类型string optional
全景图 ID,应在指定自定义全景图时设置。
position optional
类型LatLng|LatLngLiteral optional
街景全景图片 LatLng 的位置。
pov optional
类型StreetViewPov optional
相机方向,以朝向全景的方向和倾斜度指定。
scrollwheel optional
类型boolean optional
默认true
如果为 false,则停用街景中的滚轮缩放功能。
showRoadLabels optional
类型boolean optional
在全景中显示街道名称。如果未指定此值或设为 true,全景图片上会显示街道名称。如果设置为 false,则系统不会显示街道名称。
visible optional
类型boolean optional
如果为 true,则在加载时显示街景全景图片。
zoom optional
类型number optional
以数字形式指定的全景图片缩放比例。缩放级别为 0 时,表示 180 度视野。
zoomControl optional
类型boolean optional
缩放控件的启用/停用状态。
zoomControlOptions optional
类型ZoomControlOptions optional
缩放控件的显示选项。

StreetViewAddressControlOptions 接口

google.maps.StreetViewAddressControlOptions接口

用于渲染街景视图地址控件的选项。

position optional
类型ControlPosition optional
位置 ID。此 ID 用于指定控件在地图上的位置。默认位置为 TOP_LEFT

PanoProviderOptions 接口

google.maps.PanoProviderOptions接口

自定义 Pano Provider 的选项。

cors optional
类型boolean optional
如果设置此参数,渲染程序将使用仅在 cors 标头在提供的图片上正确设置时才适用的技术(如 webgl)。开发者需正确提供此标志并结合使用此标志,否则可能会导致 SecurityErrors。

StreetViewTileData 接口

google.maps.StreetViewTileData接口

在街景视图全景图中使用的图块集的属性。

centerHeading
类型number
全景图图块中心处的方向(以度为单位)。
tileSize
类型Size
图块的渲染大小(以像素为单位)。
worldSize
类型Size
整个全景图“世界”的大小(以像素为单位)。
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
参数
  • panostring
  • tileZoomnumber
  • tileXnumber
  • tileYnumber
返回值string
获取指定图块的图块图像网址。
。您必须实现此自定义方法,才能提供自定义图块。API 会调用此方法并提供下列参数:
pano 是街景图块的全景图片 ID。
tileZoom 是图块的缩放级别。
tileX 是图块的 x 坐标。
tileY 是图块的 Y 坐标。
您的自定义方法必须返回卡片图片的网址。

StreetViewPov 接口

google.maps.StreetViewPov接口

用于指定街景视图全景图位置处镜头方向的视点对象。视角定义为方向和倾斜。

heading
类型number
相对于北方 true 度的相机方向。正北为 0°,正东为 90°,正南为 180°,正西为 270°。
pitch
类型number
相对于街景视图工具的镜头倾斜度(以度为单位)。范围为 90°(朝正上方)到 -90°(朝正下方)。

StreetViewCoverageLayer

google.maps.StreetViewCoverageLayer

表示街景可用位置的图层。

此类扩展了 MVCObject

使用 v=beta 时,可通过调用 const {StreetViewCoverageLayer} = await google.map.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

StreetViewCoverageLayer
StreetViewCoverageLayer()
参数:无
创建 StreetViewCoverageLayer 的新实例。
getMap
getMap()
参数:无
返回值Map
传回在其上显示此图层的地图。
setMap
setMap(map)
参数
返回值:无
在指定地图上渲染此图层。如果地图设置为 null,该图层将被移除。
继承的设置addListenerbindTogetnotifysetsetValuesunbindunbindAll