קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
השיטה
renderVideo
מבקשת ליצור סרטון של תצלומי אוויר לכתובת הדואר בארה"ב שצוינה. אם הסרטון כבר קיים בכתובת שצוינה, השיטה הזו מחזירה מטא-נתונים על הסרטון.
איך משתמשים ב-API?
כדי ליצור סרטון חדש של תצלומי אוויר, שולחים בקשת HTTPS POST לנקודת הקצה renderVideo, ומעבירים את מפתח ה-API וכתובת דואר בארה"ב, כמו בדוגמה הבאה. תהליך הרינדור יכול להימשך בין שעה לכמה שעות.
תהליך העיבוד יכול להימשך בין שעה לכמה שעות. אם הסרטון עדיין בתהליך עיבוד, אפשר להשתמש ב-lookupVideo כדי לבדוק את סטטוס הסרטון עד שהוא יחזיר את הסטטוס ACTIVE.
אם הפונקציה renderVideo מחזירה את הערך state שהוא ACTIVE, זה אומר שהסרטון סיים את העיבוד ואפשר לאחזר אותו באמצעות קריאה לפונקציה lookupVideo עם הערך videoId.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eThe \u003ccode\u003erenderVideo\u003c/code\u003e method generates aerial view videos for US postal addresses, returning metadata if the video already exists.\u003c/p\u003e\n"],["\u003cp\u003eTo generate a new video, make an HTTPS POST request to the \u003ccode\u003erenderVideo\u003c/code\u003e endpoint with your API key and the US postal address.\u003c/p\u003e\n"],["\u003cp\u003eThe rendering process can take up to a few hours, and the response provides a \u003ccode\u003evideoId\u003c/code\u003e for retrieving the video using \u003ccode\u003elookupVideo\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eWhen the video is ready, \u003ccode\u003erenderVideo\u003c/code\u003e or \u003ccode\u003elookupVideo\u003c/code\u003e will return a state of \u003ccode\u003eACTIVE\u003c/code\u003e, indicating it's available for retrieval.\u003c/p\u003e\n"],["\u003cp\u003eAn invalid address or one outside the US will result in an error response.\u003c/p\u003e\n"]]],[],null,["The\n[`renderVideo`](/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo)\nmethod requests the generation of an aerial view video for the specified US\npostal address. If the video already exists for the specified address, then this\nmethod returns metadata about the video.\n| **Note:** This usage of `renderVideo` assumes that Google hasn't already generated the aerial view video that you need. That is, you need to generate a new aerial view video.\n\nHow to use the API\n\nGenerate a new aerial video by making an HTTPS POST request to the\n[`renderVideo`](/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo)\nendpoint, passing your [API Key](/maps/documentation/aerial-view/get-api-key) and a US postal address, as shown\nin the following example. The rendering process can take anywhere from an hour\nto a few hours.\n**Note:** There is no charge for using this endpoint. \n\n```json\ncurl -X POST -d '{\n \"address\": \"\u003cvar translate=\"no\"\u003ePOSTAL_ADDRESS\u003c/var\u003e\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://aerialview.googleapis.com/v1/videos:renderVideo?key=\u003cvar translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e\"\n```\n\nExample request\n\nThe following code example requests the generation of an aerial view video for\n500 W 2nd St, Austin, TX, 78701. \n\n```json\ncurl -X POST -d '{\n \"address\": \"500 W 2nd St, Austin, TX 78701\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://aerialview.googleapis.com/v1/videos:renderVideo?key=\u003cvar translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e\"\n```\n\nExample response\n\nThe following JSON code samples show the possible responses to the example video\nrequest.\n\nInvalid address response\n\nThe address is either incorrect, or it isn't within the United States. \n\n {\n \"error\": {\n \"code\": 400,\n \"message\": \"Address not supported.\",\n \"status\": \"INVALID_ARGUMENT\"\n }\n }\n\nProcessing response\n\nThe Aerial View API is now rendering your video. The response contains the\n`videoId`, which you can use to retrieve the video. \n\n {\n \"state\": \"PROCESSING\",\n \"metadata\": {\n \"videoId\": \"x89iJAJi1wzs7DIAFQF7Va\"\n }\n }\n\nThe rendering process can take anywhere from an hour to a few hours. If the\nvideo is still processing, you can use `lookupVideo` to poll the video status\nuntil it returns a state of `ACTIVE`.\n\nTo poll, make a request to `lookupVideo`, passing the `videoId`. Rendering can\ntake several hours, so use [exponential\nbackoff](/maps/documentation/aerial-view/web-api-best-practices#exponential-backoff) to space out your calls.\n\nActive response\n\nWhen `renderVideo` returns a `state` value of `ACTIVE`, it means the video has\nfinished rendering, and you can retrieve it by calling `lookupVideo` with the\n`videoId`. \n\n {\n \"state\": \"ACTIVE\",\n \"metadata\": {\n \"videoId\": \"x89iJAJi1wzs7DIAFQF7Va\"\n }\n }"]]
