Metoda renderVideo
prosi o wygenerowanie filmu z lotu ptaka dla podanego adresu pocztowego w Stanach Zjednoczonych. Jeśli film jest już dostępny pod podanym adresem, ta metoda zwróci metadane filmu.
Jak korzystać z interfejsu API
Wygeneruj nowy film lotniczy, wysyłając żądanie HTTPS POST do punktu końcowego renderVideo
i przekazując klucz interfejsu API oraz adres pocztowy w Stanach Zjednoczonych, jak pokazano w poniższym przykładzie. Renderowanie może potrwać
od godziny do kilku godzin.
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Przykładowe żądanie
Poniższy przykładowy kod wymaga wygenerowania filmu widokowego z lotu ptaka dla 500 W 2nd St, Austin, TX, 78701, USA.
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"
Przykładowa odpowiedź
Poniżej znajduje się przykładowy kod JSON zawierający możliwe odpowiedzi na przykładowe żądanie wideo.
Nieprawidłowa odpowiedź na adres
Adres jest nieprawidłowy lub nie znajduje się w Stanach Zjednoczonych.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Przetwarzam odpowiedź
Twój film jest teraz renderowany przez interfejs Aerial View API. Odpowiedź zawiera element videoId
, którego możesz użyć do pobrania filmu.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Renderowanie może potrwać od godziny do kilku godzin. Jeśli film jest nadal przetwarzany, za pomocą narzędzia lookupVideo
możesz przeprowadzać sondowanie jego stanu, dopóki nie zwróci on stanu ACTIVE
.
Aby przeprowadzić ankietę, wyślij żądanie do lookupVideo
, przekazując w ten sposób videoId
. Renderowanie może potrwać kilka godzin, więc użyj wykładniczego ponowienia, aby odstępować między wywołaniami.
Aktywna odpowiedź
Gdy funkcja renderVideo
zwraca wartość state
o wartości ACTIVE
, oznacza to, że renderowanie filmu zostało zakończone i możesz go pobrać, wywołując lookupVideo
przy użyciu metody videoId
.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}