產生新影片

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"
  }
}