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 |
类型：
Array<MVCArray<HTMLElement>> |
方法 | |
|---|---|
focus |
focus()参数：无
返回值：None
将焦点设置为此 StreetViewPanorama。您不妨考虑将此方法与 visible_changed 事件搭配使用，以确保在将焦点设置为 StreetViewPanorama 之前，StreetViewPanorama 可见。不可见的 StreetViewPanorama 无法聚焦。 |
getLinks |
getLinks()参数：无
返回值：
Array<StreetViewLink>传回街景视图全景图的导航链接集。 |
getLocation |
getLocation()参数：无
返回值：
StreetViewLocation返回当前全景图的 StreetViewLocation。 |
getMotionTracking |
getMotionTracking()参数：无
返回值：
boolean返回动作跟踪器的状态。如果用户实际移动设备时 true 为 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
设置针对全景图更改调用的自定义全景图提供程序以载入自定义全景图。 |
setLinks |
setLinks(links)参数：
返回值：None
为街景全景图片设置一组导航链接。 |
setMotionTracking |
setMotionTracking(motionTracking)参数：
返回值：None
设置动作跟踪器的状态。如果用户实际移动设备时 true 为 true 且浏览器支持，则街景全景图片会跟踪实际移动。 |
setOptions |
setOptions(options)参数：
返回值：None
设置键值对集合。 |
setPano |
setPano(pano)参数：
返回值：None
设置街景视图全景图的当前全景图 ID。 |
setPosition |
setPosition(latLng)参数：
返回值：None
设置街景全景图片的当前 LatLng 位置。 |
setPov |
setPov(pov)参数：
返回值：None
设置街景视图全景图的视点。 |
setVisible |
setVisible(flag)参数：
返回值：None
设置为 true 可使全景图片可见。如果设置为 false，无论全景图片是嵌入到地图中还是嵌入到自己的 <div> 中，都会被隐藏。 |
setZoom |
setZoom(zoom)参数：
返回值：None
设置全景图的缩放级别。完全放大为级别 0，视野范围为 180 度。放大可增加缩放级别。 |
继承：
addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
事件 | |
|---|---|
closeclick |
function(event)参数：
当点击关闭按钮时会触发此事件。 |
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 |
类型：
StreetViewAddressControlOptions 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）随设备的屏幕方向而变化。这主要适用于移动设备。如果 motionTracking 设为 false，同时 motionTrackingControl 处于启用状态，则系统会显示动作跟踪控件，但跟踪功能处于关闭状态。用户可以点按动作跟踪控件来切换此选项。如果 motionTracking 设置为 true，但需要权限且尚未请求权限，则系统会显示动作跟踪控件，但跟踪功能处于关闭状态。用户可以点按动作跟踪控件来请求权限。如果 motionTracking 设置为 true，但用户拒绝授予权限，动作跟踪控件会显示为已停用，并且跟踪功能会关闭。 |
motionTrackingControl optional |
类型：
boolean optional动作跟踪控件的启用/停用状态。默认情况下，当设备具有动作数据时处于启用状态，以便控件显示在地图上。这主要适用于移动设备。 |
motionTrackingControlOptions 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）。开发者需要结合使用此标志正确地投放图片，否则可能会导致 SecurityError。 |
StreetViewTileData 接口
google.maps.StreetViewTileData 接口
在街景视图全景图中使用的图块集的属性。
属性 | |
|---|---|
centerHeading |
类型：
number全景图图块中心处的方向（以度为单位）。 |
tileSize |
类型：
Size图块的渲染大小（以像素为单位）。 |
worldSize |
类型：
Size整个全景图“世界”的大小（以像素为单位）。 |
方法 | |
|---|---|
getTileUrl |
getTileUrl(pano, tileZoom, tileX, tileY)参数：
返回值：
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)参数：
返回值：
undefined在指定地图上渲染此图层。如果将映射设置为 null，系统会移除图层。 |
继承：
addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |