Package google.streetview.publish.v1

索引

• 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
rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse) 删除 Photos 及其元数据的列表。 请注意，如果 BatchDeletePhotos 失败，则表示缺少关键字段或存在身份验证错误。即使 BatchDeletePhotos 成功，批次中的个别照片也可能会失败。这些失败情况在 BatchDeletePhotosResponse.results 中的每个 PhotoResponse.status 中指定。如需了解每张照片可能发生的具体失败情况，请参阅 DeletePhoto。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

BatchGetPhotos
rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse) 获取指定 Photo 批次的元数据。 请注意，如果 BatchGetPhotos 失败，则表示缺少关键字段或存在身份验证错误。即使 BatchGetPhotos 成功，批次中的个别照片也可能会失败。这些失败情况在 BatchGetPhotosResponse.results 中的每个 PhotoResponse.status 中指定。如需了解每张照片可能发生的具体失败情况，请参阅 GetPhoto。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse) 更新 Photos 的元数据，例如姿势、地点关联、连接等。不支持更改照片的像素。 请注意，如果 BatchUpdatePhotos 失败，则表示缺少关键字段或存在身份验证错误。即使 BatchUpdatePhotos 成功，批次中的个别照片也可能会失败。这些失败情况在 BatchUpdatePhotosResponse.results 中的每个 PhotoResponse.status 中指定。如需了解每张照片可能发生的具体失败情况，请参阅 UpdatePhoto。 仅使用 updateMask 字段中指定的字段。如果 updateMask 不存在，则更新适用于所有字段。 BatchUpdatePhotosRequest 中的 UpdatePhotoRequest 消息数量不得超过 20。 注意：要更新 Pose.altitude，还必须填充 Pose.latLngPair。否则，请求将失败。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo) 在客户端使用返回的 UploadRef 上传完照片后，CreatePhoto 会将上传的 Photo 发布到 Google 地图上的街景。 目前，在 CreatePhoto 中设置朝向、倾斜和旋转方向的唯一方法是通过照片字节中的 Photo Sphere XMP 元数据。CreatePhoto 会忽略 Pose 中的 pose.heading、pose.pitch、pose.roll、pose.altitude 和 pose.level 字段。 此方法会返回以下错误代码： 如果请求格式不正确，或者上传的照片不是 360 度全景照片，则为 google.rpc.Code.INVALID_ARGUMENT。 如果上传引用不存在，则返回 google.rpc.Code.NOT_FOUND。 如果账号已达到存储空间上限，请google.rpc.Code.RESOURCE_EXHAUSTED。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation) 在客户端上传完包含返回的 UploadRef 的 PhotoSequence 后，CreatePhotoSequence 会从视频或可扩展设备元数据（XDM，http://www.xdm.org/）中提取一系列 360 度全景照片，并发布到 Google 地图上的街景。 CreatePhotoSequence 会返回一个 Operation，并在 Operation.name 字段中设置了 PhotoSequence ID。 此方法会返回以下错误代码： 如果请求格式有误，则返回 google.rpc.Code.INVALID_ARGUMENT。 如果上传引用不存在，则返回 google.rpc.Code.NOT_FOUND。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

DeletePhoto
rpc DeletePhoto(DeletePhotoRequest) returns (Empty) 删除 Photo 及其元数据。 此方法会返回以下错误代码： 如果发出请求的用户未创建所请求的照片，则返回 google.rpc.Code.PERMISSION_DENIED。 如果带照片 ID 不存在，则返回 google.rpc.Code.NOT_FOUND。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

DeletePhotoSequence
rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty) 删除 PhotoSequence 及其元数据。 此方法会返回以下错误代码： 如果发出请求的用户未创建所请求的照片序列，则返回 google.rpc.Code.PERMISSION_DENIED。 如果照片序列 ID 不存在，则返回 google.rpc.Code.NOT_FOUND。 如果照片序列 ID 尚未完成处理，则为 google.rpc.Code.FAILED_PRECONDITION。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

