Geçerli bir adres veya video kimliği verildiğinde lookupVideoMetadata yöntemi, belirli bir videoyla ilişkili meta verileri döndürür. Yanıt gövdesinde bulunan meta veriler, görüntülerin güncelliğini ve videonun uzunluğunu belirlemenize olanak tanır. Ayrıca videoların varlığını doğrulamak için ücretsiz bir iş akışı sağlar.
API nasıl kullanılır?
Bu uç noktasını, URL kodlamalı bir ABD posta adresi veya videoId göndererek çağırın.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Daha sonra API, aşağıdaki iki yanıttan birini döndürür:
- Video mevcutsa
lookupVideoMetadata, videonun meta verilerini döndürür. - Video mevcut değilse API 404 hata kodu döndürür.
Örnek istek
Aşağıdaki kod örneği, 600 Montgomery St, San Francisco, CA 94111 adresinde bulunan Transamerica Pyramid için havadan görünüm videosu istemektedir.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"
Örnek yanıt
Aşağıdaki JSON örnekleri, lookupVideoMetadata isteğine verilecek tüm olası yanıtları göstermektedir.
Video bulundu
Video zaten oluşturuldu.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"captureDate": {
"year": 2022,
"month": 4,
"day": 1
},
"duration": "40s",
"state": "ACTIVE"
}
Video oluşturuluyor
Video oluşturuluyor.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"state": "PROCESSING"
}
Video bulunamadı
Video, Google'ın veritabanında yer almıyor. Bunun nedeni, henüz oluşturulmamış olması veya konumun desteklenmeyen bir bölgede olması olabilir.
Konum desteklenen bir alandaysa oluşturma isteği başlatmak için renderVideo kullanabilirsiniz.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}