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"
}
}