GetPhoto
rpc GetPhoto(GetPhotoRequest) returns (Photo) 获取指定 Photo 的元数据。 此方法会返回以下错误代码： 如果发出请求的用户未创建所请求的 Photo，则返回 google.rpc.Code.PERMISSION_DENIED。 如果请求的 Photo 不存在，则返回 google.rpc.Code.NOT_FOUND。 如果请求的 Photo 仍在编入索引，则返回 google.rpc.Code.UNAVAILABLE。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation) 通过 Operation 接口获取指定 PhotoSequence 的元数据。 此方法返回以下三种类型的响应： 如果 PhotoSequence 的处理尚未完成，则 Operation.done = false。 Operation.done = true，并且会填充 Operation.error（如果处理过程中出现错误）。 Operation.done = true，并且已捕获 Operation.response，其中包含 PhotoSequence 消息。 此方法会返回以下错误代码： 如果发出请求的用户未创建所请求的 PhotoSequence，则返回 google.rpc.Code.PERMISSION_DENIED。 如果请求的 PhotoSequence 不存在，则返回 google.rpc.Code.NOT_FOUND。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

ListPhotoSequences
rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse) 按 CreatePhotoSequence 时间戳顺序降序列出属于相应用户的所有 PhotoSequences。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

ListPhotos
rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse) 列出属于相应用户的所有 Photos。 注意： 响应中不会返回最近创建但仍在编入索引的照片。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

StartPhotoSequenceUpload
rpc StartPhotoSequenceUpload(Empty) returns (UploadRef) 创建上传会话，以开始上传照片序列数据。返回的 UploadRef 的上传网址用于上传 photoSequence 的数据。 上传完成后，结合使用 UploadRef 与 CreatePhotoSequence 来创建 PhotoSequence 对象条目。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

StartUpload

rpc StartUpload(Empty) returns (UploadRef) 创建上传会话，以开始上传照片字节。该方法使用返回的 UploadRef 的上传网址上传 Photo 的字节。 除了满足 https://support.google.com/maps/answer/7012050?ref_topic=6275604 中所示的照片要求外，照片还必须满足以下要求： Photo Sphere XMP 元数据必须包含在照片元数据中。如需查看必填字段，请参阅 https://developers.google.com/streetview/spherical-metadata。 照片的像素尺寸必须符合 https://support.google.com/maps/answer/7012050?ref_topic=6275604 中列出的尺寸要求，并且照片必须是水平完整的 360 度全景照片。 上传完成后，该方法会将 UploadRef 与 CreatePhoto 结合使用来创建 Photo 对象条目。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo) 更新 Photo 的元数据，例如姿势、地点关联、连接等。不支持更改照片的像素。 仅使用 updateMask 字段中指定的字段。如果 updateMask 不存在，则更新适用于所有字段。 此方法会返回以下错误代码： 如果发出请求的用户未创建所请求的照片，则返回 google.rpc.Code.PERMISSION_DENIED。 如果请求格式有误，则返回 google.rpc.Code.INVALID_ARGUMENT。 如果请求的照片不存在，则返回 google.rpc.Code.NOT_FOUND。 如果请求的 Photo 仍在编入索引，则返回 google.rpc.Code.UNAVAILABLE。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/streetviewpublish 如需了解详情，请参阅 OAuth 2.0 概览。

BatchDeletePhotosRequest

请求删除多个 Photos。

字段
photo_ids[]	string 必需。Photos 的 ID。HTTP GET 请求需要网址查询参数使用以下语法：photoIds=<id1>&photoIds=<id2>&...。

BatchDeletePhotosResponse

对批量删除一个或多个 Photos 的响应。

字段
status[]	Status 在批量请求中删除单个 Photo 的操作的状态。

BatchGetPhotosRequest

请求获取一个或多个 Photos。默认情况下

• 不返回照片字节的下载网址。

参数：

• view 用于控制是否返回照片字节的下载网址。

字段
photo_ids[]	string 必需。Photos 的 ID。对于 HTTP GET 请求，网址查询参数应为 photoIds=<id1>&photoIds=<id2>&...。
view	PhotoView 必需。指定是否应在照片响应中返回照片字节的下载网址。
language_code	string 可选。BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 language_code，则系统会使用用户的 Google 服务语言偏好设置。

BatchGetPhotosResponse

对批量获取 Photos 的响应。

