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> 添加到与应渲染它的 ControlPosition 相对应的 MVCArray
focus
focus()
参数:无
返回值:None
将焦点设置在此 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])
参数
返回值:None
设置针对全景图更改调用的自定义全景图提供程序以载入自定义全景图。
setMotionTracking
setMotionTracking(motionTracking)
参数
  • motionTrackingboolean
返回值:None
设置动作跟踪器的状态。如果 true,当用户实际移动设备且浏览器支持时,街景全景图片会跟踪用户的身体移动。
setOptions
setOptions(options)
参数
返回值:None
设置键值对集合。
setPano
setPano(pano)
参数
  • panostring
返回值:None
设置街景视图全景图的当前全景图 ID。
setPosition
setPosition(latLng)
参数
返回值:None
设置街景全景图片的当前 LatLng 位置。
setPov
setPov(pov)
参数
返回值:None
设置街景视图全景图的视点。
setVisible
setVisible(flag)
参数
  • flagboolean
返回值:None
设置为 true 可使全景图片可见。如果设置为 false,则全景图片将处于隐藏状态,无论它是嵌入地图还是位于自己的 <div> 中。
setZoom
setZoom(zoom)
参数
  • zoomnumber
返回值:None
设置全景图片的缩放级别。级别 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
每次通过 setPosition()setPano() 按 ID 或位置查找全景图片后,都会触发此事件。
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 接口

自定义全景图片提供程序的选项。

cors optional
类型boolean optional
如果设置了此字段,渲染程序将使用的技术(例如 webgl),仅当在提供的图片上正确设置了 Cors 标头时,这些技术才会起作用。开发者的任务是与此标志结合使用正确提供图像,否则可能会导致 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
返回值:None
在指定地图上渲染此图层。如果地图设置为 Null,则会移除该图层。
继承的样式addListenerbindTogetnotifysetsetValuesunbindunbindAll