Yeni video oluştur

renderVideo yöntemi, belirtilen ABD posta adresi için havadan görüntüleme videosu oluşturulmasını ister. 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, renderVideo uç noktasına bir HTTPS POST isteği yapıp API Anahtarınızı ve bir ABD posta adresini ileterek 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 kuş bakışı video oluşturulması istenir.

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 sınırları içinde değil.

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

Yanıt işleniyor

Aerial View API, videonuzu şu anda 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 video ACTIVE durumunu döndürene kadar video durumunu yoklamak için lookupVideo kullanabilirsiniz.

Anket yapmak için lookupVideo adresine istek göndererek videoId seviyesini geçin. Oluşturma işlemi birkaç saat sürebilir. Bu nedenle, çağrılarınızı aralıklı hale getirmek için üstel geri yükleme özelliğini kullanın.

Etkin yanıt

renderVideo işlevinin ACTIVE state değerini döndürmesi, videonun oluşturulmasının tamamlandığı anlamına gelir ve videoId ile lookupVideo yöntemini çağırarak videoyu alabilirsiniz.

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