擷取影片的中繼資料

lookupVideoMetadata 方法會在提供有效的地址或 videoID 時，傳回與特定影片相關的中繼資料。回應主體中的中繼資料可讓您判斷圖像的新鮮度、影片長度，並提供免費的工作流程，用於確認影片是否存在。

如何使用 API

請將經過網址編碼的美國郵遞地址或 videoId 傳遞給這個端點，即可呼叫這個端點。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

接著，API 會傳回下列兩種回應之一：

• 如果影片存在，lookupVideoMetadata 會傳回影片的中繼資料。
• 如果影片不存在，API 會傳回 404 錯誤代碼。

要求範例

以下程式碼範例會要求 Transamerica Pyramid 的鳥瞰影片，該建築物位於加州舊金山蒙哥馬利街 600 號，郵遞區號 94111。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

回應範例

以下 JSON 範例說明 lookupVideoMetadata 要求的所有可能回應。

找到影片

影片已算繪完成。

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

影片正在算繪

影片正在算繪中。

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

找不到影片

影片不在 Google 資料庫中。這可能是因為尚未算繪，或是位置位於不支援的區域。

如果位置位於支援區域，您可以使用 renderVideo 啟動轉譯要求。

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}