Wygeneruj nowy film

Metoda renderVideo prosi o wygenerowanie filmu z lotu ptaka dla podanego adresu pocztowego w Stanach Zjednoczonych. Jeśli film o podanym adresie już istnieje, ta metoda zwraca metadane dotyczące filmu.

Jak korzystać z interfejsu API

Wygeneruj nowy film z lotu, wysyłając żądanie HTTPS POST do punktu końcowego renderVideo, podając klucz interfejsu 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?key=YOUR_API_KEY"

Przykładowe żądanie

Ten przykładowy kod powoduje wygenerowanie filmu z lotu obejmującego budynek 500 W 2nd St, Austin, Teksas, 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

Aerial View API renderuje teraz Twój film. Odpowiedź zawiera tag videoId, który umożliwia pobranie 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ć lookupVideo, aby sprawdzić jego stan, aż zwróci wartość ACTIVE.

Aby przeprowadzić ankietę, wyślij żądanie do lookupVideo, przekazując w ten sposób videoId. Przetwarzanie może potrwać kilka godzin, dlatego użyj wykładniczego zmniejszania wartości, aby rozłożyć wywołania w czasie.

Aktywna odpowiedź

Gdy renderVideo zwraca wartość state ACTIVE, oznacza to, że renderowanie filmu zostało ukończone i możesz go pobrać, wywołując funkcję lookupVideo z parametrem videoId.

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