Bir videonun meta verilerini alma

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