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