索引
StreetViewPublishService
(接口)BatchDeletePhotosRequest
(消息)BatchDeletePhotosResponse
(消息)BatchGetPhotosRequest
(消息)BatchGetPhotosResponse
(消息)BatchUpdatePhotosRequest
(消息)BatchUpdatePhotosResponse
(消息)Connection
(消息)CreatePhotoRequest
(消息)CreatePhotoSequenceRequest
(消息)CreatePhotoSequenceRequest.InputType
(枚举)DeletePhotoRequest
(消息)DeletePhotoSequenceRequest
(消息)GetPhotoRequest
(消息)GetPhotoSequenceRequest
(消息)GpsDataGapFailureDetails
(消息)Imu
(消息)Imu.Measurement3d
(消息)ImuDataGapFailureDetails
(消息)InsufficientGpsFailureDetails
(消息)LatLngBounds
(消息)Level
(消息)ListPhotoSequencesRequest
(消息)ListPhotoSequencesResponse
(消息)ListPhotosRequest
(消息)ListPhotosResponse
(消息)NoOverlapGpsFailureDetails
(消息)NotOutdoorsFailureDetails
(消息)Photo
(消息)Photo.MapsPublishStatus
(枚举)Photo.TransferStatus
(枚举)PhotoId
(消息)PhotoResponse
(消息)PhotoSequence
(消息)PhotoSequence.GpsSource
(枚举)PhotoView
(枚举)Place
(消息)Pose
(消息)ProcessingFailureDetails
(消息)ProcessingFailureReason
(枚举)ProcessingState
(枚举)UpdatePhotoRequest
(消息)UploadRef
(消息)
StreetViewPublishService
在街景上发布和关联用户提供的照片。
BatchDeletePhotos |
---|
删除 请注意,如果
|
BatchGetPhotos |
---|
获取指定的 请注意,如果
|
BatchUpdatePhotos |
---|
更新 请注意,如果 仅使用
|
CreatePhoto |
---|
客户端上传完包含返回 目前,在 Create Photo 中设置方向、倾斜度和旋转度的唯一方法是通过照片字节中的 360 度全景照片 XMP 元数据。Create Photo 会忽略姿势中的 此方法会返回以下错误代码:
|
CreatePhotoSequence |
---|
客户端使用返回的
此方法会返回以下错误代码:
|
DeletePhoto |
---|
删除 此方法会返回以下错误代码:
|
DeletePhotoSequence |
---|
删除 此方法会返回以下错误代码:
|
GetPhoto |
---|
获取指定 此方法会返回以下错误代码:
|
GetPhotoSequence |
---|
通过 此方法会返回以下三种类型的响应:
此方法会返回以下错误代码:
|
ListPhotoSequences |
---|
按 Create PhotoSequence 时间戳顺序列出属于用户的所有
|
ListPhotos |
---|
列出属于用户的所有
|
StartPhotoSequenceUpload |
---|
创建一个上传会话,以开始上传照片序列数据。返回的 上传完成后,使用
|
StartUpload |
---|
创建一个上传会话,以开始上传照片字节。该方法会使用返回的 除了 https://support.google.com/maps/answer/7012050?ref_topic=6275604 中显示的照片要求外,照片还必须满足以下要求:
上传完成后,该方法会使用
|
UpdatePhoto |
---|
更新 系统只会使用 此方法会返回以下错误代码:
|
BatchDeletePhotosRequest
请求删除多个 Photos
。
字段 | |
---|---|
photo_ids[] |
必需。 |
BatchDeletePhotosResponse
对批量删除一个或多个 Photos
的响应。
字段 | |
---|---|
status[] |
用于删除批量请求中的单个 |
BatchGetPhotosRequest
请求获取一个或多个 Photos
。默认情况下
- 不会返回照片字节的下载网址。
参数:
view
用于控制是否返回照片字节的下载网址。
字段 | |
---|---|
photo_ids[] |
必需。 |
view |
必需。指定是否应在照片响应中返回照片字节的下载网址。 |
language_code |
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 language_code,将使用用户的 Google 服务语言偏好设置。 |
BatchGetPhotosResponse
对 Photos
的批量获取的响应。
字段 | |
---|---|
results[] |
请求单个 |
BatchUpdatePhotosRequest
请求更新照片的元数据。不支持更新照片的像素。
字段 | |
---|---|
update_photo_requests[] |
必需。 |
BatchUpdatePhotosResponse
对一个或多个 Photos
的元数据的批量更新的响应。
字段 | |
---|---|
results[] |
更新后的每个 |
连接
连接是指从源照片到目标照片的链接。
字段 | |
---|---|
target |
必需。从包含照片到其他照片的连接的目的地。 |
CreatePhotoRequest
请求创建 Photo
。
字段 | |
---|---|
photo |
必需。要创建的照片。 |
CreatePhotoSequenceRequest
请求通过视频创建 PhotoSequence
。
字段 | |
---|---|
photo_sequence |
必需。 |
input_type |
必需。 |
InputType
PhotoSequence
的输入形式。
枚举 | |
---|---|
INPUT_TYPE_UNSPECIFIED |
未指定。服务器将返回 google.rpc.Code.INVALID_ARGUMENT 。 |
VIDEO |
360 度视频。 |
XDM |
可扩展设备元数据,http://www.xdm.org |
DeletePhotoRequest
请求删除 Photo
。
字段 | |
---|---|
photo_id |
必需。 |
DeletePhotoSequenceRequest
请求删除 PhotoSequence
。
字段 | |
---|---|
sequence_id |
必需。 |
GetPhotoRequest
请求获取 Photo
。
默认情况下
- 不会返回照片字节的下载网址。
参数:
view
用于控制是否返回照片字节的下载网址。
字段 | |
---|---|
photo_id |
必需。 |
view |
必需。指定是否应在 |
language_code |
BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 language_code,将使用用户的 Google 服务语言偏好设置。 |
GetPhotoSequenceRequest
请求获取 PhotoSequence
。
默认情况下
- 不会返回
PhotoSequence
的下载网址。
参数:
view
控制是否返回PhotoSequence
的下载网址。
字段 | |
---|---|
sequence_id |
必需。照片序列的 ID。 |
view |
指定是否应在
|
filter |
可选。过滤器表达式。例如: 支持的过滤条件包括: |
GpsDataGapFailureDetails
与 ProcessingFailureReason#GPS_DATA_GAP 相关的详细信息。如果有多个 GPS 数据缺口,则此处仅报告持续时间最长的那一个。
字段 | |
---|---|
gap_duration |
在 GPS 数据中已发现的间隙的时长。 |
gap_start_time |
间隔开始的相对时间(从视频流开始)。 |
伊姆
来自设备传感器的 IMU 数据。
字段 | |
---|---|
accel_mpsps[] |
加速度计测量单位为米/秒^2,且设备时间戳逐渐增加。 |
gyro_rps[] |
陀螺仪测量结果的弧度/秒随设备时间戳的增加而增加。 |
mag_ut[] |
随着设备的时间戳逐渐增加,磁力计测量的磁场(以微特斯拉 (uT) 为单位)。 |
3D 效果衡量
常规 3D 测量示例。
字段 | |
---|---|
capture_time |
IMU 测量数据的时间戳。 |
x |
x 轴上的传感器测量结果。 |
y |
y 轴上的传感器测量结果。 |
z |
传感器在 z 轴上的测量结果。 |
ImuDataGapFailureDetails
与 ProcessingFailureReason#IMU_DATA_GAP 相关的详细信息。如果存在多个 IMU 数据缺口,此处仅报告持续时间最长的那一个。
字段 | |
---|---|
gap_duration |
已发现 IMU 数据中间隔的时长。 |
gap_start_time |
间隔开始的相对时间(从视频流开始)。 |
InsufficientGpsFailureDetails
与 ProcessingFailureReason#INSUFFICIENT_GPS 相关的详细信息。
字段 | |
---|---|
gps_points_found |
在视频中发现的 GPS 点数量。 |
LatLngBounds
以地理坐标表示的矩形。
字段 | |
---|---|
southwest |
这些边界的西南角。 |
northeast |
这些边界的东北角。 |
级别
包含楼层编号及其相应名称的楼层信息。
字段 | |
---|---|
number |
可选。楼层号,用于下单。0 表示地平面,1 表示高于地平面的第一个楼层,-1 表示地下的第一个楼层。允许使用非整数值。 |
name |
必需。为此级别指定的名称,不得超过 3 个字符。思考如果这个楼层有电梯,应该如何标记电梯按钮。 |
ListPhotoSequencesRequest
请求列出属于发送请求的用户的所有照片序列。
参数:
pageSize
确定要返回的照片序列的最大数量。pageToken
是从上一个ListPhotoSequences
请求返回的下一页令牌值(如果有)。
字段 | |
---|---|
page_size |
可选。要返回的照片序列数量上限。“ |
page_token |
可选。从上一个 |
filter |
可选。过滤器表达式。例如: 支持的过滤条件包括: |
ListPhotoSequencesResponse
对列出属于某个用户的所有照片序列的响应。
字段 | |
---|---|
photo_sequences[] |
通过 返回的最大项数取决于请求中的 列表中的每一项都有三种可能的状态
|
next_page_token |
用于检索下一页结果的令牌。如果列表中没有更多结果,则为空。 |
ListPhotosRequest
请求列出属于发送请求的用户的所有照片。
默认情况下
- 不会返回照片字节的下载网址。
参数:
view
用于控制是否返回照片字节的下载网址。pageSize
确定要返回的照片数量上限。pageToken
是从上一个ListPhotos
请求返回的下一页令牌值(如果有)。filter
允许按给定参数进行过滤。目前,“placeId”是唯一受支持的参数。
字段 | |
---|---|
view |
必需。指定是否应在 Google 相册响应中返回照片字节的下载网址。 |
page_size |
可选。要返回的照片数量上限。“ |
page_token |
可选。从上一个 |
filter |
可选。过滤器表达式。例如: 支持的过滤条件包括: |
language_code |
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 language_code,将使用用户的 Google 服务语言偏好设置。 |
ListPhotosResponse
对列出属于某个用户的所有照片的响应。
字段 | |
---|---|
photos[] |
照片列表。请求中的 |
next_page_token |
用于检索下一页结果的令牌。如果列表中没有更多结果,则为空。 |
NoOverlapGpsFailureDetails
与 PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS 相关的详细信息。
字段 | |
---|---|
gps_start_time |
首次记录 GPS 点的时间。 |
gps_end_time |
上次记录 GPS 点的时间。 |
video_start_time |
视频的开始时间。 |
video_end_time |
视频的结束时间。 |
NotOutdoorsFailureDetails
与 ProcessingFailureReason#NOT_OUTDOORS 相关的详细信息。如果发现多个室内帧,系统会在此处记录第一帧。
字段 | |
---|---|
start_time |
找到室内帧时的相对时间(从视频流开始算起)。 |
照片
照片用于存储 360 度全景照片和照片元数据。
字段 | |
---|---|
photo_id |
必需。仅供输出。更新照片时必填。仅在创建照片时输出。照片的标识符,在 Google 的所有照片中都是唯一的。 |
upload_reference |
仅限输入。创建照片时必填。仅限输入。将照片字节上传到的资源网址。 |
download_url |
仅供输出。照片字节的下载网址。仅当 |
thumbnail_url |
仅供输出。用于显示指定照片预览的缩略图网址。 |
share_link |
仅供输出。照片的分享链接。 |
pose |
可选。照片姿势。 |
connections[] |
可选。与其他照片的关联。连接表示从此照片到其他照片的链接。 |
capture_time |
可选。拍照的绝对时间。如果照片没有 exif 时间戳,此参数用于在照片元数据中设置时间戳。 |
upload_time |
仅供输出。图片上传时间。 |
places[] |
可选。此照片所属的地点。 |
view_count |
仅供输出。照片的查看次数。 |
transfer_status |
仅供输出。此照片的权利转让状态。 |
maps_publish_status |
仅供输出。Google 地图中的状态,指明此照片是已发布还是已被拒。 |
MapsPublishStatus
照片在 Google 地图上的发布状态。
枚举 | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
照片状态未知。 |
PUBLISHED |
照片会通过 Google 地图公开发布。 |
REJECTED_UNKNOWN |
由于未知原因,照片被拒绝。 |
TransferStatus
权利转让的状态。
枚举 | |
---|---|
TRANSFER_STATUS_UNKNOWN |
此转移作业的状态未指定。 |
NEVER_TRANSFERRED |
这张照片从未进行过传输。 |
PENDING |
此照片传输已开始,但接收者尚未回应。 |
COMPLETED |
照片传输已完成,此照片已传输给接收人。 |
REJECTED |
收件人拒绝了此次照片转移。 |
EXPIRED |
在接收者采取任何行动之前,照片转移已过期。 |
CANCELLED |
发送者取消了此次照片转移。 |
RECEIVED_VIA_TRANSFER |
由于权利转让,接收人拥有这张照片。 |
PhotoId
Photo
的标识符。
字段 | |
---|---|
id |
照片的唯一标识符。 |
PhotoResponse
批量操作(包括 BatchGetPhotos
和 BatchUpdatePhotos
)中单个 Photo
的响应载荷。
字段 | |
---|---|
status |
获取或更新批处理请求中单张照片的操作的状态。 |
photo |
|
PhotoSequence
一系列 360 度全景照片及元数据。
字段 | |
---|---|
id |
仅供输出。照片序列的唯一标识符。如果上传操作是以异步方式执行的,这也是一个长时间运行的操作 ID。 |
photos[] |
仅供输出。时间戳逐渐增加的照片。 |
upload_reference |
仅限输入。创建照片序列时必填。用于上传照片序列字节(以视频的形式)的资源名称。 |
capture_time_override |
可选。开始拍摄照片序列的绝对时间。如果照片序列是一个视频,这就是视频的开始时间。如果在输入中填充此字段,则会替换视频或 XDM 文件中的拍摄时间。 |
upload_time |
仅供输出。在 uSV 商店服务中创建此照片序列的时间。 |
raw_gps_timeline[] |
仅限输入。原始 GPS 测量结果,带有增加时间戳(不与每张照片时间同步)的设备。这些原始测量值将用于推断每个帧的姿势。当 InputType 为 VIDEO 且原始 GPS 测量值不在相机运动元数据轨道 (CAMM) 中时,在输入中是必需的。如果同时在 raw_gps_timeline 和相机运动元数据轨道 (CAMM) 中同时提供原始 GPS 测量结果,用户可以使用 gps_source 指示哪个优先级。 |
gps_source |
仅限输入。如果 raw_gps_timeline 和相机运动元数据轨道 (CAMM) 都包含 GPS 测量结果,请指明哪个优先。 |
imu |
仅限输入。采集的三轴 IMU 数据。如果这些数据太大而无法放入请求中,则应将其放入视频的 CAMM 轨道中。此类数据始终优先于对应的 CAMM 数据(如果存在)。 |
processing_state |
仅供输出。此序列的处理状态。 |
failure_reason |
仅供输出。如果此序列的 process_state = FAILED,则它将包含失败原因。如果 process_state 为任何其他值,将取消设置此字段。 |
failure_details |
仅供输出。如果此序列设置了 |
distance_meters |
仅供输出。计算出的照片序列距离(以米为单位)。 |
sequence_bounds |
仅供输出。一个矩形框,用于封装此照片序列中的每张图片。 |
view_count |
仅供输出。此 PhotoSequence 中的所有已发布图片已收到的总查看次数。 |
filename |
仅供输出。上传的文件名。不包含目录路径。仅当序列是在提供文件名的平台上上传的时可用。 |
GpsSource
GPS 测量数据的主要来源。
枚举 | |
---|---|
PHOTO_SEQUENCE |
raw_gps_timeline 中的 GPS 优先(如果存在)。 |
CAMERA_MOTION_METADATA_TRACK |
相机运动元数据轨道 (CAMM) 中的 GPS 优先(如果存在)。 |
PhotoView
指定要包含在响应中的 Photo
视图。
枚举 | |
---|---|
BASIC |
服务器响应不包含照片字节的下载网址。默认值。 |
INCLUDE_DOWNLOAD_URL |
服务器响应包含照片字节的下载网址。 |
地点
实体的地点元数据。
字段 | |
---|---|
place_id |
地点标识符,如 https://developers.google.com/places/place-id 中所述。 |
name |
仅供输出。地点的名称,已本地化为 language_code。 |
language_code |
仅供输出。用于本地化名称的 language_code。这应该是请求中指定的 language_code,但可以是后备值。 |
姿势
实体的原始姿势测量。
字段 | |
---|---|
lat_lng_pair |
姿势的纬度和经度对,具体说明如下:https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng。创建 |
altitude |
WGS84 椭球体上方位置方向的海拔高度(以米为单位)。NaN 表示未测量的数量。 |
heading |
以下姿势参数与照片中心有关。它们与 https://developers.google.com/streetview/spherical-metadata 匹配。罗盘航向,在照片中心测量,以与北方所呈顺时针角度来表示。值必须大于等于 0 且小于 360。NaN 表示未测量的数量。 |
pitch |
俯仰角,在照片中心测量,以度为单位。值必须大于等于 90 且小于等于 90。-90 表示直接俯视,90 表示直接俯视。NaN 表示未测量的数量。 |
roll |
滚转角,以度为单位。值必须大于等于 0 且小于 360。值为 0 表示与地平线平齐。NaN 表示未测量的数量。 |
gps_record_timestamp_unix_epoch |
GPS 记录自 UTC 纪元以来的时间。 |
level |
用于配置垂直导航的楼层(建筑物中的楼层)。 |
accuracy_meters |
此姿势的估算水平精确度(以米为单位),置信度为 68%(一个标准偏差)。例如,在 Android 上,此值可通过以下方法获得:https://developer.android.com/reference/android/location/Location#getAccuracy()。其他平台采用不同的方法来获得类似的准确度估算值。 |
ProcessingFailureDetails
与 ProcessingFailureReason 枚举相关的其他详细信息。此消息应始终与 ProcessingFailureReason 结合使用,并且此消息中设置的其中一个值应与 FailureReason 匹配。
字段 | |
---|---|
联合字段 details 。将仅设置一组详细信息,并且必须与 ProcessingFailureReason 中的相应枚举匹配。details 只能是下列其中一项: |
|
insufficient_gps_details |
请参阅 InfullGpsFailureDetails。 |
gps_data_gap_details |
请参阅 GpsDataGapFailureDetails。 |
imu_data_gap_details |
请参阅 ImuDataGapFailureDetails。 |
not_outdoors_details |
请参阅 NotOutdoorsFailureDetails。 |
no_overlap_gps_details |
请参阅 NoOverlapGpsFailureDetails。 |
ProcessingFailureReason
此 PhotoSequence
处理失败的可能原因。
枚举 | |
---|---|
PROCESSING_FAILURE_REASON_UNSPECIFIED |
失败原因未指定,为默认值。 |
LOW_RESOLUTION |
视频帧的分辨率太小。 |
DUPLICATE |
此视频以前曾上传过。 |
INSUFFICIENT_GPS |
GPS 点太少。 |
NO_OVERLAP_GPS |
GPS 航迹的时间范围与视频的时间范围不能重叠。 |
INVALID_GPS |
GPS 无效(如所有 GPS 点均位于 (0,0)) |
FAILED_TO_REFINE_POSITIONS |
无法在现实世界中准确定位这组照片。 |
TAKEDOWN |
该序列由于政策原因而被移除。 |
CORRUPT_VIDEO |
视频文件损坏或无法解码。 |
INTERNAL |
底层系统发生永久故障。 |
INVALID_VIDEO_FORMAT |
视频格式无效或不受支持。 |
INVALID_VIDEO_DIMENSIONS |
发现图片宽高比无效。 |
INVALID_CAPTURE_TIME |
拍摄时间无效。时间戳为未来时间。 |
GPS_DATA_GAP |
GPS 数据包含的间隙超过 5 秒。 |
JUMPY_GPS |
GPS 数据过于不稳定,无法处理。 |
INVALID_IMU |
IMU(加速度计、陀螺仪等)数据无效。这些表格可能缺少必填字段(x、y、z 或时间),格式可能有误,或有任何其他问题导致系统无法对其进行解析。 |
INSUFFICIENT_IMU |
IMU 点过少。 |
INSUFFICIENT_OVERLAP_TIME_SERIES |
GPS、IMU 和其他时序数据在时间范围的重叠程度不够高。 |
IMU_DATA_GAP |
IMU(加速度计、陀螺仪等)数据包含的间隙大于 0.1 秒。 |
UNSUPPORTED_CAMERA |
摄像头不受支持。 |
NOT_OUTDOORS |
部分画面是室内拍摄的,因此不受支持。 |
INSUFFICIENT_VIDEO_FRAMES |
视频帧数不足。 |
INSUFFICIENT_MOVEMENT |
移动数据不足。 |
ProcessingState
序列的处理状态。状态会按以下方式移动:
+-------------------------+
| |
+---v---+ +----------+ +----+----+
|PENDING+-->PROCESSING+-->PROCESSED|
+---+---+ +----+-----+ +----+----+
| | |
| +--v---+ |
+-------->FAILED<---------+
+------+
序列可以从任何状态变为 FAILED。此外,已处理的序列随时可能重新处理。
枚举 | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
未指定状态,这是默认值。 |
PENDING |
序列尚未开始处理。 |
PROCESSING |
该序列目前正在处理中。 |
PROCESSED |
序列已完成处理,包括优化位置。 |
FAILED |
序列处理失败。如需了解详情,请参阅 FailureReason。 |
UpdatePhotoRequest
请求更新 Photo
的元数据。不支持更新照片的像素。
字段 | |
---|---|
photo |
必需。包含新元数据的 |
update_mask |
必需。用于标识要更新的照片元数据中的字段的遮罩。如果不存在,则此请求中的旧 有效字段如下:
|
UploadRef
媒体文件的上传参考。
字段 | |
---|---|
联合字段 file_source 。必需。file_source 只能是下列其中一项: |
|
upload_url |
每个用户的上传引用应该是唯一的。其格式如下:“https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}” |