Package google.maps.aerialview.v1

索引

• AerialView（接口）
• LookupVideoMetadataRequest（消息）
• LookupVideoRequest（消息）
• MediaFormat（枚举）
• RenderVideoRequest（消息）
• RenderVideoResponse（消息）
• Uris（消息）
• Video（消息）
• Video.State（枚举）
• VideoMetadata（消息）

AerialView

Aerial View API 的服务定义。

LookupVideo
rpc LookupVideo(LookupVideoRequest) returns (Video) 根据地址或 videoId 获取视频。响应要么是一个视频，其中包含一组有效视频的播放 URI；对于待定视频，响应将是 PROCESSING 状态；如果视频不存在，则会返回 404 错误。接收视频属于计费事件，因此该方法的调用方应在收到请求时准备好使用返回的 URI。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/cloud-platform

LookupVideoMetadata
rpc LookupVideoMetadata(LookupVideoMetadataRequest) returns (VideoMetadata) 根据视频或 videoId 获取视频的元数据。此方法是 LookupVideo 的可自由调用的替代方案，会返回所有可用的视频数据（播放 URI 除外）。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/cloud-platform

RenderVideo
rpc RenderVideo(RenderVideoRequest) returns (RenderVideoResponse) 如果视频尚未渲染，则向渲染程序的队列添加一个地址。否则，返回有关视频的元数据。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/cloud-platform

LookupVideoMetadataRequest

AerialView.LookupVideoMetadata 的请求消息。

字段
联合字段 key。必需。key 只能是下列其中一项：
video_id	string 从 RenderVideo 返回的 ID。
address	string 美国邮政地址。

LookupVideoRequest

AerialView.LookupVideo 的请求消息。

字段
联合字段 key。必需。用于查找视频的键。key 只能是下列其中一项：
video_id	string 从 RenderVideo 返回的 ID。
address	string 美国邮政地址。

MediaFormat

枚举 API 支持的各种媒体格式。

枚举
MEDIA_FORMAT_UNSPECIFIED	默认值。
IMAGE	缩略图。
MP4_HIGH	高品质 MP4 视频。
MP4_MEDIUM	中等质量的 MP4 视频。
MP4_LOW	低画质的 MP4 视频。
DASH	MPEG-DASH，适用于大多数设备上的自适应比特率流式传输。
HLS	适用于 Apple 设备上的自适应比特率流式传输的 HLS。

RenderVideoRequest

AerialView.RenderVideo 的请求消息。

字段
address	string 必需。要在视频中呈现的地点所对应的美国邮政地址。

RenderVideoResponse

AerialView.RenderVideo 的响应消息。

字段
state	State 渲染请求的当前状态。
metadata	VideoMetadata 包含视频的元数据，仅当状态为 ACTIVE 时才会设置。

URI

包含给定视频格式的所有 URI。

字段
landscape_uri	string 屏幕方向为横向的媒体的已签名短期有效 URI。
portrait_uri	string 纵向模式下的媒体的已签名短期有效 URI。

视频

一个对象，用于封装关于视频的所有数据。

字段
uris	map<string, Uris> 媒体类型与其 URI 的映射。只有 ACTIVE 个视频包含此字段。键是 MediaFormat 中的枚举值。
state	State 渲染请求的当前状态。
metadata	VideoMetadata 包含视频的元数据，仅当状态为 ACTIVE 时才会设置。

状态

视频可能处于的不同状态。

枚举
STATE_UNSPECIFIED	默认值。此值未使用。
PROCESSING	该视频目前正在处理中。
ACTIVE	视频已渲染完毕，可通过 LookupVideo 观看。
FAILED	视频呈现失败。

VideoMetadata

包含有关视频的元数据，例如其 videoId 和时长。

字段
video_id	string 仅供输出。视频的 ID，以及推荐的视频检索方式。
capture_date	Date 仅供输出。视频中所用图像的拍摄日期。数据会按月细分。
duration	Duration 仅供输出。视频的长度。
state	State 仅供输出。渲染请求的当前状态。