Method: videos.renderVideo
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
在影片尚未算繪的情況下,將地址新增至轉譯器的佇列。如果不是,則傳回影片的相關中繼資料。
HTTP 要求
POST https://aerialview.googleapis.com/v1/videos:renderVideo
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"address": string
} |
欄位 |
address |
string
必要欄位。要在影片中顯示的美國郵政地址。
|
回應主體
對「AerialView.RenderVideo
」的回應訊息。
如果成功,回應主體會含有以下結構的資料:
欄位 |
state |
enum (State )
轉譯要求的目前狀態。
|
metadata |
object (VideoMetadata )
包含影片的中繼資料,僅在狀態為 ACTIVE 時設定。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[[["\u003cp\u003eSends a POST request to render a video of a US postal address using the Aerial View API.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a JSON object with a mandatory "address" field containing the US postal address.\u003c/p\u003e\n"],["\u003cp\u003eThe response indicates the render request status and, if successful, includes video metadata in the response body.\u003c/p\u003e\n"],["\u003cp\u003eIf a video for the given address has already been rendered, the response returns metadata directly without initiating a new render.\u003c/p\u003e\n"]]],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RenderVideoResponse.SCHEMA_REPRESENTATION)\n\nAdds an address to the renderer's queue if a video hasn't already been rendered. Otherwise, returns metadata about the video.\n\nHTTP request\n\n`POST https://aerialview.googleapis.com/v1/videos:renderVideo`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------|\n| ``` { \"address\": string } ``` |\n\n| Fields ||\n|-----------|--------------------------------------------------------------------------------------|\n| `address` | `string` Required. A US postal address for the location to be rendered in the video. |\n\nResponse body Response message for `AerialView.RenderVideo`.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"state\": enum (/maps/documentation/aerial-view/reference/rest/v1/State), \"metadata\": { object (/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata) } } ``` |\n\n| Fields ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `state` | `enum (`[State](/maps/documentation/aerial-view/reference/rest/v1/State)`)` Current state of the render request. |\n| `metadata` | `object (`[VideoMetadata](/maps/documentation/aerial-view/reference/rest/v1/VideoMetadata)`)` Contains the video's metadata, only set if the state is `ACTIVE`. |"]]