Service

StreetViewService

google.maps.StreetViewService

StreetViewService 对象用于搜索街景数据。

通过调用 const {StreetViewService} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

StreetViewService
StreetViewService()
参数:无
创建一个 StreetViewService,用于提供在街景服务中存储的数据的接口。
getPanorama
getPanorama(request[, callback])
参数
检索与提供的街景查询请求匹配的全景图片的 StreetViewPanoramaData。系统会将 StreetViewPanoramaData 传递给提供的回调。

StreetViewStatus 常量

google.maps.StreetViewStatus 常量

完成街景请求时由 StreetViewService 返回的状态。这些参数可以通过值或常量名称来指定。例如 'OK'google.maps.StreetViewStatus.OK

通过调用 const {StreetViewStatus} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

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

StreetViewLocationRequest 接口

google.maps.StreetViewLocationRequest 接口

getPanorama 一起发送的街景请求。StreetViewLocationRequest,可让您搜索指定位置的街景全景图片。

location optional
类型LatLng|LatLngLiteral optional
指定要在其中搜索街景全景图片的位置。
preference optional
类型StreetViewPreference optional
设置偏好设置,确定应在半径范围内查找全景图片:距离指定位置最近的全景图片,还是半径范围内最好的全景图片。
radius optional
类型number optional
默认值50
设置搜索全景图片的半径(以米为单位)。
source optional
类型StreetViewSource optional
指定要搜索的全景图片的来源。这样可以实现限制,例如仅搜索室外全景图片。
sources optional
类型Iterable<StreetViewSource> optional
指定要搜索的全景图片的来源。这样可以实现限制,例如仅搜索室外全景图片。设置多个来源时,系统会视为这些来源的交集。

StreetViewPanoRequest 接口

google.maps.StreetViewPanoRequest 接口

StreetViewPanoRequestgetPanorama 结合使用可查找具有指定 ID 的全景图片。

pano optional
类型string optional
指定要搜索的全景图片 ID。

StreetViewResponse 接口

google.maps.StreetViewResponse 接口

针对来自 StreetViewService.getPanorama 的 Promise 解析的响应。

data
全景图片的表示。

StreetViewLocation 接口

google.maps.StreetViewLocation 接口

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

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

StreetViewPreference 常量

google.maps.StreetViewPreference 常量

这些选项偏向于返回最接近请求位置的街景全景图片,或认为最可能为用户想要看到的全景图片。通过值或使用常量名称来指定这些变量。例如,'best'google.maps.StreetViewPreference.BEST

通过调用 const {StreetViewPreference} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

BEST 返回系统认为最有可能是用户想要看到的街景全景图片。最佳结果由根据用户调查和相关参数(例如识别出的地图注点、图片质量以及与指定位置的距离)为基础的算法确定。
NEAREST 返回距指定位置最短距离的街景全景图片。这只能在一定半径范围内有效。建议半径不超过 1 公里。

StreetViewSource 常量

google.maps.StreetViewSource 常量

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

通过调用 const {StreetViewSource} = await google.maps.importLibrary("streetView") 进行访问。请参阅 Maps JavaScript API 中的库

DEFAULT 使用默认的街景来源,搜索范围不会限于特定来源。
GOOGLE 仅限在 Google 官方集合中搜索街景。
OUTDOOR 将街景搜索限制为户外照片集。室内照片集不会显示在搜索结果中。另请注意,搜索只返回能确定是位于室内还是室外的全景图片。例如,系统不会返回 PhotoSphere,因为我们不了解它们是位于室内还是室外。

StreetViewPanoramaData 接口

google.maps.StreetViewPanoramaData 接口

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

tiles
指定此全景图的自定义图块。
copyright optional
类型string optional
指定此全景图的版权文本。
imageDate optional
类型string optional
指定获取该全景图片中的图像的年份和月份。日期字符串的格式为 YYYY-MM。
location optional
类型StreetViewLocation optional
指定此全景图的位置元数据。

google.maps.StreetViewLink 接口

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

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