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 ABD posta adresinizi göndererek renderVideo uç noktasına bir 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ği, 500 W 2nd St, Austin, TX, 78701 için bir havadan görünüm videosu oluşturulmasını ister.

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 verilebilecek yanıtları gösterir.

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, videonuzu oluşturmaya başladı. Yanıt, videoyu almak için kullanabileceğiniz videoId değerini 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 parametresini göndererek lookupVideo adresine istek gönderin. 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"
  }
}