字段
results[]	PhotoResponse 所请求的每个 Photo 的结果列表，与 BatchGetPhotos 中的请求顺序相同。

BatchUpdatePhotosRequest

请求更新照片的元数据。不支持更新照片的像素。

字段
update_photo_requests[]	UpdatePhotoRequest 必需。UpdatePhotoRequests 的列表。

BatchUpdatePhotosResponse

对批量更新一个或多个 Photos 的元数据的响应。

字段
results[]	PhotoResponse 每个 Photo 的结果列表都会更新，且顺序与请求相同。

连接

连接是指从源照片到目标照片的链接。

字段
target	PhotoId 必需。从包含的照片到另一张照片的连接的目的地。

CreatePhotoRequest

请求创建 Photo。

字段
photo	Photo 必需。要创建的照片。

CreatePhotoSequenceRequest

请求根据视频创建 PhotoSequence。

字段
photo_sequence	PhotoSequence 必需。要创建的PhotoSequence。
input_type	InputType 必需。PhotoSequence 的输入形式。

InputType

PhotoSequence 的输入形式。

枚举
INPUT_TYPE_UNSPECIFIED	未指定。服务器将返回 google.rpc.Code.INVALID_ARGUMENT。
VIDEO	360 度全景视频。
XDM	可扩展设备元数据，http://www.xdm.org

DeletePhotoRequest

请求删除 Photo。

字段
photo_id	string 必需。Photo 的 ID。

DeletePhotoSequenceRequest

请求删除 PhotoSequence。

字段
sequence_id	string 必需。PhotoSequence 的 ID。

GetPhotoRequest

请求获取 Photo。

默认情况下

• 不返回照片字节的下载网址。

参数：

• view 用于控制是否返回照片字节的下载网址。

字段
photo_id	string 必需。Photo 的 ID。
view	PhotoView 必需。指定是否应在 Photo 响应中返回照片字节的下载网址。
language_code	string 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	string 必需。照片序列的 ID。
view (deprecated)	PhotoView 此项已弃用！ 指定是否应在 PhotoSequence 响应中单张照片的 download_url 中返回照片序列的下载网址。 注意：目前尚未实现。
filter	string 可选。过滤表达式。例如：published_status=PUBLISHED。 支持的过滤条件包括：published_status。如需了解详情，请参阅 https://google.aip.dev/160。

GpsDataGapFailureDetails

与 ProcessingFailureReason#GPS_DATA_GAP 相关的详细信息。如果存在多个 GPS 数据缺口，则此处仅报告持续时间最长的那一个。

字段
gap_duration	Duration 在 GPS 数据中找到的间隙的时长。
gap_start_time	Duration 间隔开始时的相对时间（从视频流开始算起）。

Imu

来自设备传感器的 IMU 数据。

字段
accel_mpsps[]	Measurement3d 加速度计测量值（以米/秒^2 为单位），并且设备的时间戳会不断增加。
gyro_rps[]	Measurement3d 陀螺仪测量值（以弧度/秒为单位），随着设备的时间戳递增。
mag_ut[]	Measurement3d 磁力计测量的磁场（以微特斯拉 (uT) 为单位）随设备的时间戳不断增加。

3D 效果衡量

通用 3D 测量示例。

字段
capture_time	Timestamp IMU 测量结果的时间戳。
x	float x 轴上的传感器测量值。
y	float y 轴上的传感器测量值。
z	float z 轴上的传感器测量值。

ImuDataGapFailureDetails

与 ProcessingFailureReason#IMU_DATA_GAP 相关的详细信息。如果存在多个 IMU 数据缺口，则此处仅报告持续时间最长的那一个数据缺口。

字段
gap_duration	Duration 在 IMU 数据中找到的间隙持续时间。
gap_start_time	Duration 间隔开始时的相对时间（从视频流开始算起）。

InsufficientGpsFailureDetails

与 ProcessingFailureReason#INSUFFICIENT_GPS 相关的详细信息。

字段
gps_points_found	int32 在视频中找到的 GPS 点的数量。

LatLngBounds

以地理坐标表示的矩形。

字段
southwest	LatLng 这些范围的西南角。
northeast	LatLng 这些范围的东北角。

级别

包含级别号及其对应名称的级别信息。

