Method: videos.renderVideo
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإضافة عنوان إلى قائمة انتظار العارض إذا لم يتم عرض الفيديو من قبل. في الحالات الأخرى، سيتم عرض بيانات وصفية حول الفيديو.
طلب HTTP
POST https://aerialview.googleapis.com/v1/videos:renderVideo
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"address": string
} |
| الحقول |
address |
string
مطلوب. تمثّل هذه السمة عنوان بريد في الولايات المتحدة للموقع الجغرافي الذي سيتم عرضه في الفيديو.
|
نص الاستجابة
رسالة ردّ على AerialView.RenderVideo.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
state |
enum (State)
الحالة الحالية لطلب العرض
|
metadata |
object (VideoMetadata)
يتضمن البيانات الوصفية للفيديو، ويتم ضبط الحالة فقط إذا كانت الحالة هي ACTIVE
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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`. |"]]
