Wygeneruj nowy film

Metoda renderVideowymaga wygenerowania filmu z widokiem z lotu 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 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

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ż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, 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 parametr 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 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"
  }
}