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övdesindeki meta veriler, görüntülerin yeniliğini ve videonun uzunluğunu belirlemenize olanak tanır. Ayrıca, videoların varlığını onaylamak için ücretsiz bir iş akışı da sağlar.
API nasıl kullanılır?
URL kodlamalı bir ABD posta adresi veya videoId
geçirerek bu uç noktayı ç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 Piramidi 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 verilebilecek tüm yanıtları göstermektedir.
Video bulundu
Video zaten oluşturulmuş.
{
"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 bulunmuyor. Bunun nedeni konumun henüz oluşturulmaması veya konumun desteklenmeyen bir alanda bulunması olabilir.
Konum desteklenen bir bölgedeyse oluşturma isteği başlatmak için renderVideo
öğesini kullanabilirsiniz.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}