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 |
将街景搜索限制为户外照片集。室内照片集不会显示在搜索结果中。另请注意,搜索只返回能确定是位于室内还是室外的全景图片。例如,系统不会返回 PhotoSphere,因为我们不了解它们是位于室内还是室外。 |
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 在某会话持续期间保持固定不变,但在各会话之间会改变。 |