Geçerli bir adres veya video kimliği verildiğinde lookupVideoMetadata yöntemi, belirli bir videoyla ilişkili meta verileri döndürür. Şuradaki meta veriler
yanıt gövdesi, görüntülerin güncelliğini, görüntülerin uzunluğunu
video oluşturur ve videoların varlığını doğrulamak için ücretsiz bir iş akışı sunar.
API nasıl kullanılır?
Bu uç noktayı, URL kodlamalı bir ABD posta ileterek çağırın
adres veya
videoId.
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ğinde Transamerica için kuş bakışı bir video istenir 600 Montgomery St, San Francisco, CA 94111 adresinde bulunan Piramit.
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ği.
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 almamaktadır. Bunun nedeni, oluşturulmuş olması veya konum desteklenmeyen bir alanda yer alması olabilir.
Konum, desteklenen bir
alanı kullanarak
renderVideo
işlem isteği gönderir.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}