Mengambil metadata video

Dengan alamat atau videoID yang valid, lookupVideoMetadata menampilkan metadata yang terkait dengan video tertentu. {i>Metadata<i} di memungkinkan Anda menentukan keaktualan gambar, panjang respons video, dan juga menyediakan alur kerja gratis untuk mengonfirmasi keberadaan video.

Cara menggunakan API

Panggil endpoint ini dengan meneruskan kode pos AS yang dienkode URL atau videoId

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

API kemudian menampilkan salah satu dari dua respons berikut:

  • Jika video ada, lookupVideoMetadata akan menampilkan metadata video.
  • Jika video tidak ada, API akan menampilkan kode error 404.

Contoh permintaan

Contoh kode berikut meminta video tampilan udara untuk Transamerica Piramida, berlokasi di 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"

Contoh respons

Contoh JSON berikut menunjukkan semua kemungkinan respons terhadap Permintaan lookupVideoMetadata.

Video ditemukan

Video sudah dirender.

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

Video sedang dirender

Video sedang dirender.

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

Video tidak ditemukan

Video tidak ada di database Google. Ini bisa jadi karena belum dirender, atau karena lokasinya berada di area yang tidak didukung.

Jika lokasi berada dalam didukung area, Anda dapat menggunakan renderVideo untuk memulai permintaan render.

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