Wygeneruj nowy film

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