具備有效的地址或影片 ID,lookupVideoMetadata
方法會傳回與指定影片相關聯的中繼資料。回應主體中的中繼資料可讓您判斷圖像的更新間隔和影片長度,並提供免費的工作流程,可確認影片確實存在。
如何使用 API
如要呼叫這個端點,請將其傳送至網址編碼的美國郵政地址或 videoId
。
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
接著,API 會傳回下列兩個回應之一:
- 如果影片確實存在,
lookupVideoMetadata
會傳回影片的中繼資料。 - 如果影片不存在,API 會傳回 404 錯誤代碼。
要求示例
下列程式碼範例會要求傳遞泛美金字塔的鳥瞰影片,影片位置為 600 Montgomery St, San Francisco, CA 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"
}
}