Method: videos.renderVideo
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اگر ویدئویی قبلا رندر نشده باشد، آدرسی را به صف رندر اضافه می کند. در غیر این صورت، فراداده مربوط به ویدیو را برمی گرداند.
درخواست HTTP
POST https://aerialview.googleapis.com/v1/videos:renderVideo
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"address": string
} |
| فیلدها |
|---|
address | string مورد نیاز. یک آدرس پستی ایالات متحده برای موقعیت مکانی که باید در ویدیو ارائه شود. |
بدن پاسخگو
پیام پاسخ برای AerialView.RenderVideo .
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| فیلدها |
|---|
state | enum ( State ) وضعیت فعلی درخواست رندر. |
metadata | object ( VideoMetadata ) حاوی فراداده ویدیو است، فقط در صورتی تنظیم شود که حالت ACTIVE باشد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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,["# Method: videos.renderVideo\n\n- [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\n### HTTP request\n\n`POST https://aerialview.googleapis.com/v1/videos:renderVideo`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request 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\n### Response body\n\nResponse 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`. |"]]
