Yeni video oluştur

renderVideo yöntemi, belirtilen ABD posta adresi için havadan görüntüleme videosunun oluşturulmasını talep eder. Video belirtilen adres için zaten mevcutsa bu yöntem, videoyla ilgili meta verileri döndürür.

API nasıl kullanılır?

Aşağıdaki örnekte gösterildiği gibi API Anahtarınızı ve bir ABD posta adresinizi ileterek renderVideo uç noktasına HTTPS POST isteği göndererek yeni bir havadan video oluşturun. Oluşturma işlemi, bir saat ile birkaç saat arasında sürebilir.

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ğinde, 500 W 2nd St, Austin, TX, 78701 için bir havadan görünüm videosunun oluşturulması istenmiştir.

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 video isteğine verilen olası yanıtları göstermektedir.

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, videoyu almak için kullanabileceğiniz videoId öğesini içerir.

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

Oluşturma işlemi, bir saat ile birkaç saat arasında sürebilir. Video hâlâ işleniyorsa ACTIVE durumu döndürene kadar lookupVideo kullanarak video durumunu sorgulayabilirsiniz.

Anket yapmak için videoId öğesini ileterek lookupVideo adlı kişiden bir istekte bulunun. Oluşturma işlemi birkaç saat sürebilir. Bu nedenle, çağrılarınız arasında aralık oluşturmak için üstel geri yükleme özelliğini kullanın.

Etkin yanıt

renderVideo, state değerini ACTIVE döndürdüğünde videonun oluşturulması tamamlanmış demektir. Bu durumda, videoId ile lookupVideo yöntemini çağırarak bu değeri alabilirsiniz.

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