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 用于设置要在什么半径范围内搜索全景图片(以米为单位)。 |
|
类型:
StreetViewSource optional 指定要搜索的全景图片的来源。这样一来,便可以实现限制,例如仅搜索室外全景图片。 |
sources optional |
类型:
Iterable<StreetViewSource> optional 默认值:[
StreetViewSource.DEFAULT ]指定要搜索的全景图片的来源。这样一来,便可以实现限制,例如仅搜索室外全景图片。设置多个来源将被评估为这些来源的交集。 |
StreetViewPanoRequest 接口
google.maps.StreetViewPanoRequest
接口
StreetViewPanoRequest
与 getPanorama
结合使用,以查找具有指定 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。 |
links optional |
类型:
Array<StreetViewLink> optional 指定相邻全景图的导航链接。 |
location optional |
类型:
StreetViewLocation optional 指定此全景图的位置元数据。 |
StreetViewLink 接口
google.maps.StreetViewLink
接口
相邻街景视图全景图的参考集合。
属性 | |
---|---|
description optional |
类型:
string optional 描述链接的本地化字符串。 |
heading optional |
类型:
number optional 链接的标题。 |
pano optional |
类型:
string optional 全景图的唯一标识符。此 ID 在某会话持续期间保持固定不变,但在各会话之间会改变。 |