字段
number	double 可选。楼层号，用于订购。0 表示地平面以上，1 表示地上的第一层，-1 表示地下的第一层。允许使用非整数值。
name	string 必需。为此级别分配的名称，不得超过 3 个字符。思考一下，如果有电梯，该楼层的电梯按钮会如何标示。

ListPhotoSequencesRequest

列出属于发送请求的用户的所有照片序列的请求。

参数：

• pageSize 决定了要返回的照片序列数量上限。
• pageToken 是从上一个 ListPhotoSequences 请求返回的下一页令牌值（如果有）。

字段
page_size	int32 可选。要返回的照片序列数量上限。“pageSize”必须是非负数。如果 pageSize 为零或未提供，则使用默认页面大小 100。如果匹配项数量少于 pageSize，响应中返回的照片序列数量可能会少于 pageSize。此功能目前尚未实施，但正在处理中。
page_token	string 可选。从上一个 ListPhotoSequences 请求返回的 nextPageToken 值（如果有）。
filter	string 可选。过滤表达式。例如：imagery_type=SPHERICAL。 支持的过滤条件包括：imagery_type、processing_state、min_latitude、max_latitude、min_longitude、max_longitude、filename_query、min_capture_time_seconds、“max_capture_time_seconds”。如需了解详情，请参阅 https://google.aip.dev/160。文件名查询应以短语的形式发送，以便通过添加转义引号来支持多个字词和特殊字符。例如：filename_query="词组匹配.mp4 示例"

ListPhotoSequencesResponse

列出属于用户的所有照片序列的响应。

字段
photo_sequences[]	Operation 通过 Operation 接口的照片序列列表。 返回的最大项数取决于请求中的 pageSize 字段。 列表中的每一项都有三种可能的状态， 如果 PhotoSequence 的处理尚未完成，则 Operation.done = false。 Operation.done = true，并且会填充 Operation.error（如果处理过程中出现错误）。 Operation.done = true，并且 Operation.response 包含 PhotoSequence 消息，在每个序列中仅填充 Id。
next_page_token	string 用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。

ListPhotosRequest

请求列出属于发送请求的用户的所有照片。

默认情况下

• 不返回照片字节的下载网址。

参数：

• view 用于控制是否返回照片字节的下载网址。
• pageSize 决定了要返回的照片数量上限。
• pageToken 是从上一个 ListPhotos 请求返回的下一页令牌值（如果有）。
• filter 允许按给定参数进行过滤。“placeId”是目前受支持的唯一参数。

字段
view	PhotoView 必需。指定是否应在相册响应中返回照片字节的下载网址。
page_size	int32 可选。要返回的照片数量上限。“pageSize”必须是非负数。如果 pageSize 为零或未提供，则使用默认页面大小 100。如果属于用户的照片数量少于 pageSize，响应中返回的照片数量可能会少于 pageSize。
page_token	string 可选。从上一个 ListPhotos 请求返回的 nextPageToken 值（如果有）。
filter	string 可选。过滤表达式。例如：placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw。 支持的过滤条件包括：placeId、min_latitude、max_latitude、min_longitude、max_longitude。如需了解详情，请参阅 https://google.aip.dev/160。
language_code	string 可选。BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 language_code，则系统会使用用户的 Google 服务语言偏好设置。

ListPhotosResponse

列出属于某个用户的所有照片的响应。

字段
photos[]	Photo 照片列表。请求中的 pageSize 字段决定了返回的项数。
next_page_token	string 用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。

NoOverlapGpsFailureDetails

与 PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS 相关的详情。

字段
gps_start_time	Timestamp 首次记录到的 GPS 点的时间。
gps_end_time	Timestamp 上次记录 GPS 点的时间。
video_start_time	Timestamp 视频的开始时间。
video_end_time	Timestamp 视频的结束时间。

NotOutdoorsFailureDetails

与 ProcessingFailureReason#NOT_OUTDOORS 相关的详细信息。如果找到多个室内帧，则在此处记录第一帧。

字段
start_time	Duration 找到室内帧时的相对时间（从视频流开始播放开始）。

照片

照片用于存储 360 度全景照片以及照片元数据。

