Yeni video oluştur

İlgili içeriği oluşturmak için kullanılan renderVideo yöntem, belirtilen ABD için havadan görünüm videosunun oluşturulmasını talep eder posta adresi. Video belirtilen adres için zaten mevcutsa bu yöntemi, videoyla ilgili meta verileri döndürür.

API nasıl kullanılır?

renderVideo aşağıda gösterildiği gibi API Anahtarınızı ve bir ABD posta adresini ileterek uç noktanızı aşağıdaki örnekte görebilirsiniz. Oluşturma işlemi bir saati bulabilir birkaç saat.

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Örnek istek

Aşağıdaki kod örneği, şunun için bir havadan görüntüleme videosunun oluşturulmasını talep etmektedir: 500 W 2nd St, Austin, TX, 78701.

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Örnek yanıt

Aşağıdaki JSON kod örnekleri, örnek videoya verilebilecek olası yanıtları gösterir isteğinde bulunabilirsiniz.

Geçersiz adres yanıtı

Adres yanlış veya ABD'de değil.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

Yanıt işleniyor

Aerial View API şu anda videonuzu oluşturuyor. Yanıt şunu içeriyor: videoId değerini alır. Bunu videoyu almak için kullanabilirsiniz.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

Oluşturma işlemi, bir saat ile birkaç saat arasında sürebilir. Öğe video hâlâ işleniyor. Video durumunu denetlemek için lookupVideo düğmesini kullanabilirsiniz. ACTIVE durumunu döndürene kadar devam eder.

Anket yapmak için videoId öğesini ileterek lookupVideo adlı kişiden bir istekte bulunun. Oluşturma işlemi birkaç saat sürer, bu nedenle üstel Backoff'u kullanabilirsiniz.

Etkin yanıt

renderVideo işlevinin state değerini ACTIVE döndürmesi, videonun oluşturmayı bitirebilir ve lookupVideo öğesini çağırarak bunu alabilirsiniz: videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}