Mengambil metadata video

Dengan alamat atau videoID yang valid, metode lookupVideoMetadata menampilkan metadata yang terkait dengan video tertentu. Metadata dalam isi respons memungkinkan Anda menentukan keaktualan gambar, durasi video, dan juga menyediakan alur kerja bebas 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"

API kemudian menampilkan salah satu dari dua respons berikut:

• Jika video tersebut 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 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 peta 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"
  }
}