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 的影片，對於待處理影片具有「處理中」狀態，若影片不存在，則會傳回 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 裝置上，用於自動調整位元率串流的 HTTP 即時串流。

RenderVideoRequest

要求訊息給「AerialView.RenderVideo」。

欄位
address	string 必要欄位。要在影片中顯示地點的美國郵政地址。

RenderVideoResponse

AerialView.RenderVideo 的回應訊息。

欄位
state	State 轉譯要求目前的狀態。
metadata	VideoMetadata 包含影片的中繼資料，只有在狀態為 ACTIVE 時才會設定。

烏里斯

內含指定影片格式的所有 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

包含影片的中繼資料，例如影片 ID 和時間長度。

欄位
video_id	string 僅供輸出。影片的 ID，以及擷取影片的建議做法。
capture_date	Date 僅供輸出。影片中使用的圖像拍攝日期。每個月層級的精細程度。
duration	Duration 僅供輸出。影片的長度。
state	State 僅供輸出。轉譯要求目前的狀態。