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 地图上的街景。 目前，在 Create Photo 中设置方向、倾斜度和旋转度的唯一方法是通过照片字节中的 360 度全景照片 XMP 元数据。Create Photo 会忽略姿势中的 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。 如果带照片身份证件不存在，则为 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) 按 Create PhotoSequence 时间戳顺序列出属于用户的所有 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 中显示的照片要求外，照片还必须满足以下要求： 全景照片 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 数据。

字段
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 必需。指定是否应在 Google 相册响应中返回照片字节的下载网址。
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。
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 和相机运动元数据轨道 (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 请参阅 InfullGpsFailureDetails。
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}”