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 güncelliğini ve videonun uzunluğunu belirlemenize olanak tanır. Ayrıca videoların varlığını onaylamak için ücretsiz bir iş akışı sağlar.

API nasıl kullanılır?

Bu uç noktayı, URL kodlu bir ABD posta adresi veya videoId ileterek çağırın.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

API daha sonra aşağıdaki iki yanıttan birini döndürür:

  • Video varsa lookupVideoMetadata videonun meta verilerini döndürür.
  • Video yoksa API 404 hata kodunu döndürür.

Örnek istek

Aşağıdaki kod örneğinde, 600 Montgomery St, San Francisco, CA 94111 adresinde bulunan Transamerica Piramidi için havadan görünüm videosu isteniyor.

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 örneklerinde, lookupVideoMetadata isteğine verilen tüm olası yanıtlar gösterilmektedir.

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 bulunmuyordur. Bunun nedeni, konumun henüz oluşturulmamış olması veya desteklenmeyen bir bölgede bulunması olabilir.

Konum desteklenen bir bölgedeyse oluşturma isteği başlatmak için renderVideo simgesini kullanabilirsiniz.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}