Wygeneruj nowy film

renderVideo żąda wygenerowania filmu w widoku z lotu ptaka dla określonych Stanów Zjednoczonych adresu pocztowego. Jeśli film jest już dostępny pod podanym adresem, zwraca metadane filmu.

Jak korzystać z interfejsu API

Wygeneruj nowy film lotniczy, wysyłając żądanie HTTPS POST do renderVideo punktu końcowego, przekazując klucz interfejsu API i adres pocztowy w Stanach Zjednoczonych, jak pokazano na ilustracji w poniższym przykładzie. Renderowanie może potrwać nawet godzinę 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 w widoku z lotu ptaka dla: 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ładowe fragmenty kodu JSON pokazują możliwe odpowiedzi na przykładowy film użytkownika.

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 parametr videoId, za pomocą którego możesz pobrać film.

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

Renderowanie może potrwać od godziny do kilku godzin. Jeśli Film jest nadal przetwarzany, za pomocą funkcji lookupVideo możesz utworzyć ankietę dotyczącą jego stanu dopóki nie zwróci 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 funkcji wykładniczej w celu rozłożenia połączeń w czasie.

Aktywna odpowiedź

Gdy funkcja renderVideo zwraca wartość state o wartości ACTIVE, oznacza to, że film po zakończeniu renderowania. Możesz je pobrać, wywołując funkcję lookupVideo przy użyciu videoId.

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