字段
photo_id	PhotoId 必需。仅限输出。更新照片时必填。仅在创建照片时输出。照片的标识符，该标识符在 Google 中的所有照片中是唯一的。
upload_reference	UploadRef 仅限输入。创建照片时必填。仅限输入。上传照片字节的资源网址。
download_url	string 仅限输出。照片字节的下载网址。仅当 GetPhotoRequest.view 设置为 PhotoView.INCLUDE_DOWNLOAD_URL 时，才会设置此字段。
thumbnail_url	string 仅限输出。用于显示指定照片预览的缩略图网址。
share_link	string 仅限输出。照片的分享链接。
pose	Pose 可选。照片姿势。
connections[]	Connection 可选。与其他照片的关联。连接表示从该照片到另一张照片的链接。
capture_time	Timestamp 可选。照片拍摄的绝对时间。如果照片没有 exif 时间戳，系统会使用此时间戳来设置照片元数据中的时间戳。
upload_time	Timestamp 仅限输出。图片的上传时间。
places[]	Place 可选。此照片所属的地点。
view_count	int64 仅限输出。照片的查看次数。
transfer_status	TransferStatus 仅限输出。此照片的权利转移状态。
maps_publish_status	MapsPublishStatus 仅限输出。在 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	string 照片的唯一标识符。

PhotoResponse

批量操作（包括 BatchGetPhotos 和 BatchUpdatePhotos）中的单个 Photo 的响应载荷。

字段
status	Status 用于在批量请求中获取或更新单张照片的操作的状态。
photo	Photo Photo 资源（如果请求成功）。

PhotoSequence

一系列 360 度全景照片以及元数据。

字段
id	string 仅限输出。照片序列的唯一标识符。如果上传是异步执行的，则此 ID 还可用作长时间运行的操作 ID。
photos[]	Photo 仅限输出。时间戳不断增加的照片。
upload_reference	UploadRef 仅限输入。创建照片序列时必填。用于上传照片序列字节（以视频形式）的资源名称。
capture_time_override	Timestamp 可选。开始拍摄照片序列的绝对时间。如果照片序列是一个视频，则这是视频的开始时间。如果在输入中填充此字段，则会替换视频或 XDM 文件中的拍摄时间。
upload_time	Timestamp 仅限输出。在 uSV 商店服务中创建此照片序列的时间。
raw_gps_timeline[]	Pose 仅限输入。未与每张照片同步的设备时间戳的原始 GPS 测量值。这些原始测量值将用于推断每一帧的姿态。当 InputType 为 VIDEO 且原始 GPS 测量不在相机运动元数据跟踪 (CAMM) 中时，输入中必需。如果 raw_gps_timeline 和相机运动元数据跟踪 (CAMM) 中均提供了原始 GPS 测量数据，则用户可以使用 gps_source 指明哪个优先级更高。
gps_source	GpsSource 仅限输入。如果 raw_gps_timeline 和 Camera Motion Metadata Track (CAMM) 都包含 GPS 测量值，请指明哪个优先级更高。
imu	Imu 仅限输入。采集的三轴 IMU 数据。如果这些数据太大而无法在请求中放入，应将其放入视频的 CAMM 轨道中。此类数据始终优先于等效的 CAMM 数据（如果存在）。
processing_state	ProcessingState 仅限输出。此序列的处理状态。
failure_reason	ProcessingFailureReason 仅限输出。如果此序列的 process_state 为 FAILED，则将包含失败的原因。如果 process_state 为任何其他值，此字段将取消设置。
failure_details	ProcessingFailureDetails 仅限输出。如果此序列设置了 failure_reason，可能包含有关失败的更多详细信息。
distance_meters	double 仅限输出。计算出的照片序列距离（以米为单位）。
sequence_bounds	LatLngBounds 仅限输出。用于封装照片序列中所有图片的矩形框。
view_count	int64 仅限输出。此 PhotoSequence 中的所有已发布图片已获得的总浏览次数。
filename	string 仅限输出。上传文件的文件名。不包括目录路径。仅当相应序列是在提供相应文件名的平台上上传时，此字段才可用。

GpsSource

GPS 测量数据的主要来源。

