Yeni video oluştur

renderVideo yöntemi, belirtilen ABD posta adresi için bir havadan görünüm videosu oluşturulmasını ister. Video, belirtilen adreste 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östermektedir.

Geçersiz adres yanıtı

Adres yanlış veya ABD içinde 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 lookupVideo değerini döndürene kadar video durumunu sorgulamak için ACTIVE değerini kullanabilirsiniz.

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ın aralığını ayarlamak için üssel geri çekilme kullanın.

Etkin yanıt

renderVideo, ACTIVE değerine sahip bir state döndürdüğünde videonun oluşturulması tamamlanmış demektir. Bu durumda, videoId ile lookupVideo'ı çağırarak videoyu alabilirsiniz.

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