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 度。放大可增加缩放级别。
已继承addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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 界面

自定义全景提供商的选项。

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
返回值undefined
在指定地图上渲染此图层。如果地图设置为 Null,则会删除图层。
已继承addListener, bindTo, get, notify, set, setValues, unbind, unbindAll