Wygeneruj nowy film

Metoda renderVideo wysyła żądanie wygenerowania filmu symulującego widok z lotu ptaka dla określonego adresu pocztowego w Stanach Zjednoczonych. Jeśli film dla określonego adresu już istnieje, ta metoda zwraca metadane dotyczące filmu.

Jak korzystać z interfejsu API

Aby wygenerować nowy film z widokiem z lotu ptaka, wyślij żądanie HTTPS POST do renderVideo punktu końcowego, przekazując klucz API i adres pocztowy w Stanach Zjednoczonych, jak pokazano w tym przykładzie. Proces renderowania 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?X-Goog-Api-Key=YOUR_API_KEY"

Przykładowe żądanie

Ten przykład kodu wysyła żądanie wygenerowania filmu symulującego widok 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?X-Goog-Api-Key=YOUR_API_KEY"

Przykładowa odpowiedź

Poniższe przykłady kodu JSON pokazują możliwe odpowiedzi na przykładowe żądanie filmu.

Odpowiedź z nieprawidłowym adresem

Adres jest nieprawidłowy lub nie znajduje się w Stanach Zjednoczonych.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

Odpowiedź na żądanie przetwarzania

Interfejs Aerial View API renderuje teraz Twój film. Odpowiedź zawiera videoId, którego możesz użyć do pobrania filmu.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

Proces renderowania może potrwać od godziny do kilku godzin. Jeśli film jest nadal przetwarzany, możesz użyć metody lookupVideo, aby sprawdzać jego stan, dopóki nie przyjmie wartości ACTIVE.

Aby sprawdzić stan, wyślij żądanie do metody lookupVideo, przekazując videoId. Renderowanie może potrwać kilka godzin, dlatego użyj wycofywania wykładniczego, aby rozłożyć wywołania w czasie.

Odpowiedź z aktywnym stanem

Gdy metoda renderVideo zwróci wartość state równą ACTIVE, oznacza to, że renderowanie filmu zostało zakończone i możesz go pobrać, wywołując metodę lookupVideo z parametrem videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}