Mengambil metadata video

Dengan mempertimbangkan alamat atau videoID yang valid, metode lookupVideoMetadata akan menampilkan metadata yang terkait dengan video tertentu. Metadata dalam isi respons memungkinkan Anda menentukan keaktualan gambar, durasi video, dan juga menyediakan alur kerja gratis untuk mengonfirmasi keberadaan video.

Cara menggunakan API

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

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

Kemudian, API akan 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 Piramida Transamerica, yang 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. Hal ini mungkin karena belum dirender, atau karena lokasinya berada di area yang tidak didukung.

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

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