Wygeneruj nowy film

Metoda renderVideo wysyła żądanie wygenerowania filmu z widokiem z lotu ptaka dla określonego adresu pocztowego w Stanach Zjednoczonych. Jeśli film już istnieje pod określonym adresem, ta metoda zwraca metadane filmu.

Jak korzystać z interfejsu API

Wygeneruj nowy film z widokiem z lotu ptaka, 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 tym przykładzie. Proces renderowania może trwać 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ład kodu wysyła żądanie wygenerowania filmu z widokiem 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ź

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

Nieprawidłowa odpowiedź dotycząca adresu

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 pole videoId, którego możesz użyć do pobrania filmu.

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

Proces renderowania może trwać od godziny do kilku godzin. Jeśli film jest nadal przetwarzany, możesz użyć lookupVideo, aby sprawdzić jego stan, dopóki nie zwróci stanu ACTIVE.

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

Aktywna reakcja

Gdy 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 funkcję lookupVideo z parametrem videoId.

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