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