Metoda renderVideo wymaga wygenerowania filmu z lotu ptaka na podany adres pocztowy w USA. Jeśli film istnieje już pod podanym adresem, ta metoda zwraca metadane dotyczące filmu.
Jak korzystać z interfejsu API
Wygeneruj nowy film lotniczy, wysyłając żądanie HTTPS POST do punktu końcowego renderVideo, przekazując klucz interfejsu API i adres pocztowy w Stanach Zjednoczonych, jak pokazano w poniższym przykładzie. Proces renderowania może potrwać od kilku godzin 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 w widoku z lotu ptaka dla adresu 500 W 2nd St, Austin, TX, 78701.
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ź
Możliwe odpowiedzi na przykładowe żądanie reklamy wideo znajdziesz w poniższych przykładach kodu JSON.
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ź
Interfejs Aerial View API renderuje teraz film. Odpowiedź zawiera parametr videoId, którego możesz użyć do pobrania filmu.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Proces renderowania może potrwać od kilku godzin do kilku godzin. Jeśli film jest nadal przetwarzany, możesz za pomocą funkcji lookupVideo odpytywać jego stan do momentu zwrócenia stanu ACTIVE.
Aby przeprowadzić ankietę, wyślij prośbę do lookupVideo, przekazując videoId. Renderowanie może potrwać kilka godzin, więc aby rozdzielić wywołania między wywołaniami, użyj wykładniczego ponowienia.
Aktywna odpowiedź
Gdy renderVideo zwraca wartość state o wartości ACTIVE, oznacza to, że film zakończył renderowanie. Możesz go pobrać, wywołując metodę lookupVideo z atrybutem videoId.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}