枚举
PHOTO_SEQUENCE	raw_gps_timeline 中存在 GPS（如果存在）优先。
CAMERA_MOTION_METADATA_TRACK	相机运动元数据跟踪 (CAMM) 中的 GPS（如果存在）优先。

PhotoView

指定要包含在响应中的 Photo 的视图。

枚举
BASIC	服务器响应不包含照片字节的下载网址。默认值。
INCLUDE_DOWNLOAD_URL	服务器响应包含照片字节的下载网址。

地点

实体的地点元数据。

字段
place_id	string 地点标识符，如 https://developers.google.com/places/place-id 中所述。
name	string 仅限输出。地点的名称，已本地化为 language_code。
language_code	string 仅限输出。用于对名称进行本地化的 language_code。它应该是请求中指定的 language_code，但也可能是后备值。

姿势

实体的原始姿态测量。

字段
lat_lng_pair	LatLng 位置方向的纬度和经度对，具体说明如下：https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng。创建 Photo 时，如果未提供纬度和经度对，系统会使用 exif 标头中的地理定位。如果照片或 exif 标头中未提供纬度和经度对，则会导致照片处理失败。
altitude	double 位置方向高于 WGS84 椭球体的海拔高度（以米为单位）。NaN 表示未测量的数量。
heading	double 以下姿势参数与照片的中心有关。它们与 https://developers.google.com/streetview/spherical-metadata 相匹配。罗盘航向，在照片中心测量，以与北方所呈顺时针角度表示。值必须大于等于 0 且小于 360。NaN 表示未测量的数量。
pitch	double 俯仰角，在照片中心测量，以度为单位。值必须大于等于 -90 且小于等于 90。值为 -90 表示正向下看，值为 90 表示正向上看。NaN 表示未测量的数量。
roll	double 滚转角，以度为单位。值必须大于等于 0 且小于 360。值为 0 表示与地平线齐平。NaN 表示未测量的数量。
gps_record_timestamp_unix_epoch	Timestamp GPS 记录的时间（从世界协调时间 (UTC) 公元纪年开始）。
level	Level 用于配置垂直导航的楼层（建筑物中的楼层）。
accuracy_meters	float 此姿势的预估水平精确度（以米为单位），置信度为 68%（一个标准差）。例如，在 Android 上，可通过以下方法获得该值：https://developer.android.com/reference/android/location/Location#getAccuracy()。其他平台采用不同的方法来获取类似的准确度估算值。

ProcessingFailureDetails

伴随 ProcessingFailureReason 枚举提供的其他详细信息。此消息应始终与 ProcessingFailureReason 结合使用，并且此消息中设置的其中一个值应与 FailureReason 匹配。

字段
联合字段 details。系统只会设置一组详细信息，并且必须与 ProcessingFailureReason 中的相应枚举匹配。details 只能是下列其中一项：
insufficient_gps_details	InsufficientGpsFailureDetails 请参阅 InfiniteGpsFailureDetails。
gps_data_gap_details	GpsDataGapFailureDetails 请参阅 GpsDataGapFailureDetails。
imu_data_gap_details	ImuDataGapFailureDetails 请参阅 ImuDataGapFailureDetails。
not_outdoors_details	NotOutdoorsFailureDetails 请参阅 NotOutdoorsFailureDetails。
no_overlap_gps_details	NoOverlapGpsFailureDetails 请参阅 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	Photo 必需。包含新元数据的 Photo 对象。
update_mask	FieldMask 必需。用于标识要更新的照片元数据中的字段的掩码。如果不存在，则此请求中的旧 Photo 元数据会被完全替换为新的 Photo 元数据。如果指定了无效字段，更新将失败。可以用逗号分隔列表指定多个字段。 以下字段有效： pose.heading pose.lat_lng_pair pose.pitch pose.roll pose.level pose.altitude connections places 注意：如果 updateMask 包含重复字段，系统会将整组重复值替换为新内容。例如，如果 updateMask 包含 connections 且 UpdatePhotoRequest.photo.connections 为空，则系统会移除所有连接。

UploadRef

媒体文件的上传参考。

字段
联合字段 file_source。必需。file_source 只能是下列其中一项：
upload_url	string 每个用户的上传引用都应该是唯一的。其格式如下：“https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}”