renderVideo
敬上
方法會要求製作指定美國的鳥瞰影片
郵寄地址。如果指定的地址已有影片,則
方法會傳回影片的相關中繼資料。
如何使用 API
向
renderVideo
敬上
傳送 API 金鑰和美國郵寄地址,
。轉譯程序可能需要一小時才能完成
有時甚至可能長達數小時
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
要求範例
下列程式碼範例會要求產生 500 W 2nd St, Austin, TX, 78701。
curl -X POST -d '{ "address": "500 W 2nd St, Austin, TX 78701" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
回應範例
下列 JSON 程式碼範例顯示了影片範例的可能回應 請求。
地址回覆無效
地址有誤,或不在美國境內。
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
正在處理回應
Aerial View API 正在轉譯你的影片。回應會包含
videoId
,可用於擷取影片。
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
轉譯程序可能需要一小時到數小時才能完成。如果
影片仍在處理中,你可以使用 lookupVideo
輪詢影片狀態
直到它傳回 ACTIVE
狀態為止
如要進行輪詢,請向 lookupVideo
發出要求,並傳遞 videoId
。算繪可以
可能需要數小時的時間,因此請使用指數
Backoff。
主動回覆
如果 renderVideo
傳回 state
值 ACTIVE
,表示影片
而且只要呼叫 lookupVideo
就能使用
videoId
。
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}