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 将街景搜索范围限制为室外照片集。室内照片集不会显示在搜索结果中。另请注意,搜索只会返回能确定在室内还是室外的全景图片。例如,系统不会返回 PhotoSpheres,因为我们不知道它们是位于室内还是室外。

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 在某会话持续期间保持固定不变,但在各会话之间会改变。