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 "
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 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. Hal 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"
}
}