Yeni video oluşturma

renderVideo yöntemi, belirtilen ABD posta adresi için kuşbakışı video oluşturulmasını ister. Video, belirtilen adres için zaten varsa bu yöntem, video hakkındaki meta verileri döndürür.

API nasıl kullanılır?

renderVideo uç noktasına bir HTTPS POST isteği göndererek yeni bir hava görüntüsü videosu oluşturun. Aşağıdaki örnekte gösterildiği gibi API anahtarınızı ve ABD posta adresinizi iletin. 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 kuşbakışı video oluşturulması isteniyor.

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 kodu örneklerinde, örnek video isteğine verilebilecek olası yanıtlar gösterilmektedir.

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ş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 işlenmeye devam ediyorsa lookupVideo durumunu döndürene kadar video durumunu yoklamak için ACTIVE kullanabilirsiniz.

Anket yapmak için lookupVideo adresine istek göndererek videoId değerini iletin. Oluşturma işlemi birkaç saat sürebilir. Bu nedenle, çağrılarınızın arasına zaman koymak için üstel geri çekilme kullanın.

Etkin yanıt

renderVideo, ACTIVE değerini döndürdüğünde videonun oluşturma işleminin tamamlandığı anlaşılır. Bu durumda, lookupVideo işlevini videoId ile çağırarak videoyu alabilirsiniz.state

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