Mengambil metadata video

Dengan 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 Amerika Serikat 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 Pyramid, yang terletak 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 telah 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 dalam database Google. Hal ini mungkin karena belum dirender, atau karena lokasi 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"
  }
}