Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Rendering

StreetViewPanorama 类

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

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

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");

构造函数
`StreetViewPanorama`	`StreetViewPanorama(container[, opts])` 参数： `container: HTMLElement` `opts: StreetViewPanoramaOptions optional` 使用传递的 `StreetViewPanoramaOptions` 创建全景图片。

属性
`controls`	类型：`Array<MVCArray<HTMLElement>>` 附加到全景图的其他控件。如需向全景图添加控件，请将控件的 `<div>` 添加到与应呈现该控件的 `ControlPosition` 对应的 `MVCArray`。

方法
`focus`	`focus()` 参数：无返回值：无将焦点设置在此 `StreetViewPanorama` 上。您不妨考虑将此方法与 `visible_changed` 事件搭配使用，以确保在将焦点设置到 `StreetViewPanorama` 之前，该元素是可见的。无法聚焦不可见的 `StreetViewPanorama`。
`getLinks`	`getLinks()` 参数：无返回值：`Array<StreetViewLink optional>\|null` 传回街景视图全景图的导航链接集。
`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])` 参数： `provider: function(string): (StreetViewPanoramaData optional)` `opt_options: PanoProviderOptions optional` 返回值：无设置针对全景图更改调用的自定义全景图提供程序以载入自定义全景图。
`setLinks`	`setLinks(links)` 参数： `links: Array<StreetViewLink>` 返回值：无为街景全景图片设置一组导航链接。
`setMotionTracking`	`setMotionTracking(motionTracking)` 参数： `motionTracking: boolean` 返回值：无设置动作追踪器的状态。如果用户实际移动设备时 `true` 且浏览器支持此功能，则街景全景图片会跟踪实际移动。
`setOptions`	`setOptions(options)` 参数： `options: StreetViewPanoramaOptions optional` 返回值：无设置键值对集合。
`setPano`	`setPano(pano)` 参数： `pano: string` 返回值：无设置街景视图全景图的当前全景图 ID。
`setPosition`	`setPosition(latLng)` 参数： `latLng: LatLng\|LatLngLiteral optional` 返回值：无为街景全景图片设置当前 `LatLng` 位置。
`setPov`	`setPov(pov)` 参数： `pov: StreetViewPov` 返回值：无设置街景视图全景图的视点。
`setVisible`	`setVisible(flag)` 参数： `flag: boolean` 返回值：无设为 `true` 可使全景图片可见。如果设置为 `false`，则无论全景图片是嵌入在地图中还是嵌入在自己的 `<div>` 中，都会被隐藏。
`setZoom`	`setZoom(zoom)` 参数： `zoom: number` 返回值：无设置全景图片的缩放级别。完全缩小时为级别 0，此时视野范围为 180 度。放大操作会提高缩放级别。
继承的方法： `addListener`、`bindTo`、`get`、`notify`、`set`、`setValues`、`unbind`、`unbindAll`

事件
`closeclick`	`function(event)` 参数： `event: Event optional` 事件已触发。当点击关闭按钮时会触发此事件。
`pano_changed`	`function()` 参数：无当全景图的全景图 ID 更改时会触发此事件。当用户浏览全景图时或者当手动设置位置时，全景图会更改。请注意，并非所有位置变化都会触发 `pano_changed`。
`position_changed`	`function()` 参数：无当全景图的位置更改时会触发此事件。当用户浏览全景图时或者当手动设置位置时，位置会改变。
`pov_changed`	`function()` 参数：无当全景图的视点更改时会触发此事件。当倾斜度、缩放或方向更改时，视点会改变。
`resize`	`function()` 参数：无当全景图片的 div 更改大小时，开发者应在全景图片上触发此事件： `google.maps.event.trigger(panorama, 'resize')`。
`status_changed`	`function()` 参数：无每次通过 `setPosition()` 或 `setPano()` 按 ID 或位置查找全景图片后，都会触发此事件。
`visible_changed`	`function()` 参数：无全景图的可见性更改时会触发此事件。当街景小人被拖到地图上、关闭按钮被点击或 `setVisible()` 被调用时，可见性会发生变化。
`zoom_changed`	`function()` 参数：无此事件会在全景图片的缩放级别发生变化时触发。

StreetViewPanoramaOptions 接口

接口 google.maps.StreetViewPanoramaOptions

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

