有効な住所または動画 ID が指定された場合、lookupVideoMetadata メソッドはその動画に関連付けられたメタデータを返します。レスポンスの本文に含まれるメタデータにより、画像の鮮度と動画の長さを判断できます。また、動画の存在を確認するための無料のワークフローも提供します。
API の使用にあたっての注意事項
このエンドポイントを呼び出すには、URL エンコードされた米国の住所または videoId を渡します。
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
API から次の 2 つのレスポンスのいずれかが返されます。
- 動画が存在する場合、
lookupVideoMetadataは動画のメタデータを返します。 - 動画が存在しない場合、API は 404 エラーコードを返します。
リクエストの例
次のコードサンプルでは、600 Montgomery St, San Francisco, CA 94111 にある Transamerica Pyramid の鳥瞰図動画をリクエストします。
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"
}
}