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

Service

StreetViewService 类

class google.maps.StreetViewService
library "streetView"

StreetViewService 对象会执行街景数据搜索。

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

构造函数
`StreetViewService`	`StreetViewService()` 参数：无创建 `StreetViewService`，该对象提供了一个连接街景服务内所存储数据的接口。

方法
`getPanorama`	`getPanorama(request[, callback])` 参数： `request: StreetViewLocationRequest\|StreetViewPanoRequest` `callback: function(StreetViewPanoramaData optional, StreetViewStatus): void optional` 返回值：`Promise<StreetViewResponse>` 检索与提供的街景查询请求匹配的全景图片的 `StreetViewPanoramaData`。`StreetViewPanoramaData` 会传递给提供的回调。

StreetViewStatus 常量

常量 google.maps.StreetViewStatus
库 "streetView"

街景请求完成后，StreetViewService 返回的状态。这些值可以按值或使用常量名称来指定。例如 'OK' 或 google.maps.StreetViewStatus.OK。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 StreetViewStatusString 类型定义。

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

常量
`OK`	请求已成功。
`UNKNOWN_ERROR`	无法成功处理请求，但确切的失败原因是未知的。
`ZERO_RESULTS`	未找到符合搜索条件的全景图片。

StreetViewLocationRequest 接口

接口 google.maps.StreetViewLocationRequest

要通过 getPanorama 发送的街景请求。StreetViewLocationRequest 可让您在指定位置搜索街景全景图片。

属性
`location` 可选	类型：`LatLng\|LatLngLiteral optional` 指定要在什么位置搜索街景全景图片。
`preference` 可选	类型：`StreetViewPreference optional` 用于设置偏好设置，确定应在半径范围内查找怎样的全景图片：离指定位置最近的全景图片，还是半径范围内最好的全景图片。
`radius` 可选	类型：`number optional` 默认值：`50` 设置以米为单位的半径，以指定要在多大半径范围内搜索全景图片。
`source` 可选	已弃用：请改用 `sources`。类型：`StreetViewSource optional` 默认值：`StreetViewSource.DEFAULT` 指定要搜索的全景图片来源。例如，这样可以限制为仅搜索室外全景图片。
`sources` 可选	类型：`Iterable<StreetViewSource> optional` 默认值：[`StreetViewSource.DEFAULT`] 指定要搜索的全景图片来源。例如，这样可以限制为仅搜索室外全景图片。设置多个来源将被评估为这些来源的交集。

StreetViewPanoRequest 接口

接口 google.maps.StreetViewPanoRequest

StreetViewPanoRequest 与 getPanorama 结合使用，可查找具有指定 ID 的全景图片。

属性
`pano` 可选	类型：`string optional` 指定要搜索的全景图片 ID。

StreetViewResponse 接口

接口 google.maps.StreetViewResponse

为 StreetViewService.getPanorama 的 Promise 解析的响应。

属性
`data`	类型：`StreetViewPanoramaData` 全景图片的表示形式。

StreetViewLocation 接口

接口 google.maps.StreetViewLocation

街景视图全景图中某个位置的表示。

属性
`pano`	类型：`string` 全景图的唯一标识符。该项在一个会话持续期间内会保持不变，但在各会话之间会有所改变。
`description` 可选	类型：`string optional` 描述位置的本地化字符串。
`latLng` 可选	类型：`LatLng optional` 全景图的纬度/经度。
`shortDescription` 可选	类型：`string optional` 营业地点的简短说明。

StreetViewPreference 常量

常量 google.maps.StreetViewPreference
库 "streetView"

这些选项会影响搜索结果，使其倾向于返回离请求位置最近的街景全景图片，或被认为最可能是用户想要看到的全景图片。按值或使用常量名称指定这些值。例如，'best' 或 google.maps.StreetViewPreference.BEST。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 StreetViewPreferenceString 类型定义。

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

常量
`BEST`	返回被认为最可能是用户想要查看的街景全景图片。最佳结果由算法根据用户调研和各种参数（例如识别出的地图注点、图片质量以及与指定地点的距离）确定。
`NEAREST`	返回与所提供位置距离最短的街景全景图片。这种方法仅在有限的半径范围内有效。建议的半径范围为 1 公里或更小。

StreetViewSource 常量

常量 google.maps.StreetViewSource
库 "streetView"

用于将街景搜索限制为所选来源的标识符。这些值指定为字符串。例如 'outdoor'。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 StreetViewSourceString 类型定义。

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

常量
`DEFAULT`	使用默认街景来源，搜索范围不限于特定来源。
`GOOGLE`	将街景搜索范围限制为 Google 官方全景图片。
`OUTDOOR`	将街景搜索范围限制为室外全景图片。室内图像集不会包含在搜索结果中。另请注意，搜索只会返回可以确定是室内还是室外的全景图片。例如，系统不会返回 PhotoSphere，因为无法确定它们是在室内还是室外。

StreetViewPanoramaData 接口

接口 google.maps.StreetViewPanoramaData

使用 registerPanoProvider 定义的提供程序返回的全景图片的表示。

属性
`tiles`	类型：`StreetViewTileData` 指定此全景图的自定义图块。
`copyright` 可选	类型：`string optional` 指定此全景图的版权文本。
`imageDate` 可选	类型：`string optional` 指定此全景图片中图像的获取年份和月份。日期字符串采用 YYYY-MM 格式。
`links` 可选	类型：`Array<StreetViewLink> optional` 指定相邻全景图的导航链接。
`location` 可选	类型：`StreetViewLocation optional` 指定此全景图的位置元数据。

StreetViewLink 接口

接口 google.maps.StreetViewLink

相邻街景视图全景图的参考集合。

属性
`description` 可选	类型：`string optional` 描述链接的本地化字符串。
`heading` 可选	类型：`number optional` 链接的标题。
`pano` 可选	类型：`string optional` 全景图的唯一标识符。此 ID 在某会话持续期间保持固定不变，但在各会话之间会改变。