属性
`addressControl` 可选	类型：`boolean optional` 地址控件的启用/停用状态。
`addressControlOptions` 可选	类型：`StreetViewAddressControlOptions optional` 地址控件的显示选项。
`clickToGo` 可选	类型：`boolean optional` 默认值：`true` 点击前往功能的启用/停用状态。不适用于自定义全景图片。
`controlSize` 可选	类型：`number optional` 全景图片上显示的控件的大小（以像素为单位）。此值必须在创建 Panorama 时直接提供，日后更新此值可能会使控件进入未定义状态。仅控制由 Maps API 本身创建的控件。不会缩放开发者创建的自定义控件。
`disableDefaultUI` 可选	类型：`boolean optional` 启用/停用所有默认界面。该属性可以单独进行重写。
`disableDoubleClickZoom` 可选	类型：`boolean optional` 默认值：`true` 启用/停用双击缩放。
`enableCloseButton` 可选	类型：`boolean optional` 默认值：`false` 如果为 `true`，系统会显示关闭按钮。
`fullscreenControl` 可选	类型：`boolean optional` 全屏控件的启用/停用状态。
`fullscreenControlOptions` 可选	类型：`FullscreenControlOptions optional` 全屏控件的显示选项。
`imageDateControl` 可选	类型：`boolean optional` 图像采集日期控件的启用/停用状态。默认情况下，该环境处于停用状态。
`linksControl` 可选	类型：`boolean optional` 链接控件的启用/停用状态。
`motionTracking` 可选	类型：`boolean optional` 动作追踪功能是开启还是关闭。默认情况下，如果动作追踪控件存在，并且用户已授予权限或不需要权限，则该功能处于启用状态，以便 POV（主视角）跟随设备的方向。这主要适用于移动设备。如果 `motionTracking` 设为 `false`，而 `motionTrackingControl` 处于启用状态，则动作追踪控件会显示，但追踪功能处于关闭状态。用户可以点按动作追踪控件来切换此选项。如果 `motionTracking` 设为 `true`，且需要权限但尚未请求权限，则动作追踪控件会显示，但追踪功能处于关闭状态。用户可以点按动作追踪控件来请求权限。如果 `motionTracking` 设置为 `true`，而用户拒绝了权限，则动作追踪控件会显示为停用状态，且追踪功能处于关闭状态。
`motionTrackingControl` 可选	类型：`boolean optional` 动作追踪控件的启用/停用状态。当设备具有动作数据时，默认处于启用状态，以便在地图上显示该控件。这主要适用于移动设备。
`motionTrackingControlOptions` 可选	类型：`MotionTrackingControlOptions optional` 动作追踪控件的显示选项。
`panControl` 可选	类型：`boolean optional` 平移控件的启用/停用状态。
`panControlOptions` 可选	类型：`PanControlOptions optional` 平移控件的显示选项。
`pano` 可选	类型：`string optional` 全景图 ID，应在指定自定义全景图时设置。
`position` 可选	类型：`LatLng\|LatLngLiteral optional` 街景全景图片的 `LatLng` 位置。
`pov` 可选	类型：`StreetViewPov optional` 全景图片的镜头朝向，指定为航向角和俯仰角。
`scrollwheel` 可选	类型：`boolean optional` 默认值：`true` 如果为 `false`，则停用街景中的滚轮缩放功能。
`showRoadLabels` 可选	类型：`boolean optional` 默认值：`true` 全景图上街道名称的显示。如果未指定此值或将其设置为 `true`，则全景图上会显示街道名称。如果设置为 `false`，则不显示街道名称。
`visible` 可选	类型：`boolean optional` 如果为 `true`，则街景全景图片在加载时可见。
`zoom` 可选	类型：`number optional` 全景图片的缩放比例，指定为数字。缩放级别为 0 时，视野范围为 180 度。
`zoomControl` 可选	类型：`boolean optional` 缩放控件的启用/停用状态。
`zoomControlOptions` 可选	类型：`ZoomControlOptions optional` 缩放控件的显示选项。

StreetViewAddressControlOptions 接口

接口 google.maps.StreetViewAddressControlOptions

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

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

PanoProviderOptions 接口

接口 google.maps.PanoProviderOptions

自定义全景图提供方的选项。

属性
`cors` 可选	类型：`boolean optional` 如果设置了此属性，渲染程序将使用仅在所提供图片上正确设置了 CORS 标头时才起作用的技术（例如 WebGL）。开发者需要负责结合使用此标志正确传送图片，否则可能会导致 SecurityError。

StreetViewTileData 接口

接口 google.maps.StreetViewTileData

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

属性
`centerHeading`	类型：`number` 全景图图块中心处的方向（以度为单位）。
`tileSize`	类型：`Size` 图块的渲染大小（以像素为单位）。
`worldSize`	类型：`Size` 整个全景图“世界”的大小（以像素为单位）。

方法
`getTileUrl`	`getTileUrl(pano, tileZoom, tileX, tileY)` 参数： `pano: string` `tileZoom: number` `tileX: number` `tileY: number` 返回值：`string` 获取指定图块的图块图像网址。这是您必须实现的一种自定义方法，用于提供自定义图块。API 会调用此方法，并提供以下参数： `pano` 是街景图块的全景 ID。 `tileZoom` 是图块的缩放级别。 `tileX` 是图块的 x 坐标。 `tileY` 是图块的 y 坐标。您的自定义方法必须返回图块图片的网址。

方法

getTileUrl

getTileUrl(pano, tileZoom, tileX, tileY)

参数：

pano: string
tileZoom: number
tileX: number
tileY: number

返回值：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 类

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

一个图层，用于说明哪些位置可以使用街景。

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");

构造函数
`StreetViewCoverageLayer`	`StreetViewCoverageLayer()` 参数：无创建 `StreetViewCoverageLayer` 的新实例。

方法
`getMap`	`getMap()` 参数：无返回值：`Map\|null` 传回在其上显示此图层的地图。
`setMap`	`setMap(map)` 参数： `map: Map optional` 返回值：`undefined` 在指定地图上渲染此图层。如果地图设置为 null，则系统会移除该图层。
继承的方法： `addListener`、`bindTo`、`get`、`notify`、`set`、`setValues`、`unbind`、`unbindAll`

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