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