Rendering

StreetViewPanorama

google.maps.StreetViewPanorama

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

此类扩展 MVCObject

通过调用 const {StreetViewPanorama} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

StreetViewPanorama
StreetViewPanorama(container[, opts])
参数
使用传递的 StreetViewPanoramaOptions 创建全景图片。
controls
附加到全景图的其他控件。若要向全景图片添加控件,请将该控件的 <div> 添加到渲染该 ControlPositionMVCArray 中。
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|null
返回街景全景图片的当前 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
默认true
即点即付的启用/停用状态。不适用于自定义全景图片。
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
在全景图片上显示街道名称。如果未指定该值或设置为 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 提供程序的选项。

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

通过调用 const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

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